MCP server

Agentic Commerce

io.bosonprotocol/agentic-commerce

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

MCP server for Boson Protocol — on-chain agentic commerce for physical & digital goods.

Website

At a glance

Type

MCP server

Publisher

bosonprotocol.io (verified by the MCP Registry)

Status

Working at last check

Tools

63

Token cost

About 43,622 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http agentic-commerce https://mcp.bosonprotocol.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.agentic-commerce]
url = "https://mcp.bosonprotocol.io/mcp"

Gemini CLI

{"mcpServers":{"agentic-commerce":{"httpUrl":"https://mcp.bosonprotocol.io/mcp"}}}

Cursor

{"mcpServers":{"agentic-commerce":{"url":"https://mcp.bosonprotocol.io/mcp"}}}

VS Code

{"servers":{"agentic-commerce":{"type":"http","url":"https://mcp.bosonprotocol.io/mcp"}}}

Antigravity

agy mcp add agentic-commerce https://mcp.bosonprotocol.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"agentic-commerce","server_url":"https://mcp.bosonprotocol.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"agentic-commerce","server_url":"https://mcp.bosonprotocol.io/mcp"}

Tools

• approve_exchange_token ~458 tokens
  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
• cancel_voucher ~356 tokens
  Cancels a committed voucher. Caller must be the buyer (voucher holder). Buyer forfeits buyerCancellationPenalty; remainder is refunded. Returns unsigned transaction data.
• commit_to_buyer_offer ~626 tokens
  Fulfils a buyer-initiated offer (creator='BUYER') by the seller. Caller must be the seller. Provide matching collateral. Returns unsigned transaction data.
• commit_to_conditional_offer ~494 tokens
  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.
• commit_to_conditional_offer_and_redeem_voucher ~434 tokens
  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.
• commit_to_offer ~446 tokens
  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_* to
• commit_to_offer_and_redeem_voucher ~441 tokens
  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 vou
• complete_exchange ~368 tokens
  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.
• create_buyer ~238 tokens
  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.
• create_dispute_resolution_proposal ~381 tokens
  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).
• create_offer ~1517 tokens
  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 yo
• create_offer_and_commit ~2252 tokens
  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.
• create_offer_commit_and_redeem ~2262 tokens
  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 tra
• create_offer_with_condition ~1880 tokens
  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.
• create_seller ~958 tokens
  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.
• decide_dispute ~352 tokens
  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.
• deposit_funds ~498 tokens
  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 tra
• escalate_dispute ~356 tokens
  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.
• expire_dispute ~289 tokens
  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.
• expire_dispute_batch ~299 tokens
  Marks multiple expired disputes in one transaction. All exchanges must be in 'Disputed' state past their respective timeouts. Permissionless. Returns unsigned transaction data.
• expire_escalated_dispute ~284 tokens
  Expires an escalated dispute once the resolver's response period passes without a decision. Permissionless — anyone can call. Returns unsigned transaction data.
• extend_dispute_timeout ~408 tokens
  Extends the deadline of an active dispute. Dispute must be in 'Resolving' state. Either party can call this. Returns unsigned transaction data.
• get_all_products_with_not_voided_variants ~640 tokens
  Reads product groupings with at least one non-voided variant from the Boson subgraph. Useful for storefront displays. Supports pagination and ordering. Read-only.
• get_config_ids ~85 tokens
  Returns all valid configId values for this server. Call first to discover which network/deployment to use. No auth required.
• get_dispute_by_id ~262 tokens
  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.
• get_dispute_resolvers ~357 tokens
  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.
• get_disputes ~541 tokens
  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.
• get_exchanges ~797 tokens
  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.
• get_funds ~331 tokens
  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 }.
• get_offers ~1506 tokens
  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.
• get_registered_agents ~172 tokens
  Returns all dACP agents registered with this MCP server instance, with their associated protocol entities and roles. No auth required.
• get_sellers ~464 tokens
  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.
• get_sellers_by_address ~482 tokens
  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.
• get_supported_tokens ~196 tokens
  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 }.
• raise_dispute ~355 tokens
  Raises a dispute on a redeemed exchange. Caller must be the buyer. Must be called within disputePeriodDurationInMS after redemption. Returns unsigned transaction data.
• redeem_voucher ~373 tokens
  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.
• refuse_escalated_dispute ~288 tokens
  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.
• register_agent ~314 tokens
  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.
• render_contractual_agreement ~1071 tokens
  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.
• resolve_dispute ~603 tokens
  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.
• retract_dispute ~353 tokens
  Retracts a raised dispute, releasing seller deposit and restoring completion flow. Caller must be the buyer who raised it. Returns unsigned transaction data.
• revoke_voucher Changes accounts · ~357 tokens
  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.
• search_products ~780 tokens
  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 resul
• send_forwarded_meta_transaction Sends messages · ~568 tokens
  Relays a Biconomy forwarded meta-transaction (ERC-20 gas payment). Requires a complete ERC20ForwardRequest and domain separator signature. Returns: relay transaction data.
• send_meta_transaction Sends messages · ~1562 tokens
  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 sign
• send_native_meta_transaction Sends messages · ~398 tokens
  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.
• send_signed_transaction Sends messages · ~267 tokens
  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.
• sign_full_offer ~2186 tokens
  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.
• sign_receive_with_dai_permit ~527 tokens
  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
• sign_receive_with_erc2612_permit ~593 tokens
  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 pa
• sign_receive_with_erc3009_authorization ~653 tokens
  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 transferAu
• sign_receive_with_permit2 ~604 tokens
  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 yo
• store_base_metadata ~418 tokens
  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.
• store_bundle_item_nft_metadata ~574 tokens
  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.
• store_bundle_item_product_v1_metadata ~1253 tokens
  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.
• store_bundle_metadata ~666 tokens
  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 }.
• store_product_v1_metadata ~1578 tokens
  Stores a ProductV1 metadata object to IPFS. Call before create_offer to get metadataUri and metadataHash. Returns: { metadataUri: 'ipfs://...', metadataHash: '0x...' }.
• update_seller ~852 tokens
  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.
• validate_metadata ~157 tokens
  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.
• void_non_listed_offer ~2013 tokens
  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.
• void_non_listed_offer_batch ~1990 tokens
  Voids multiple private offers atomically. Same prerequisite as void_non_listed_offer, but for an array of full offer objects. Returns unsigned transaction data.
• void_offer ~351 tokens
  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.
• withdraw_funds ~488 tokens
  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.

Browse

• Crypto and blockchains

Related MCP servers

• Booyah Index
  AI-readable directory + commerce layer: 3,500+ SEA businesses, plus products from verified stores.
• VIA Network: Agentic Commerce
  Agentic commerce network: discover sellers and products, negotiate, and pay USDC on Base via x402.
• Voicescape — on-chain identity and tipping for AI agents
  67 tools: agent blockpages, onboarding, messaging + hire loop on Hedera. Server never holds keys.
• ConformRadar
  Check online shops and pages against French e-commerce and consumer law, with legal references.
• Coal — Payments for AI agents
  Payment rails for AI agents. Pay merchants in USDC on Base. Dual-protocol: x402 + OKX APP.
• Geode
  Use the Geode blockchain's apps: marketplace, social, surveys, messaging, DNS and GEODE transfers.
• Tokyo Futuro
  Agentic GameFi on Robinhood Chain for AI agents: sign in, solve daily Trials, read the chain.
• Proof Of Custody
  Bitcoin custody scores, failure registry, ETF custody, stablecoin and x402 data, source router.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.bosonprotocol/agentic-commerce.svg)](https://aptlynx.net/servers/io.bosonprotocol/agentic-commerce)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents