{"id":"io.bosonprotocol/agentic-commerce","slug":"io-bosonprotocol-agentic-commerce","title":"Agentic Commerce","description":"MCP server for Boson Protocol — on-chain agentic commerce for physical & digital goods.","version":"1.0.0","publisher":{"kind":"domain","id":"bosonprotocol.io","label":"bosonprotocol.io","url":"https://bosonprotocol.io"},"website":"https://docs.bosonprotocol.io/mcp","repository":"","remotes":[{"type":"streamable-http","url":"https://mcp.bosonprotocol.io/mcp"}],"packages":[],"published":"2026-07-15","updated":"2026-07-15","status":"online","auth":"","latency_ms":1297,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"get_config_ids","title":"Get Config IDs","description":"Returns all valid configId values for this server. Call first to discover which network/deployment to use. No auth required.","read_only":true},{"name":"get_funds","title":"Get Funds","description":"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 }.","read_only":true},{"name":"get_disputes","title":"Get Disputes","description":"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.","read_only":true},{"name":"get_dispute_by_id","title":"Get Dispute by ID","description":"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.","read_only":true},{"name":"get_exchanges","title":"Get Exchanges","description":"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.","read_only":true},{"name":"get_offers","title":"Get Offers","description":"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.","read_only":true},{"name":"get_sellers","title":"Get Sellers","description":"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.","read_only":true},{"name":"get_dispute_resolvers","title":"Get Dispute Resolvers","description":"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.","read_only":true},{"name":"create_offer","title":"Create Offer","description":"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'.","read_only":false},{"name":"create_offer_with_condition","title":"Create Token-Gated Offer","description":"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.","read_only":false},{"name":"create_buyer","title":"Create Buyer Account","description":"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.","read_only":false},{"name":"sign_full_offer","title":"Sign Full Offer (Typed Data)","description":"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.","read_only":true},{"name":"create_offer_and_commit","title":"Create & Commit Private Offer","description":"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.","read_only":false},{"name":"create_offer_commit_and_redeem","title":"Create, Commit & Redeem Private Offer","description":"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.","read_only":false},{"name":"void_offer","title":"Void Offer","description":"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.","read_only":false},{"name":"void_non_listed_offer","title":"Void Private Offer","description":"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.","read_only":false},{"name":"void_non_listed_offer_batch","title":"Void Private Offers (Batch)","description":"Voids multiple private offers atomically. Same prerequisite as void_non_listed_offer, but for an array of full offer objects. Returns unsigned transaction data.","read_only":false},{"name":"create_seller","title":"Create Seller Account","description":"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.","read_only":false},{"name":"update_seller","title":"Update Seller Account","description":"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.","read_only":false},{"name":"send_signed_transaction","title":"Broadcast Signed Transaction","description":"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.","read_only":false},{"name":"send_meta_transaction","title":"Relay Meta-Transaction","description":"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","read_only":false},{"name":"send_native_meta_transaction","title":"Relay Native Meta-Transaction","description":"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.","read_only":false},{"name":"send_forwarded_meta_transaction","title":"Relay Forwarded Meta-Transaction","description":"Relays a Biconomy forwarded meta-transaction (ERC-20 gas payment). Requires a complete ERC20ForwardRequest and domain separator signature. Returns: relay transaction data.","read_only":false},{"name":"withdraw_funds","title":"Withdraw Funds","description":"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.","read_only":false},{"name":"deposit_funds","title":"Deposit Funds","description":"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.","read_only":false},{"name":"extend_dispute_timeout","title":"Extend Dispute Timeout","description":"Extends the deadline of an active dispute. Dispute must be in 'Resolving' state. Either party can call this. Returns unsigned transaction data.","read_only":false},{"name":"expire_dispute","title":"Expire Dispute","description":"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.","read_only":false},{"name":"expire_dispute_batch","title":"Expire Disputes (Batch)","description":"Marks multiple expired disputes in one transaction. All exchanges must be in 'Disputed' state past their respective timeouts. Permissionless. Returns unsigned transaction data.","read_only":false},{"name":"resolve_dispute","title":"Resolve Dispute","description":"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.","read_only":false},{"name":"raise_dispute","title":"Raise Dispute","description":"Raises a dispute on a redeemed exchange. Caller must be the buyer. Must be called within disputePeriodDurationInMS after redemption. Returns unsigned transaction data.","read_only":false},{"name":"retract_dispute","title":"Retract Dispute","description":"Retracts a raised dispute, releasing seller deposit and restoring completion flow. Caller must be the buyer who raised it. Returns unsigned transaction data.","read_only":false},{"name":"escalate_dispute","title":"Escalate Dispute","description":"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.","read_only":false},{"name":"decide_dispute","title":"Decide Dispute","description":"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.","read_only":false},{"name":"refuse_escalated_dispute","title":"Refuse Escalated Dispute","description":"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.","read_only":false},{"name":"expire_escalated_dispute","title":"Expire Escalated Dispute","description":"Expires an escalated dispute once the resolver's response period passes without a decision. Permissionless — anyone can call. Returns unsigned transaction data.","read_only":false},{"name":"create_dispute_resolution_proposal","title":"Create Dispute Resolution Proposal","description":"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).","read_only":true},{"name":"revoke_voucher","title":"Revoke Voucher","description":"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.","read_only":false},{"name":"approve_exchange_token","title":"Approve Exchange Token","description":"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.","read_only":false},{"name":"sign_receive_with_erc3009_authorization","title":"Sign Receive (ERC-3009)","description":"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","read_only":true},{"name":"sign_receive_with_erc2612_permit","title":"Sign Receive (ERC-2612 Permit)","description":"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","read_only":true},{"name":"sign_receive_with_permit2","title":"Sign Receive (Permit2)","description":"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: '","read_only":true},{"name":"sign_receive_with_dai_permit","title":"Sign Receive (DAI Permit)","description":"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","read_only":true},{"name":"commit_to_offer","title":"Commit to Offer","description":"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.","read_only":false},{"name":"commit_to_conditional_offer","title":"Commit to Token-Gated Offer","description":"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.","read_only":false},{"name":"commit_to_offer_and_redeem_voucher","title":"Commit & Redeem","description":"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","read_only":false},{"name":"commit_to_conditional_offer_and_redeem_voucher","title":"Commit & Redeem (Token-Gated)","description":"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.","read_only":false},{"name":"commit_to_buyer_offer","title":"Fulfil Buyer Offer","description":"Fulfils a buyer-initiated offer (creator='BUYER') by the seller. Caller must be the seller. Provide matching collateral. Returns unsigned transaction data.","read_only":false},{"name":"cancel_voucher","title":"Cancel Voucher","description":"Cancels a committed voucher. Caller must be the buyer (voucher holder). Buyer forfeits buyerCancellationPenalty; remainder is refunded. Returns unsigned transaction data.","read_only":false},{"name":"redeem_voucher","title":"Redeem Voucher","description":"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.","read_only":false},{"name":"complete_exchange","title":"Complete Exchange","description":"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.","read_only":false},{"name":"get_sellers_by_address","title":"Get Sellers by Address","description":"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.","read_only":true},{"name":"get_all_products_with_not_voided_variants","title":"Get Products (Active Variants)","description":"Reads product groupings with at least one non-voided variant from the Boson subgraph. Useful for storefront displays. Supports pagination and ordering. Read-only.","read_only":true},{"name":"search_products","title":"Search Products","description":"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.","read_only":true},{"name":"validate_metadata","title":"Validate Metadata","description":"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.","read_only":true},{"name":"store_product_v1_metadata","title":"Store Product Metadata","description":"Stores a ProductV1 metadata object to IPFS. Call before create_offer to get metadataUri and metadataHash. Returns: { metadataUri: 'ipfs://...', metadataHash: '0x...' }.","read_only":false},{"name":"store_bundle_metadata","title":"Store Bundle Metadata","description":"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 }.","read_only":false},{"name":"store_base_metadata","title":"Store Base Metadata","description":"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.","read_only":false},{"name":"render_contractual_agreement","title":"Render Contractual Agreement","description":"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.","read_only":true},{"name":"store_bundle_item_product_v1_metadata","title":"Store Bundle Item (Product)","description":"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.","read_only":false},{"name":"store_bundle_item_nft_metadata","title":"Store Bundle Item (NFT)","description":"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.","read_only":false},{"name":"register_agent","title":"Register dACP Agent","description":"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.","read_only":false},{"name":"get_registered_agents","title":"Get Registered Agents","description":"Returns all dACP agents registered with this MCP server instance, with their associated protocol entities and roles. No auth required.","read_only":true},{"name":"get_supported_tokens","title":"Get Supported Tokens","description":"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 }.","read_only":true}],"server_info":{"name":"boson-protocol-server","version":"1.2.11"},"category":"ecommerce","tags":["agents","crypto","image-video"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-07-15","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/io-bosonprotocol-agentic-commerce/"}