MCP tools

For the integration overview, see Tooling → MCP. For the canonical signing flow, see Build for AI agents → The 3-step signing pattern.

create_buyer — Creates a buyer account for signerAddress.
create_seller — Creates a seller account on Boson Protocol.
get_sellers — Reads seller account entities from the Boson subgraph.
get_sellers_by_address — Reads seller entities associated with a specific Ethereum address.
update_seller — Updates an existing seller account.

create_offer — Creates a product offer.
create_offer_with_condition — Creates an offer gated by token-ownership (e.g.
get_offers — Reads offer listings from the Boson subgraph.
render_contractual_agreement — Renders the legal contractual agreement text/HTML for an offer using its offer data and metadata.
sign_full_offer — Generates EIP-712 typed data for a non-listed (private) offer that the offer creator must sign.
store_base_metadata — Stores a Base metadata object to IPFS.
store_bundle_item_nft_metadata — Stores a single NFT bundle item's metadata to IPFS.
store_bundle_item_product_v1_metadata — Stores a single ProductV1 bundle item's metadata to IPFS.
store_bundle_metadata — Stores a Bundle metadata object to IPFS.
store_product_v1_metadata — Stores a ProductV1 metadata object to IPFS.
validate_metadata — Validates a metadata object against the Boson Protocol schema (PRODUCT_V1, BUNDLE, BASE, etc.) without storing it.
void_non_listed_offer — Voids a private (non-listed) offer before it is fulfilled.
void_non_listed_offer_batch — Voids multiple private offers atomically.
void_offer — Voids a listed offer so it can no longer be committed to.

approve_exchange_token — Grants ERC-20 allowance to the Boson Protocol contract.
cancel_voucher — Cancels a committed voucher.
commit_to_buyer_offer — Fulfils a buyer-initiated offer (creator='BUYER') by the seller.
commit_to_offer — Commits to an offer, creating an exchange and minting a voucher NFT.
complete_exchange — Completes an exchange after the dispute period expires, releasing funds to the seller.
create_offer_and_commit — Atomically creates a private offer and commits a specific buyer in one transaction.
get_exchanges — Reads exchange records (offer commitments) from the Boson subgraph.
redeem_voucher — Redeems a voucher, signalling physical receipt of goods and starting the dispute period clock.
revoke_voucher — Revokes a committed (not yet redeemed) voucher on behalf of the seller, returning funds to the buyer.

create_dispute_resolution_proposal — Generates EIP-712 typed data for a mutual dispute resolution proposal.
decide_dispute — Decides an escalated dispute.
escalate_dispute — Escalates a stale dispute to the third-party dispute resolver.
expire_dispute — Marks a dispute as expired after its resolution period passes.
expire_dispute_batch — Marks multiple expired disputes in one transaction.
expire_escalated_dispute — Expires an escalated dispute once the resolver's response period passes without a decision.
extend_dispute_timeout — Extends the deadline of an active dispute.
get_dispute_by_id — Reads a single dispute by its ID (equals the exchangeId).
get_dispute_resolvers — Reads registered dispute resolver entities.
get_disputes — Reads dispute records from the Boson subgraph.
raise_dispute — Raises a dispute on a redeemed exchange.
refuse_escalated_dispute — Dispute resolver refuses to decide an escalated dispute.
resolve_dispute — Resolves a dispute by mutual agreement.
retract_dispute — Retracts a raised dispute, releasing seller deposit and restoring completion flow.

deposit_funds — Deposits ERC-20 or native tokens into an entity's protocol treasury (e.g.
get_funds — Reads treasury fund balances for sellers and buyers from the Boson subgraph.
withdraw_funds — Withdraws funds from an entity's protocol treasury to the entity's treasury address.

send_forwarded_meta_transaction — Relays a Biconomy forwarded meta-transaction (ERC-20 gas payment).
send_meta_transaction — Relays a pre-signed meta-transaction via Biconomy so the user pays no gas.
send_native_meta_transaction — Relays a native meta-transaction (EIP-712 signed function call) via Biconomy.
send_signed_transaction — Broadcasts a signed raw Ethereum transaction to the network.

get_registered_agents — Returns all dACP agents registered with this MCP server instance, with their associated protocol entities and roles.
register_agent — Registers a dACP agent with this MCP server instance, associating its Ethereum identities and roles.

get_config_ids — Returns all valid configId values for this server.
get_supported_tokens — Returns ERC-20 tokens accepted as exchange tokens on the given configId deployment.

get_all_products_with_not_voided_variants — Reads product groupings with at least one non-voided variant from the Boson subgraph.

Per-tool page format

Each tool's page includes:

Description — the tool's purpose, from the server.
Category — heuristic grouping (seller/buyer, offer, exchange, dispute, funds, meta-tx, agent registry, config).
Returns unsigned tx? — heuristic flag.
Input schema — auto-generated table from the JSON Schema reported by the server.
Related — links to the SSoT signing page and the integration overview.