Kuaidi100 launched China's first MCP-protocol-compatible logistics information service platform. The core API services of Kuaidi100's Baidiy
Nothing to run from here
Agentic Commerce is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
63
tools declared
—
trust score
remote
at its publisher
—
calls last 7d
What it does
MCP server for Boson Protocol — on-chain agentic commerce for physical & digital goods.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user --transport http agentic-commerce-mcp https://mcp.bosonprotocol.io/mcp
# 2 — ask your agent for something these tools do
# get_config_ids, get_funds, get_disputes and 60 more
Agentic Commerce costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Publishernot claimed
BOAll 1 server
bosonprotocol1 server
1 category
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Installation
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine and nothing runs on ours: this server answers at its publisher’s own address, and what you install is the connection straight to it.
Claude Codedeclared by this listing
This is a public server: it answers at its publisher’s own address and this marketplace is not in the path. Claude Code registers it in one command; --scope user makes it available in every project. The transport below is http, as the publisher's own manifest declares it.
claude mcp add --scope user --transport http agentic-commerce-mcp https://mcp.bosonprotocol.io/mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
Free on mcprush, and it answers at its publisher’s own address: this marketplace is not in the path, so there is no key of ours to hold and no card to add.
What it writes
One config entry pointing straight at the publisher’s own address — this marketplace is not in the path, and nothing from this listing executes on your machine.
What you approve
63 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
Returns all valid configId values for this server. Call first to discover which network/deployment to use. No auth required.
No parameter schema on file.
Reads treasury fund balances for sellers and buyers from the Boson subgraph. Supports pagination/ordering/filtering. Read-only — signerAddress not required. Returns: array of { tokenAddress, availableAmount, accountId }.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| fundsSkip | number | no | — |
| fundsFirst | number | no | — |
| fundsOrderBy | string | no | — |
| fundsOrderDirection | string | no | — |
| fundsFilter | object | no | — |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
Reads dispute records from the Boson subgraph. Supports pagination, ordering, and filtering by buyer/seller/state. Read-only. Returns: array of dispute entities with exchangeId, state, timeout.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| disputesSkip | number | no | — |
| disputesFirst | number | no | — |
| disputesOrderBy | string | no | — |
| disputesOrderDirection | string | no | — |
| disputesFilter | object | no | — |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
Reads a single dispute by its ID (equals the exchangeId). Read-only. Returns: dispute entity with state, timeout, buyerPercent. Use get_disputes to search first.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| disputeId | string | yes | Numeric ID of the dispute to retrieve. Note: disputeId equals the exchangeId of the associated exchange. |
| queryVars | no | Optional additional subgraph query variables for field selection. Leave empty for default fields. | |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
Reads exchange records (offer commitments) from the Boson subgraph. Filter by buyer/seller/state. Read-only. Returns: array of exchanges with offerId, state (Committed/Redeemed/Completed/Disputed/Cancelled/Revoked), and voucher details.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| exchangesSkip | number | no | — |
| exchangesFirst | number | no | — |
| exchangesOrderBy | string | no | — |
| exchangesOrderDirection | string | no | — |
| exchangesFilter | object | no | — |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
Reads offer listings from the Boson subgraph. Supports pagination, ordering, and filtering (e.g. by sellerId). Read-only. Returns: array of offers with price, deposit, dates, and quantity.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| offersSkip | number | no | — |
| offersFirst | number | no | — |
| offersOrderBy | string | no | — |
| offersOrderDirection | string | no | — |
| offersFilter | object | no | — |
| includeExchanges | boolean | no | — |
| exchangesSkip | number | no | — |
| exchangesFirst | number | no | — |
| exchangesOrderBy | string | no | — |
| exchangesOrderDirection | string | no | — |
| exchangesFilter | object | no | — |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
Reads seller account entities from the Boson subgraph. Optionally includes related offers, exchanges, funds, and logs. Read-only. Returns: array of seller entities with addresses and metadataUri.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sellersSkip | number | no | — |
| sellersFirst | number | no | — |
| sellersOrderBy | string | no | — |
| sellersOrderDirection | string | no | — |
| sellersFilter | object | no | — |
| includeExchanges | boolean | no | — |
| includeOffers | boolean | no | — |
| includeFunds | boolean | no | — |
| includeLogs | boolean | no | — |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
Reads registered dispute resolver entities. Use this to find a valid disputeResolverId for create_offer. Read-only. Returns: array of resolvers with ID, fees, escalationResponsePeriod, and supported tokens.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| disputeResolversSkip | number | no | — |
| disputeResolversFirst | number | no | — |
| disputeResolversOrderBy | string | no | — |
| disputeResolversOrderDirection | string | no | — |
| disputeResolversFilter | object | no | — |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
Creates a product offer. Caller must have a seller account (create_seller first). Prerequisite: store metadata first with store_product_v1_metadata or store_base_metadata to get metadataUri/metadataHash. All dates in milliseconds; amounts as strings in wei. Returns unsigned tx — sign locally with your wallet → send_signed_transaction, or executionMode='metaTx'.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
| metadataUri | string | yes | IPFS URI pointing to the offer metadata JSON. Obtain by calling store_product_v1_metadata, store_bundle_metadata, or store_base_metadata. |
| metadataHash | string | yes | Keccak256 hash of the metadata JSON. Returned alongside metadataUri from the store_*_metadata tools. |
| exchangeTokenAddress | string | no | ERC-20 token accepted for payment. Omit or use address(0) for native ETH. Call get_supported_tokens for valid values. |
| price | string | yes | Offer price in the exchange token's smallest unit (wei). Pass as string to avoid precision loss, e.g. '1000000000000000000' = 1 ETH. |
| sellerDeposit | yes | Seller collateral in same unit as price. Released to seller on completion or forfeited on dispute. Pass as string. | |
| agentId | no | Optional dACP agent facilitating this offer. Omit or pass '0' if no agent. | |
| buyerCancellationPenalty | yes | Amount buyer forfeits on cancel, in same unit as price. Must be <= price. Pass as string. | |
| quantityAvailable | number | yes | How many times this offer can be committed to. Must be 1 when creator='BUYER'. |
| validFromDateInMS | number | yes | Unix timestamp in milliseconds when the offer becomes active. Example: Date.now() for immediate. |
| validUntilDateInMS | number | yes | Unix timestamp in milliseconds when the offer can no longer be committed to. |
| voucherRedeemableFromDateInMS | number | yes | Timestamp in ms from which buyer can redeem. Must be >= validFromDateInMS. |
| voucherRedeemableUntilDateInMS | number | yes | Timestamp in ms after which voucher cannot be redeemed. Set to 0 to use voucherValidDurationInMS instead. |
| disputePeriodDurationInMS | number | yes | Duration in ms for buyer to raise a dispute after redeeming. Example: 604800000 = 7 days. |
| voucherValidDurationInMS | number | yes | Voucher is redeemable for this many ms after commit. Set to 0 to use voucherRedeemableUntilDateInMS instead. |
| resolutionPeriodDurationInMS | number | yes | Duration in ms to respond to a resolution proposal before it expires. Example: 259200000 = 3 days. |
| disputeResolverId | string | no | ID of the dispute resolver for escalated disputes. Call get_dispute_resolvers to list available resolvers. |
| collectionIndex | no | Index of the seller's NFT collection for vouchers. Omit to use default (index 0). | |
| feeLimit | no | Max protocol fee the seller accepts in same token unit. Pass as string. | |
| priceType | number | no | 0 = static price, 1 = discovery price (auction). |
Creates an offer gated by token-ownership (e.g. hold an ERC-721 to commit). Same prerequisites as create_offer plus a condition object specifying the gate token, method, and threshold. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| condition | object | yes | — |
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
| metadataUri | string | yes | IPFS URI pointing to the offer metadata JSON. Obtain by calling store_product_v1_metadata, store_bundle_metadata, or store_base_metadata. |
| metadataHash | string | yes | Keccak256 hash of the metadata JSON. Returned alongside metadataUri from the store_*_metadata tools. |
| exchangeTokenAddress | no | ERC-20 token accepted for payment. Omit or use address(0) for native ETH. Call get_supported_tokens for valid values. | |
| price | yes | Offer price in the exchange token's smallest unit (wei). Pass as string to avoid precision loss, e.g. '1000000000000000000' = 1 ETH. | |
| sellerDeposit | yes | Seller collateral in same unit as price. Released to seller on completion or forfeited on dispute. Pass as string. | |
| agentId | no | Optional dACP agent facilitating this offer. Omit or pass '0' if no agent. | |
| buyerCancellationPenalty | yes | Amount buyer forfeits on cancel, in same unit as price. Must be <= price. Pass as string. | |
| quantityAvailable | number | yes | How many times this offer can be committed to. Must be 1 when creator='BUYER'. |
| validFromDateInMS | number | yes | Unix timestamp in milliseconds when the offer becomes active. Example: Date.now() for immediate. |
| validUntilDateInMS | number | yes | Unix timestamp in milliseconds when the offer can no longer be committed to. |
| voucherRedeemableFromDateInMS | number | yes | Timestamp in ms from which buyer can redeem. Must be >= validFromDateInMS. |
| voucherRedeemableUntilDateInMS | number | yes | Timestamp in ms after which voucher cannot be redeemed. Set to 0 to use voucherValidDurationInMS instead. |
| disputePeriodDurationInMS | number | yes | Duration in ms for buyer to raise a dispute after redeeming. Example: 604800000 = 7 days. |
| voucherValidDurationInMS | number | yes | Voucher is redeemable for this many ms after commit. Set to 0 to use voucherRedeemableUntilDateInMS instead. |
| resolutionPeriodDurationInMS | number | yes | Duration in ms to respond to a resolution proposal before it expires. Example: 259200000 = 3 days. |
| disputeResolverId | string | no | ID of the dispute resolver for escalated disputes. Call get_dispute_resolvers to list available resolvers. |
| collectionIndex | no | Index of the seller's NFT collection for vouchers. Omit to use default (index 0). | |
| feeLimit | no | Max protocol fee the seller accepts in same token unit. Pass as string. |
Creates a buyer account for signerAddress. Required before a buyer can commit to seller-initiated offers for the first time. No prerequisites. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
Generates EIP-712 typed data for a non-listed (private) offer that the offer creator must sign. Call before create_offer_and_commit or void_non_listed_offer. Returns: typed data structure — sign it locally with your wallet (EIP-712), then use the signature in the next step.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| offerCreator | string | yes | Ethereum address of the seller creating this non-listed offer. Must match the seller's assistant address. |
| committer | yes | Ethereum address of the buyer committing in the same transaction. | |
| collectionIndex | string | no | Index of the seller's NFT collection for vouchers. Omit to use default (index 0). |
| royaltyInfo | object | no | — |
| drMutualizerAddress | no | Optional dispute resolver mutualizer contract address that pools resolution funds. | |
| conditionalTokenId | no | Optional token ID of the NFT gate token used by this specific commit (for SpecificToken gating type). | |
| condition | object | no | — |
| useDepositedFunds | boolean | no | If true, use funds already deposited in the protocol treasury instead of transferring from the wallet. |
| sellerId | yes | Numeric ID of the seller entity. Obtain via get_sellers_by_address. | |
| buyerId | yes | Numeric ID of the buyer entity. Use '0' for seller-initiated offers. | |
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
| metadataUri | string | yes | IPFS URI pointing to the offer metadata JSON. Obtain by calling store_product_v1_metadata, store_bundle_metadata, or store_base_metadata. |
| metadataHash | string | yes | Keccak256 hash of the metadata JSON. Returned alongside metadataUri from the store_*_metadata tools. |
| exchangeTokenAddress | no | ERC-20 token accepted for payment. Omit or use address(0) for native ETH. Call get_supported_tokens for valid values. | |
| price | yes | Offer price in the exchange token's smallest unit (wei). Pass as string to avoid precision loss, e.g. '1000000000000000000' = 1 ETH. | |
| sellerDeposit | yes | Seller collateral in same unit as price. Released to seller on completion or forfeited on dispute. Pass as string. | |
| agentId | no | Optional dACP agent facilitating this offer. Omit or pass '0' if no agent. | |
| buyerCancellationPenalty | yes | Amount buyer forfeits on cancel, in same unit as price. Must be <= price. Pass as string. | |
| quantityAvailable | number | yes | How many times this offer can be committed to. Must be 1 when creator='BUYER'. |
| validFromDateInMS | number | yes | Unix timestamp in milliseconds when the offer becomes active. Example: Date.now() for immediate. |
Atomically creates a private offer and commits a specific buyer in one transaction. Prerequisite: call sign_full_offer, sign the returned typed data locally with your wallet (EIP-712), and provide the signature here. Used for private/bilateral trades. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
| signature | string | yes | ECDSA signature over the offer typed data. Workflow: sign_full_offer → sign the returned typed data locally with your wallet (EIP-712) → use result here. |
| offerCreator | string | yes | Ethereum address of the seller creating this non-listed offer. Must match the seller's assistant address. |
| committer | yes | Ethereum address of the buyer committing in the same transaction. | |
| collectionIndex | string | no | Index of the seller's NFT collection for vouchers. Omit to use default (index 0). |
| royaltyInfo | object | no | — |
| drMutualizerAddress | no | Optional dispute resolver mutualizer contract address that pools resolution funds. | |
| conditionalTokenId | no | Optional token ID of the NFT gate token used by this specific commit (for SpecificToken gating type). | |
| condition | object | no | — |
| useDepositedFunds | boolean | no | If true, use funds already deposited in the protocol treasury instead of transferring from the wallet. |
| sellerId | yes | Numeric ID of the seller entity. Obtain via get_sellers_by_address. | |
| buyerId | yes | Numeric ID of the buyer entity. Use '0' for seller-initiated offers. | |
| metadataUri | string | yes | IPFS URI pointing to the offer metadata JSON. Obtain by calling store_product_v1_metadata, store_bundle_metadata, or store_base_metadata. |
| metadataHash | string | yes | Keccak256 hash of the metadata JSON. Returned alongside metadataUri from the store_*_metadata tools. |
| exchangeTokenAddress | no | ERC-20 token accepted for payment. Omit or use address(0) for native ETH. Call get_supported_tokens for valid values. | |
| price | yes | Offer price in the exchange token's smallest unit (wei). Pass as string to avoid precision loss, e.g. '1000000000000000000' = 1 ETH. | |
| sellerDeposit | yes | Seller collateral in same unit as price. Released to seller on completion or forfeited on dispute. Pass as string. | |
| agentId | no | Optional dACP agent facilitating this offer. Omit or pass '0' if no agent. | |
| buyerCancellationPenalty | yes | Amount buyer forfeits on cancel, in same unit as price. Must be <= price. Pass as string. | |
| quantityAvailable | number | yes | How many times this offer can be committed to. Must be 1 when creator='BUYER'. |
Atomically creates a private offer, commits a specific buyer, and immediately redeems the voucher in a single transaction via the OrchestrationHandler. Same prerequisites as create_offer_and_commit (sign_full_offer + EIP-712 signature). Use for instant-fulfilment private trades. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
| signature | string | yes | ECDSA signature over the offer typed data. Workflow: sign_full_offer → sign the returned typed data locally with your wallet (EIP-712) → use result here. |
| offerCreator | string | yes | Ethereum address of the seller creating this non-listed offer. Must match the seller's assistant address. |
| committer | yes | Ethereum address of the buyer committing in the same transaction. | |
| collectionIndex | string | no | Index of the seller's NFT collection for vouchers. Omit to use default (index 0). |
| royaltyInfo | object | no | — |
| drMutualizerAddress | no | Optional dispute resolver mutualizer contract address that pools resolution funds. | |
| conditionalTokenId | no | Optional token ID of the NFT gate token used by this specific commit (for SpecificToken gating type). | |
| condition | object | no | — |
| useDepositedFunds | boolean | no | If true, use funds already deposited in the protocol treasury instead of transferring from the wallet. |
| sellerId | yes | Numeric ID of the seller entity. Obtain via get_sellers_by_address. | |
| buyerId | yes | Numeric ID of the buyer entity. Use '0' for seller-initiated offers. | |
| metadataUri | string | yes | IPFS URI pointing to the offer metadata JSON. Obtain by calling store_product_v1_metadata, store_bundle_metadata, or store_base_metadata. |
| metadataHash | string | yes | Keccak256 hash of the metadata JSON. Returned alongside metadataUri from the store_*_metadata tools. |
| exchangeTokenAddress | no | ERC-20 token accepted for payment. Omit or use address(0) for native ETH. Call get_supported_tokens for valid values. | |
| price | yes | Offer price in the exchange token's smallest unit (wei). Pass as string to avoid precision loss, e.g. '1000000000000000000' = 1 ETH. | |
| sellerDeposit | yes | Seller collateral in same unit as price. Released to seller on completion or forfeited on dispute. Pass as string. | |
| agentId | no | Optional dACP agent facilitating this offer. Omit or pass '0' if no agent. | |
| buyerCancellationPenalty | yes | Amount buyer forfeits on cancel, in same unit as price. Must be <= price. Pass as string. | |
| quantityAvailable | number | yes | How many times this offer can be committed to. Must be 1 when creator='BUYER'. |
Voids a listed offer so it can no longer be committed to. Caller must be the seller assistant. Existing exchanges are unaffected. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| offerId | string | yes | ID of the listed offer to void. Caller must be the seller assistant. Existing exchanges are unaffected. |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
Voids a private (non-listed) offer before it is fulfilled. Prerequisite: call sign_full_offer and sign the returned typed data locally with your wallet (EIP-712) to obtain the signature. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| condition | object | no | — |
| useDepositedFunds | boolean | no | If true, use funds already deposited in the protocol treasury instead of transferring from the wallet. |
| sellerId | yes | Numeric ID of the seller entity. Obtain via get_sellers_by_address. | |
| buyerId | yes | Numeric ID of the buyer entity. Use '0' for seller-initiated offers. | |
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
| metadataUri | string | yes | IPFS URI pointing to the offer metadata JSON. Obtain by calling store_product_v1_metadata, store_bundle_metadata, or store_base_metadata. |
| metadataHash | string | yes | Keccak256 hash of the metadata JSON. Returned alongside metadataUri from the store_*_metadata tools. |
| exchangeTokenAddress | no | ERC-20 token accepted for payment. Omit or use address(0) for native ETH. Call get_supported_tokens for valid values. | |
| price | yes | Offer price in the exchange token's smallest unit (wei). Pass as string to avoid precision loss, e.g. '1000000000000000000' = 1 ETH. | |
| sellerDeposit | yes | Seller collateral in same unit as price. Released to seller on completion or forfeited on dispute. Pass as string. | |
| agentId | no | Optional dACP agent facilitating this offer. Omit or pass '0' if no agent. | |
| buyerCancellationPenalty | yes | Amount buyer forfeits on cancel, in same unit as price. Must be <= price. Pass as string. | |
| quantityAvailable | number | yes | How many times this offer can be committed to. Must be 1 when creator='BUYER'. |
| validFromDateInMS | number | yes | Unix timestamp in milliseconds when the offer becomes active. Example: Date.now() for immediate. |
| validUntilDateInMS | number | yes | Unix timestamp in milliseconds when the offer can no longer be committed to. |
| voucherRedeemableFromDateInMS | number | yes | Timestamp in ms from which buyer can redeem. Must be >= validFromDateInMS. |
| voucherRedeemableUntilDateInMS | number | yes | Timestamp in ms after which voucher cannot be redeemed. Set to 0 to use voucherValidDurationInMS instead. |
| disputePeriodDurationInMS | number | yes | Duration in ms for buyer to raise a dispute after redeeming. Example: 604800000 = 7 days. |
| voucherValidDurationInMS | number | yes | Voucher is redeemable for this many ms after commit. Set to 0 to use voucherRedeemableUntilDateInMS instead. |
| resolutionPeriodDurationInMS | number | yes | Duration in ms to respond to a resolution proposal before it expires. Example: 259200000 = 3 days. |
Voids multiple private offers atomically. Same prerequisite as void_non_listed_offer, but for an array of full offer objects. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| fullOffers | array | yes | — |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
Creates a seller account on Boson Protocol. Required before creating any offers. signerAddress is automatically set as admin, assistant, and treasury. Provide seller metadata and royaltyPercentage. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
| type | string | yes | — |
| name | string | no | — |
| description | string | no | — |
| legalTradingName | string | no | — |
| kind | string | yes | — |
| website | string | no | — |
| images | array | no | — |
| contactLinks | array | no | — |
| contactPreference | string | yes | — |
| socialLinks | array | no | — |
| salesChannels | array | no | — |
| contractUri | string | no | Optional URI for OpenSea-style storefront metadata (defaults to empty string, meaning none). When set, it is fetched to copy it to The Graph's IPFS node, so it must be an ipfs:// URI, a CID, or an htt |
| royaltyPercentage | string | yes | Default resale royalty in basis points (0–10000). Applied to all offers unless overridden. |
| authTokenId | yes | NFT token ID used as auth token (e.g. Lens profile ID). Pass '0' if not using auth tokens. | |
| authTokenType | number | yes | Auth token type: 0=None, 1=Lens Protocol profile NFT. |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
Updates an existing seller account. Caller must be the current seller admin (signerAddress). Use get_sellers_by_address to retrieve the seller id first. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
| type | string | yes | — |
| name | string | no | — |
| description | string | no | — |
| legalTradingName | string | no | — |
| kind | string | yes | — |
| website | string | no | — |
| images | array | no | — |
| contactLinks | array | no | — |
| contactPreference | string | yes | — |
| socialLinks | array | no | — |
| salesChannels | array | no | — |
| authTokenId | string | yes | NFT token ID used as auth token (e.g. Lens profile ID). Pass '0' if not using auth tokens. |
| authTokenType | number | yes | Auth token type: 0=None, 1=Lens Protocol profile NFT. |
| id | yes | Numeric ID of the existing seller entity to update. Obtain from get_sellers_by_address. | |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
Broadcasts a signed raw Ethereum transaction to the network. signedTransaction must be 0x-prefixed RLP-encoded hex obtained from local wallet signing (e.g. ethers wallet.signTransaction(tx)). Returns: transaction hash, block number, and gas used.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| signedTransaction | string | yes | RLP-encoded signed Ethereum transaction as 0x-prefixed hex string. Obtain from local wallet signing (e.g. ethers wallet.signTransaction(tx)). |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
Relays a pre-signed meta-transaction via Biconomy so the user pays no gas. Requires sigR/sigS/sigV from a locally-signed EIP-712 payload. Use when the target operation requires metaTx relay. Optionally accepts transferAuthorizations (from the sign_receive_with_* tools, completed with your local signature) so the protocol can pull ERC-20 tokens without a prior approve_exchange_token tx. Returns: re
| Parameter | Type | Required | Notes |
|---|---|---|---|
| functionName | string | yes | — |
| functionSignature | string | yes | — |
| nonce | string/number | yes | — |
| sigR | string | yes | — |
| sigS | string | yes | — |
| sigV | string/number | yes | — |
| transferAuthorizations | array | no | Optional ERC-20 transfer authorizations that let the protocol pull tokens without a prior approve_exchange_token tx (e.g. commit_to_offer or deposit_funds in metaTx mode). Build each entry with the ma |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
Relays a native meta-transaction (EIP-712 signed function call) via Biconomy. Requires ABI-encoded function signature and sigR/sigS/sigV from a locally-signed EIP-712 payload. Returns: relay transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| contractAddress | string | yes | Valid Ethereum address (e.g. '0xAbCd...' or '0xabcd...'). Mixed-case addresses are checksum-validated; all-lowercase and all-uppercase addresses are also accepted. |
| functionSignature | string | yes | — |
| sigR | string | yes | — |
| sigS | string | yes | — |
| sigV | string/number | yes | — |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
Relays a Biconomy forwarded meta-transaction (ERC-20 gas payment). Requires a complete ERC20ForwardRequest and domain separator signature. Returns: relay transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| contractAddress | string | yes | Valid Ethereum address (e.g. '0xAbCd...' or '0xabcd...'). Mixed-case addresses are checksum-validated; all-lowercase and all-uppercase addresses are also accepted. |
| request | object | yes | — |
| domainSeparator | string | yes | — |
| signature | string | yes | — |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
Withdraws funds from an entity's protocol treasury to the entity's treasury address. Sellers withdraw proceeds; buyers withdraw refunds. Caller must control the entity via signerAddress. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| entityId | string | yes | Numeric ID of the seller or buyer entity withdrawing funds. |
| list | array | yes | — |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. | |
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
Deposits ERC-20 or native tokens into an entity's protocol treasury (e.g. seller deposit). For ERC-20, call approve_exchange_token first. In metaTx mode, you can skip the approval by passing transferAuthorizations (built with a sign_receive_with_* tool) to send_meta_transaction. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| entityId | string | yes | Numeric ID of the entity to credit. Must match signerAddress's seller account. |
| tokenAddress | string | yes | ERC-20 token to deposit. Use address(0) for native ETH. |
| amount | yes | Amount in wei. For ERC-20, approve_exchange_token must be called first, unless relaying in metaTx mode with transferAuthorizations passed to send_meta_transaction. Pass as string. | |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. | |
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
Extends the deadline of an active dispute. Dispute must be in 'Resolving' state. Either party can call this. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| exchangeId | string | yes | Numeric ID of the exchange/dispute to act on. Obtain from get_exchanges or the response of commit_to_offer. |
| newDisputeTimeout | yes | New absolute Unix timestamp in SECONDS (not ms) for the dispute deadline. Must be later than current timeout. | |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
Marks a dispute as expired after its resolution period passes. Permissionless — anyone can call. Exchange must be in 'Disputed' state past its timeout. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| exchangeId | string | yes | Numeric ID of the exchange/dispute to act on. Obtain from get_exchanges or the response of commit_to_offer. |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
Marks multiple expired disputes in one transaction. All exchanges must be in 'Disputed' state past their respective timeouts. Permissionless. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| exchangeIds | array | yes | Array of exchange IDs whose dispute period has passed. All must be in 'Disputed' state past their timeout. |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
Resolves a dispute by mutual agreement. Workflow: (1) create_dispute_resolution_proposal generates typed data, (2) both parties sign the typed data locally with their wallet (EIP-712), (3) either party submits sigR/sigS/sigV here. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| exchangeId | string | yes | Numeric ID of the exchange/dispute to act on. Obtain from get_exchanges or the response of commit_to_offer. |
| buyerPercentBasisPoints | yes | Agreed buyer share in basis points (0–10000). Both parties must sign the same value. Obtain via create_dispute_resolution_proposal then sign the typed data locally with each party's wallet (EIP-712). | |
| sigR | string | yes | 32-byte R component of the ECDSA resolution signature as 0x-prefixed hex. From the locally-signed EIP-712 signature parameters. |
| sigS | string | yes | 32-byte S component as 0x-prefixed hex. From the locally-signed EIP-712 signature parameters. |
| sigV | yes | Recovery byte V: 27 or 28. From the locally-signed EIP-712 signature parameters. | |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
Raises a dispute on a redeemed exchange. Caller must be the buyer. Must be called within disputePeriodDurationInMS after redemption. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| exchangeId | string | yes | Numeric ID of the exchange/dispute to act on. Obtain from get_exchanges or the response of commit_to_offer. |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
Retracts a raised dispute, releasing seller deposit and restoring completion flow. Caller must be the buyer who raised it. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| exchangeId | string | yes | Numeric ID of the exchange/dispute to act on. Obtain from get_exchanges or the response of commit_to_offer. |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
Escalates a stale dispute to the third-party dispute resolver. Caller must be the buyer. Resolver's escalation fee must be covered. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| exchangeId | string | yes | Numeric ID of the exchange/dispute to act on. Obtain from get_exchanges or the response of commit_to_offer. |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
Decides an escalated dispute. Caller must be the dispute resolver assigned to the offer's disputeResolverId. Specify buyerPercent in basis points (0=all to seller, 10000=all to buyer). Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| exchangeId | string | yes | Numeric ID of the exchange/dispute to act on. Obtain from get_exchanges or the response of commit_to_offer. |
| buyerPercent | yes | Percentage of disputed funds to buyer in basis points (0–10000). 10000 = all to buyer, 0 = all to seller. | |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
Dispute resolver refuses to decide an escalated dispute. Returns the escalation fee to the buyer and resets dispute to 'Resolving' state. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| exchangeId | string | yes | Numeric ID of the exchange/dispute to act on. Obtain from get_exchanges or the response of commit_to_offer. |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
Expires an escalated dispute once the resolver's response period passes without a decision. Permissionless — anyone can call. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| exchangeId | string | yes | Numeric ID of the exchange/dispute to act on. Obtain from get_exchanges or the response of commit_to_offer. |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
Generates EIP-712 typed data for a mutual dispute resolution proposal. Both buyer and seller must sign the same buyerPercentBasisPoints value locally with their wallet (EIP-712) before calling resolve_dispute. Returns: typed data structure (domain, types, message).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| exchangeId | string | yes | Numeric ID of the exchange/dispute to act on. Obtain from get_exchanges or the response of commit_to_offer. |
| buyerPercentBasisPoints | yes | Proposed percentage of disputed funds for the buyer, 0–10000 (basis points). The counterparty must sign this same value. | |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
Revokes a committed (not yet redeemed) voucher on behalf of the seller, returning funds to the buyer. Caller must be the seller assistant. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| exchangeId | string | yes | Numeric ID of the exchange/dispute to act on. Obtain from get_exchanges or the response of commit_to_offer. |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
Grants ERC-20 allowance to the Boson Protocol contract. Must be called before commit_to_offer or deposit_funds when using non-native exchange tokens, unless you relay in metaTx mode with transferAuthorizations (built with a sign_receive_with_* tool) passed to send_meta_transaction. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| exchangeTokenAddress | string | yes | ERC-20 token contract address to approve for the Boson Protocol diamond. |
| amount | string | yes | Allowance in wei. Use max uint256 string for unlimited: '115792089237316195423570985008687907853269984665640564039457584007913129639935'. |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. | |
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
Generates EIP-712 typed data for an ERC-3009 ReceiveWithAuthorization (e.g. USDC). Authorizes the spender (default: protocol diamond) to pull value from signerAddress between validAfter and validBefore. Sign locally with your wallet (EIP-712); add the resulting signature to the returned transferAuthorization { strategy: 'ERC3009', data } and pass it in send_meta_transaction.transferAuthorization
| Parameter | Type | Required | Notes |
|---|---|---|---|
| exchangeTokenAddress | string | yes | ERC-20 token contract address that supports the permit/authorization standard. |
| value | string | yes | Amount in wei the spender is authorized to pull from the signer. |
| spender | no | Optional spender address. Defaults to the Boson Protocol diamond from SDK config. | |
| tokenDomainName | string | yes | EIP-712 domain name of the token contract (e.g. 'USD Coin'). Required for ERC-3009 / EIP-2612 domain separator. |
| tokenDomainVersion | string | yes | EIP-712 domain version of the token contract (e.g. '2'). Required for ERC-3009 / EIP-2612 domain separator. |
| validAfter | yes | Unix timestamp in seconds before which the authorization is not valid. | |
| validBefore | yes | Unix timestamp in seconds after which the authorization is no longer valid. | |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
Generates EIP-712 typed data for an EIP-2612 Permit. Authorizes the spender (default: protocol diamond) to pull value from signerAddress until deadline. Sign locally with your wallet (EIP-712); add the resulting signature to the returned transferAuthorization { strategy: 'EIP2612', data } and pass it in send_meta_transaction.transferAuthorizations. Returns: typedData to sign + transferAuthoriz
| Parameter | Type | Required | Notes |
|---|---|---|---|
| exchangeTokenAddress | string | yes | ERC-20 token contract address that supports the permit/authorization standard. |
| value | string | yes | Amount in wei the spender is authorized to pull from the signer. |
| spender | no | Optional spender address. Defaults to the Boson Protocol diamond from SDK config. | |
| tokenDomainName | string | yes | EIP-712 domain name of the token contract (e.g. 'USD Coin'). Required for ERC-3009 / EIP-2612 domain separator. |
| tokenDomainVersion | string | yes | EIP-712 domain version of the token contract (e.g. '2'). Required for ERC-3009 / EIP-2612 domain separator. |
| deadline | yes | Unix timestamp in seconds after which the permit is no longer valid. | |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
Generates EIP-712 typed data for a Uniswap Permit2 PermitTransferFrom. Authorizes the spender (default: protocol diamond) to pull value from signerAddress until deadline. permit2Address defaults to contracts.permit2 from SDK config; permit2Nonce defaults to a random uint256. Sign locally with your wallet (EIP-712); add the resulting signature to the returned transferAuthorization { strategy: '
| Parameter | Type | Required | Notes |
|---|---|---|---|
| exchangeTokenAddress | string | yes | ERC-20 token contract address that supports the permit/authorization standard. |
| value | string | yes | Amount in wei the spender is authorized to pull from the signer. |
| spender | no | Optional spender address. Defaults to the Boson Protocol diamond from SDK config. | |
| deadline | yes | Unix timestamp in seconds after which the Permit2 authorization is no longer valid. | |
| permit2Address | no | Optional Uniswap Permit2 contract address. Defaults to contracts.permit2 from SDK config. | |
| permit2Nonce | no | Optional Permit2 nonce as a uint256 string. If omitted, a random uint256 is generated. | |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
Generates EIP-712 typed data for a DAI-style Permit. Authorizes the spender (default: protocol diamond) to pull DAI-style tokens from signerAddress until expiry. Sign locally with your wallet (EIP-712); add the resulting signature to the returned transferAuthorization { strategy: 'DAIPermit', data } and pass it in send_meta_transaction.transferAuthorizations. Returns: typedData to sign + transfe
| Parameter | Type | Required | Notes |
|---|---|---|---|
| exchangeTokenAddress | string | yes | ERC-20 token contract address that supports the permit/authorization standard. |
| value | string | yes | Amount in wei the spender is authorized to pull from the signer. |
| spender | no | Optional spender address. Defaults to the Boson Protocol diamond from SDK config. | |
| tokenDomainName | string | yes | EIP-712 domain name of the DAI-style token (e.g. 'Dai Stablecoin'). |
| expiry | yes | Unix timestamp in seconds after which the DAI-style permit is no longer valid. | |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
Commits to an offer, creating an exchange and minting a voucher NFT. Caller is the buyer (signerAddress) unless 'buyer' param is set. For ERC-20 offers, call approve_exchange_token first. In metaTx mode, you can skip the approval by passing transferAuthorizations (built with a sign_receive_with_* tool) to send_meta_transaction. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| offerId | string | yes | ID of the active offer to commit to. Creates an exchange and mints a voucher NFT. |
| buyer | string | no | Optional buyer address if different from signerAddress. When set, executionMode must be 'direct'. |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. | |
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
Commits to a token-gated (conditional) offer using a specific gating tokenId. Caller (signerAddress) must hold the gating token specified by the offer's condition. Use this instead of commit_to_offer for offers created via create_offer_with_condition. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| offerId | string | yes | ID of a conditional (token-gated) offer to commit to. Caller must hold the gating token specified by the offer's condition. |
| tokenId | yes | Token ID of the gate token used to qualify for the conditional commit (relevant for ERC-721/1155 and TokenRange gating). | |
| buyer | string | no | Optional buyer address if different from signerAddress. When set, executionMode must be 'direct'. |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. | |
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
Atomically commits to an offer and immediately redeems the voucher in a single transaction via the OrchestrationHandler. Buyer (signerAddress) must already hold any required ERC-20 allowance (approve_exchange_token), or, in metaTx mode, pass transferAuthorizations to send_meta_transaction. Skips voucher transferability and starts the dispute period clock immediately. Returns unsigned transaction d
| Parameter | Type | Required | Notes |
|---|---|---|---|
| offerId | string | yes | ID of the active offer to commit to and immediately redeem in a single transaction. Combines commit_to_offer + redeem_voucher via the OrchestrationHandler. |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
Atomically commits to a token-gated (conditional) offer using a specific gating tokenId and immediately redeems the voucher in a single transaction. Buyer must hold the gating token. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| offerId | string | yes | ID of a conditional (token-gated) offer to commit to and immediately redeem in a single transaction. |
| tokenId | yes | Token ID of the gate token used to qualify for the conditional commit (relevant for ERC-721/1155 and SpecificToken / TokenRange gating). | |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
Fulfils a buyer-initiated offer (creator='BUYER') by the seller. Caller must be the seller. Provide matching collateral. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| offerId | string | yes | ID of a buyer-initiated offer (creator='BUYER') to commit to. The seller fulfils the offer. |
| collectionIndex | no | — | |
| royaltyInfo | object | no | — |
| drMutualizerAddress | no | Valid Ethereum address (e.g. '0xAbCd...' or '0xabcd...'). Mixed-case addresses are checksum-validated; all-lowercase and all-uppercase addresses are also accepted. | |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. | |
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
Cancels a committed voucher. Caller must be the buyer (voucher holder). Buyer forfeits buyerCancellationPenalty; remainder is refunded. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| exchangeId | string | yes | Numeric ID of the exchange/dispute to act on. Obtain from get_exchanges or the response of commit_to_offer. |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
Redeems a voucher, signalling physical receipt of goods and starting the dispute period clock. Caller must be the buyer. After redemption, buyer has disputePeriodDurationInMS to raise a dispute. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| exchangeId | string | yes | Numeric ID of the exchange/dispute to act on. Obtain from get_exchanges or the response of commit_to_offer. |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
Completes an exchange after the dispute period expires, releasing funds to the seller. Can be called by seller after dispute period or by buyer at any time post-redemption. Returns unsigned transaction data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| exchangeId | string | yes | Numeric ID of the exchange/dispute to act on. Obtain from get_exchanges or the response of commit_to_offer. |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
| executionMode | string | no | 'direct' = standard on-chain tx (sign locally with your wallet → send_signed_transaction). 'metaTx' = gasless relay via Biconomy (send_meta_transaction). Defaults to 'direct'. |
Reads seller entities associated with a specific Ethereum address. Use this to check if signerAddress already has a seller account before calling create_seller. Read-only. Returns: array of seller entities.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| address | string | yes | — |
| sellersSkip | number | no | — |
| sellersFirst | number | no | — |
| sellersOrderBy | string | no | — |
| sellersOrderDirection | string | no | — |
| sellersFilter | object | no | — |
| includeExchanges | boolean | no | — |
| includeOffers | boolean | no | — |
| includeFunds | boolean | no | — |
| includeLogs | boolean | no | — |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
Reads product groupings with at least one non-voided variant from the Boson subgraph. Useful for storefront displays. Supports pagination and ordering. Read-only.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| productsSkip | number | no | — |
| productsFirst | number | no | — |
| productsOrderBy | string | no | — |
| productsOrderDirection | string | no | — |
| productsFilter | object | no | — |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
Searches products in the Boson subgraph by keywords matched against title, description, brand, category, and tags. Supports pagination, ordering, filtering, and an includeInvalidOffers flag (default false = only products with currently-valid offers). Read-only. Returns: array of product search result fragments.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| keywords | array | yes | List of keywords matched against product title, description, brand, category, and tags. |
| includeInvalidOffers | boolean | no | When true, include products whose offers are outside their validity window. Defaults to false (valid offers only). |
| productsSkip | number | no | — |
| productsFirst | number | no | — |
| productsOrderBy | string | no | — |
| productsOrderDirection | string | no | — |
| productsFilter | object | no | — |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
Validates a metadata object against the Boson Protocol schema (PRODUCT_V1, BUNDLE, BASE, etc.) without storing it. Use before store_*_metadata to catch errors early. Read-only. Returns: validation result with any errors.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| metadata | object | yes | — |
Stores a ProductV1 metadata object to IPFS. Call before create_offer to get metadataUri and metadataHash. Returns: { metadataUri: 'ipfs://...', metadataHash: '0x...' }.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| schemaUrl | string | yes | — |
| type | string | yes | — |
| uuid | string | yes | — |
| name | string | yes | — |
| description | string | yes | — |
| externalUrl | string | yes | — |
| licenseUrl | string | yes | — |
| youtubeUrl | string | no | — |
| condition | string | no | — |
| image | string | yes | — |
| imageData | string | no | — |
| animationUrl | string | no | — |
| attributes | array | yes | — |
| product | object | yes | — |
| variations | array | no | — |
| seller | object | yes | — |
| shipping | object | yes | — |
| exchangePolicy | object | yes | — |
| productOverrides | object | no | — |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
Stores a Bundle metadata object to IPFS. Prerequisite: call store_bundle_item_product_v1_metadata and/or store_bundle_item_nft_metadata first; include their returned URLs in the items array. Returns: { metadataUri, metadataHash }.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| schemaUrl | string | yes | — |
| type | string | yes | — |
| name | string | yes | — |
| description | string | yes | — |
| image | string | no | — |
| imageData | string | no | — |
| externalUrl | string | yes | — |
| licenseUrl | string | yes | — |
| youtubeUrl | string | no | — |
| condition | string | no | — |
| animationUrl | string | no | — |
| attributes | array | no | — |
| bundleUuid | string | yes | — |
| seller | object | yes | — |
| items | array | yes | — |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
Stores a Base metadata object to IPFS. Use for simple offers that don't require ProductV1 or Bundle structure. Returns: { metadataUri, metadataHash } for use in create_offer.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| schemaUrl | string | yes | — |
| type | string | yes | — |
| name | string | yes | — |
| description | string | yes | — |
| image | string | no | — |
| imageData | string | no | — |
| externalUrl | string | yes | — |
| licenseUrl | string | yes | — |
| condition | string | no | — |
| animationUrl | string | no | — |
| youtubeUrl | string | no | — |
| attributes | array | no | — |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
Renders the legal contractual agreement text/HTML for an offer using its offer data and metadata. Use to preview or store the agreement. Returns: rendered agreement string.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| template | string | yes | — |
| offerData | object | yes | — |
| offerMetadata | object | yes | — |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
Stores a single ProductV1 bundle item's metadata to IPFS. Call once per physical product in a bundle before store_bundle_metadata. Returns: { url: 'ipfs://...' } to include in the items array.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| schemaUrl | string | yes | — |
| type | string | yes | — |
| uuid | string | yes | — |
| product | object | yes | — |
| variations | array | no | — |
| shipping | object | yes | — |
| exchangePolicy | object | yes | — |
| productOverrides | object | no | — |
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
| signerAddress | string | yes | Ethereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally. |
Stores a single NFT bundle item's metadata to IPFS. Call once per NFT component in a bundle before store_bundle_metadata. Returns: { url: 'ipfs://...' } to include in the items array.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| schemaUrl | string | yes | — |
| type | string | yes | — |
| name | string | yes | — |
| description | string | no | — |
| image | string | no | — |
| imageData | string | no | — |
| externalUrl | string | no | — |
| animationUrl | string | no | — |
| youtubeUrl | string | no | — |
| image_data | string | no | — |
| external_url | string | no | — |
| animation_url | string | no | — |
| youtube_url | string | no | — |
| attributes | array | no | — |
| chainId | number | no | — |
| contract | string | no | — |
| tokenId | string | no | — |
| tokenIdRange | object | no | — |
| terms | array | no | — |
| quantity | number | no | — |
Registers a dACP agent with this MCP server instance, associating its Ethereum identities and roles. The signature proves control of each signerAddress. Server-local state — no configId/signerAddress context needed. Returns: registration confirmation.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | yes | — |
| description | string | yes | — |
| entities | array | yes | — |
Returns all dACP agents registered with this MCP server instance, with their associated protocol entities and roles. No auth required.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
Returns ERC-20 tokens accepted as exchange tokens on the given configId deployment. Use returned addresses in exchangeTokenAddress fields of create_offer. Read-only. Returns: array of { address, name, symbol, decimals }.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid value |
Free
$0 forever
- Every tool — any call limit is its publisher’s, not ours
- No card, and mcprush charges nothing for it
- Runs at its publisher’s own address — this marketplace is not in the path
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install Agentic Commerce or to call it, at any volume.
Call allowance · this installenforced at the gateway
Monthly allowance, in calls
—
—
Alert at 80% · then the tool returns a normal MCP error
Used this month: —
—Grade not published
No rule-by-rule report on file for this release
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
This listing is an address its publisher runs, and you connect to it directly — this marketplace is not in the path. The scanner reads packages and public source, and an address is neither. So there is no grade — not a withheld one, an unmeasured one.
Release history
This is an address its publisher runs: which release it serves is theirs to choose, so there is nothing here to pin. The history below is for reading; the current release on file is 1.0.0.
1.0.0
undated
latestNo release note was published with this version.
—
no reviews yet
Who can review
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Sign in to write one
Any signed-in account that does not publish Agentic Commerce can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
No reviews yet
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.