mcp server

agentic-commerce

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

Description as published by the maintainer. Source

• version 1.0.0
• active

active — Registry entry last updated 2026-07-15.

What this server can do

63 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

approve_exchange_token(amount, configId, executionMode, signerAddress, exchangeTokenAddress)

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. Returns unsigned transaction data. Required: exchangeTokenAddress, amount, configId, signerAddress.

cancel_voucher(configId, exchangeId, executionMode, signerAddress)

Cancels a committed voucher. Caller must be the buyer (voucher holder). Buyer forfeits buyerCancellationPenalty; remainder is refunded. Returns unsigned transaction data. Required: exchangeId, configId, signerAddress.

commit_to_buyer_offer(offerId, configId, royaltyInfo, executionMode, signerAddress, collectionIndex, drMutualizerAddress)

Fulfils a buyer-initiated offer (creator='BUYER') by the seller. Caller must be the seller. Provide matching collateral. Returns unsigned transaction data. Required: offerId, configId, signerAddress.

commit_to_conditional_offer(buyer, offerId, tokenId, configId, executionMode, signerAddress)

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. Required: offerId, tokenId, configId, signerAddress.

commit_to_conditional_offer_and_redeem_voucher(offerId, tokenId, configId, executionMode, signerAddress)

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. Required: offerId, tokenId, configId, signerAddress.

commit_to_offer(buyer, offerId, configId, executionMode, signerAddress)

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. Returns unsigned transaction data. Required: offerId, configId, signerAddress.

commit_to_offer_and_redeem_voucher(offerId, configId, executionMode, signerAddress)

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). Skips voucher transferability and starts the dispute period clock immediately. Returns unsigned transaction data. Required: offerId, configId, signerAddress.

complete_exchange(configId, exchangeId, executionMode, signerAddress)

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. Required: exchangeId, configId, signerAddress.

create_buyer(configId, signerAddress)

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. Required: configId, signerAddress.

create_dispute_resolution_proposal(configId, exchangeId, signerAddress, buyerPercentBasisPoints)

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). Required: exchangeId, buyerPercentBasisPoints, configId, signerAddress.

create_offer(price, agentId, creator, configId, feeLimit, priceType, metadataUri, royaltyInfo, metadataHash, executionMode, sellerDeposit, signerAddress, collectionIndex, disputeResolverId, quantityAvailable, validFromDateInMS, validUntilDateInMS, drMutualizerAddress, exchangeTokenAddress, buyerCancellationPenalty, voucherValidDurationInMS, disputePeriodDurationInMS, resolutionPeriodDurationInMS, voucherRedeemableFromDateInMS, voucherRedeemableUntilDateInMS)

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'. Required: metadataUri, metadataHash, price, sellerDeposit, buyerCancellationPenalty, quantityAvailable, validFromDateInMS, validUntilDateInMS, voucherRedeemableFromDateInMS, voucherRedeemableUntilDateInMS, disputePeriodDurationInMS, voucherValidDurationInMS, resolutionPeriodDurationInMS, configId, signerAddress.

create_offer_and_commit(price, agentId, buyerId, creator, configId, feeLimit, sellerId, committer, condition, priceType, signature, metadataUri, royaltyInfo, metadataHash, offerCreator, executionMode, sellerDeposit, signerAddress, collectionIndex, disputeResolverId, quantityAvailable, useDepositedFunds, validFromDateInMS, conditionalTokenId, validUntilDateInMS, drMutualizerAddress, exchangeTokenAddress, buyerCancellationPenalty, voucherValidDurationInMS, disputePeriodDurationInMS, resolutionPeriodDurationInMS, voucherRedeemableFromDateInMS, voucherRedeemableUntilDateInMS)

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. Required: signature, offerCreator, committer, sellerId, buyerId, metadataUri, metadataHash, price, sellerDeposit, buyerCancellationPenalty, quantityAvailable, validFromDateInMS, validUntilDateInMS, voucherRedeemableFromDateInMS, voucherRedeemableUntilDateInMS, disputePeriodDurationInMS, voucherValidDurationInMS, resolutionPeriodDurationInMS, configId, signerAddress.

create_offer_commit_and_redeem(price, agentId, buyerId, creator, configId, feeLimit, sellerId, committer, condition, priceType, signature, metadataUri, royaltyInfo, metadataHash, offerCreator, executionMode, sellerDeposit, signerAddress, collectionIndex, disputeResolverId, quantityAvailable, useDepositedFunds, validFromDateInMS, conditionalTokenId, validUntilDateInMS, drMutualizerAddress, exchangeTokenAddress, buyerCancellationPenalty, voucherValidDurationInMS, disputePeriodDurationInMS, resolutionPeriodDurationInMS, voucherRedeemableFromDateInMS, voucherRedeemableUntilDateInMS)

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. Required: signature, offerCreator, committer, sellerId, buyerId, metadataUri, metadataHash, price, sellerDeposit, buyerCancellationPenalty, quantityAvailable, validFromDateInMS, validUntilDateInMS, voucherRedeemableFromDateInMS, voucherRedeemableUntilDateInMS, disputePeriodDurationInMS, voucherValidDurationInMS, resolutionPeriodDurationInMS, configId, signerAddress.

create_offer_with_condition(price, agentId, creator, configId, feeLimit, condition, priceType, metadataUri, royaltyInfo, metadataHash, executionMode, sellerDeposit, signerAddress, collectionIndex, disputeResolverId, quantityAvailable, validFromDateInMS, validUntilDateInMS, drMutualizerAddress, exchangeTokenAddress, buyerCancellationPenalty, voucherValidDurationInMS, disputePeriodDurationInMS, resolutionPeriodDurationInMS, voucherRedeemableFromDateInMS, voucherRedeemableUntilDateInMS)

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. Required: condition, metadataUri, metadataHash, price, sellerDeposit, buyerCancellationPenalty, quantityAvailable, validFromDateInMS, validUntilDateInMS, voucherRedeemableFromDateInMS, voucherRedeemableUntilDateInMS, disputePeriodDurationInMS, voucherValidDurationInMS, resolutionPeriodDurationInMS, configId, signerAddress.

create_seller(kind, name, type, images, website, configId, authTokenId, contractUri, description, socialLinks, contactLinks, authTokenType, executionMode, salesChannels, signerAddress, legalTradingName, contactPreference, royaltyPercentage)

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. Required: type, kind, contactPreference, contractUri, royaltyPercentage, authTokenId, authTokenType, configId, signerAddress.

decide_dispute(configId, exchangeId, buyerPercent, signerAddress)

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. Required: exchangeId, buyerPercent, configId, signerAddress.

deposit_funds(amount, configId, entityId, tokenAddress, executionMode, signerAddress)

Deposits ERC-20 or native tokens into an entity's protocol treasury (e.g. seller deposit). For ERC-20, call approve_exchange_token first. Returns unsigned transaction data. Required: entityId, tokenAddress, amount, configId, signerAddress.

escalate_dispute(configId, exchangeId, executionMode, signerAddress)

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. Required: exchangeId, configId, signerAddress.

expire_dispute(configId, exchangeId, signerAddress)

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. Required: exchangeId, configId, signerAddress.

expire_dispute_batch(configId, exchangeIds, signerAddress)

Marks multiple expired disputes in one transaction. All exchanges must be in 'Disputed' state past their respective timeouts. Permissionless. Returns unsigned transaction data. Required: exchangeIds, configId, signerAddress.

expire_escalated_dispute(configId, exchangeId, signerAddress)

Expires an escalated dispute once the resolver's response period passes without a decision. Permissionless — anyone can call. Returns unsigned transaction data. Required: exchangeId, configId, signerAddress.

extend_dispute_timeout(configId, exchangeId, executionMode, signerAddress, newDisputeTimeout)

Extends the deadline of an active dispute. Dispute must be in 'Resolving' state. Either party can call this. Returns unsigned transaction data. Required: exchangeId, newDisputeTimeout, configId, signerAddress.

get_all_products_with_not_voided_variants(configId, productsSkip, productsFirst, productsFilter, productsOrderBy, productsOrderDirection)

Reads product groupings with at least one non-voided variant from the Boson subgraph. Useful for storefront displays. Supports pagination and ordering. Read-only. Required: configId.

get_config_ids

Returns all valid configId values for this server. Call first to discover which network/deployment to use. No auth required.

get_dispute_by_id(configId, disputeId, queryVars)

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. Required: disputeId, configId.

get_dispute_resolvers(configId, disputeResolversSkip, disputeResolversFirst, disputeResolversFilter, disputeResolversOrderBy, disputeResolversOrderDirection)

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. Required: configId.

get_disputes(configId, disputesSkip, disputesFirst, disputesFilter, disputesOrderBy, disputesOrderDirection)

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. Required: configId.

get_exchanges(configId, exchangesSkip, exchangesFirst, exchangesFilter, exchangesOrderBy, exchangesOrderDirection)

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. Required: configId.

get_funds(configId, fundsSkip, fundsFirst, fundsFilter, fundsOrderBy, fundsOrderDirection)

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 }. Required: configId.

get_offers(configId, offersSkip, offersFirst, offersFilter, exchangesSkip, offersOrderBy, exchangesFirst, exchangesFilter, exchangesOrderBy, includeExchanges, offersOrderDirection, exchangesOrderDirection)

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. Required: configId.

get_registered_agents(configId)

Returns all dACP agents registered with this MCP server instance, with their associated protocol entities and roles. No auth required. Required: configId.

get_sellers(configId, includeLogs, sellersSkip, includeFunds, sellersFirst, includeOffers, sellersFilter, sellersOrderBy, includeExchanges, sellersOrderDirection)

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. Required: configId.

get_sellers_by_address(address, configId, includeLogs, sellersSkip, includeFunds, sellersFirst, includeOffers, sellersFilter, sellersOrderBy, includeExchanges, sellersOrderDirection)

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. Required: address, configId.

get_supported_tokens(configId)

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 }. Required: configId.

raise_dispute(configId, exchangeId, executionMode, signerAddress)

Raises a dispute on a redeemed exchange. Caller must be the buyer. Must be called within disputePeriodDurationInMS after redemption. Returns unsigned transaction data. Required: exchangeId, configId, signerAddress.

redeem_voucher(configId, exchangeId, executionMode, signerAddress)

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. Required: exchangeId, configId, signerAddress.

refuse_escalated_dispute(configId, exchangeId, signerAddress)

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. Required: exchangeId, configId, signerAddress.

register_agent(name, entities, 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. Required: name, description, entities.

render_contractual_agreement(configId, template, offerData, offerMetadata, signerAddress)

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. Required: template, offerData, offerMetadata, configId, signerAddress.

resolve_dispute(sigR, sigS, sigV, configId, exchangeId, executionMode, signerAddress, buyerPercentBasisPoints)

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. Required: exchangeId, buyerPercentBasisPoints, sigR, sigS, sigV, configId, signerAddress.

retract_dispute(configId, exchangeId, executionMode, signerAddress)

Retracts a raised dispute, releasing seller deposit and restoring completion flow. Caller must be the buyer who raised it. Returns unsigned transaction data. Required: exchangeId, configId, signerAddress.

revoke_voucher(configId, exchangeId, executionMode, signerAddress)

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. Required: exchangeId, configId, signerAddress.

search_products(configId, keywords, productsSkip, productsFirst, productsFilter, productsOrderBy, includeInvalidOffers, productsOrderDirection)

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. Required: keywords, configId.

send_forwarded_meta_transaction(request, configId, signature, signerAddress, contractAddress, domainSeparator)

Relays a Biconomy forwarded meta-transaction (ERC-20 gas payment). Requires a complete ERC20ForwardRequest and domain separator signature. Returns: relay transaction data. Required: contractAddress, request, domainSeparator, signature, configId, signerAddress.

send_meta_transaction(sigR, sigS, sigV, nonce, configId, functionName, signerAddress, functionSignature)

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. Returns: relay transaction data. Required: functionName, functionSignature, nonce, sigR, sigS, sigV, configId, signerAddress.

send_native_meta_transaction(sigR, sigS, sigV, configId, signerAddress, contractAddress, functionSignature)

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. Required: contractAddress, functionSignature, sigR, sigS, sigV, configId, signerAddress.

send_signed_transaction(configId, signedTransaction)

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. Required: signedTransaction, configId.

sign_full_offer(price, agentId, buyerId, creator, configId, feeLimit, sellerId, committer, condition, priceType, metadataUri, royaltyInfo, metadataHash, offerCreator, executionMode, sellerDeposit, signerAddress, collectionIndex, disputeResolverId, quantityAvailable, useDepositedFunds, validFromDateInMS, conditionalTokenId, validUntilDateInMS, drMutualizerAddress, exchangeTokenAddress, buyerCancellationPenalty, voucherValidDurationInMS, disputePeriodDurationInMS, resolutionPeriodDurationInMS, voucherRedeemableFromDateInMS, voucherRedeemableUntilDateInMS)

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. Required: offerCreator, committer, sellerId, buyerId, metadataUri, metadataHash, price, sellerDeposit, buyerCancellationPenalty, quantityAvailable, validFromDateInMS, validUntilDateInMS, voucherRedeemableFromDateInMS, voucherRedeemableUntilDateInMS, disputePeriodDurationInMS, voucherValidDurationInMS, resolutionPeriodDurationInMS, configId, signerAddress.

sign_receive_with_dai_permit(value, expiry, spender, configId, signerAddress, tokenDomainName, exchangeTokenAddress)

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); use the result to build a TransferAuthorization { strategy: 'DAIPermit' } for a meta-tx flow. Returns: typed data structure. Required: exchangeTokenAddress, value, tokenDomainName, expiry, configId, signerAddress.

sign_receive_with_erc2612_permit(value, spender, configId, deadline, signerAddress, tokenDomainName, tokenDomainVersion, exchangeTokenAddress)

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); use the resulting signature to build a TransferAuthorization { strategy: 'EIP2612' } for a meta-tx flow. Returns: typed data structure. Required: exchangeTokenAddress, value, tokenDomainName, tokenDomainVersion, deadline, configId, signerAddress.

sign_receive_with_erc3009_authorization(value, spender, configId, validAfter, validBefore, signerAddress, tokenDomainName, tokenDomainVersion, exchangeTokenAddress)

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); use the resulting signature + nonce to build a TransferAuthorization { strategy: 'ERC3009' } for a meta-tx flow. Returns: typed data structure. Required: exchangeTokenAddress, value, tokenDomainName, tokenDomainVersion, validAfter, validBefore, configId, signerAddress.

sign_receive_with_permit2(value, spender, configId, deadline, permit2Nonce, signerAddress, permit2Address, exchangeTokenAddress)

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); use the result to build a TransferAuthorization { strategy: 'Permit2' } for a meta-tx flow. Returns: typed data structure. Required: exchangeTokenAddress, value, deadline, configId, signerAddress.

store_base_metadata(name, type, image, configId, condition, imageData, schemaUrl, attributes, licenseUrl, youtubeUrl, description, externalUrl, animationUrl, signerAddress)

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. Required: schemaUrl, type, name, description, externalUrl, licenseUrl, configId, signerAddress.

store_bundle_item_nft_metadata(name, type, image, terms, chainId, tokenId, configId, contract, quantity, imageData, schemaUrl, attributes, image_data, youtubeUrl, description, externalUrl, youtube_url, animationUrl, external_url, tokenIdRange, animation_url, signerAddress)

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. Required: schemaUrl, type, name, configId, signerAddress.

store_bundle_item_product_v1_metadata(type, uuid, product, configId, shipping, schemaUrl, variations, signerAddress, exchangePolicy, productOverrides)

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. Required: schemaUrl, type, uuid, product, shipping, exchangePolicy, configId, signerAddress.

store_bundle_metadata(name, type, image, items, seller, configId, condition, imageData, schemaUrl, attributes, bundleUuid, licenseUrl, youtubeUrl, description, externalUrl, animationUrl, signerAddress)

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 }. Required: schemaUrl, type, name, description, externalUrl, licenseUrl, bundleUuid, seller, items, configId, signerAddress.

store_product_v1_metadata(name, type, uuid, image, seller, product, configId, shipping, condition, imageData, schemaUrl, attributes, licenseUrl, variations, youtubeUrl, description, externalUrl, animationUrl, signerAddress, exchangePolicy, productOverrides)

Stores a ProductV1 metadata object to IPFS. Call before create_offer to get metadataUri and metadataHash. Returns: { metadataUri: 'ipfs://...', metadataHash: '0x...' }. Required: schemaUrl, type, uuid, name, description, externalUrl, licenseUrl, image, attributes, product, seller, shipping, exchangePolicy, configId, signerAddress.

update_seller(id, kind, name, type, images, website, configId, authTokenId, description, socialLinks, contactLinks, authTokenType, executionMode, salesChannels, signerAddress, legalTradingName, contactPreference)

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. Required: type, kind, contactPreference, authTokenId, authTokenType, id, configId, signerAddress.

validate_metadata(metadata)

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. Required: metadata.

void_non_listed_offer(price, agentId, buyerId, creator, configId, feeLimit, sellerId, condition, priceType, metadataUri, royaltyInfo, metadataHash, executionMode, sellerDeposit, signerAddress, collectionIndex, disputeResolverId, quantityAvailable, useDepositedFunds, validFromDateInMS, validUntilDateInMS, drMutualizerAddress, exchangeTokenAddress, buyerCancellationPenalty, voucherValidDurationInMS, disputePeriodDurationInMS, resolutionPeriodDurationInMS, voucherRedeemableFromDateInMS, voucherRedeemableUntilDateInMS)

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. Required: sellerId, buyerId, metadataUri, metadataHash, price, sellerDeposit, buyerCancellationPenalty, quantityAvailable, validFromDateInMS, validUntilDateInMS, voucherRedeemableFromDateInMS, voucherRedeemableUntilDateInMS, disputePeriodDurationInMS, voucherValidDurationInMS, resolutionPeriodDurationInMS, configId, signerAddress.

void_non_listed_offer_batch(configId, fullOffers, signerAddress)

Voids multiple private offers atomically. Same prerequisite as void_non_listed_offer, but for an array of full offer objects. Returns unsigned transaction data. Required: fullOffers, configId, signerAddress.

void_offer(offerId, configId, executionMode, signerAddress)

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. Required: offerId, configId, signerAddress.

withdraw_funds(list, configId, entityId, executionMode, signerAddress)

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. Required: entityId, list, configId, signerAddress.

Last successful function declaration observed on 2026-08-13. Source: https://mcp.bosonprotocol.io/mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://mcp.bosonprotocol.io/mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Website — https://docs.bosonprotocol.io/mcp
• Remote endpoint (streamable-http) — https://mcp.bosonprotocol.io/mcp