Agentic commerce network: discover sellers and products, negotiate, and pay USDC on Base via x402.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Ask a buyer's Buying Agent to accept a negotiated offer, forwarded to their buyer MCP. The agent auto-accepts only within the buyer's delegation caps, otherwise it queues the offer for the buyer's approval.
Your reference id for the offer being accepted.
The buyer's mcp_url from a find_buyers result.
The brief you made the paid offer against (required by the buyer agent).
Product category, checked against the buyer's lists.
Total order amount in USD, for the caps check.
The offer_token the door returned when you paid for this offer. Required unless you send payer_signature.
Instead of offer_token: an EIP-191 signature by the paying wallet, as for negotiate.
The payment tx of your paid door offer (required by the buyer agent).
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Ask a buyer's Buying Agent to accept a negotiated offer, forwarded to their buyer MCP. The agent auto-accepts only within the buyer's delegation caps, otherwise it queues the offer for the buyer's approval.
| Argument | Type | Description |
|---|---|---|
| brief_id | string | The brief you made the paid offer against (required by the buyer agent). |
| category | string | Product category, checked against the buyer's lists. |
| offer_id* | string | Your reference id for the offer being accepted. |
| amount_usd | number | Total order amount in USD, for the caps check. |
| offer_token | string | The offer_token the door returned when you paid for this offer. Required unless you send payer_signature. |
| buyer_mcp_url* | string | The buyer's mcp_url from a find_buyers result. |
| payer_signature | string | Instead of offer_token: an EIP-191 signature by the paying wallet, as for negotiate. |
| payment_tx_hash | string | The payment tx of your paid door offer (required by the buyer agent). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"buyer_mcp_url",
"offer_id"
],
"properties": {
"brief_id": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "The brief you made the paid offer against (required by the buyer agent)."
},
"category": {
"type": "string",
"maxLength": 60,
"minLength": 1,
"description": "Product category, checked against the buyer's lists."
},
"offer_id": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Your reference id for the offer being accepted."
},
"amount_usd": {
"type": "number",
"minimum": 0,
"description": "Total order amount in USD, for the caps check."
},
"offer_token": {
"type": "string",
"maxLength": 200,
"description": "The offer_token the door returned when you paid for this offer. Required unless you send payer_signature."
},
"buyer_mcp_url": {
"type": "string",
"minLength": 1,
"description": "The buyer's mcp_url from a find_buyers result."
},
"payer_signature": {
"type": "string",
"maxLength": 200,
"description": "Instead of offer_token: an EIP-191 signature by the paying wallet, as for negotiate."
},
"payment_tx_hash": {
"type": "string",
"maxLength": 120,
"minLength": 6,
"description": "The payment tx of your paid door offer (required by the buyer agent)."
}
},
"additionalProperties": false
}Ask a seller's Sales Agent a question, from anywhere on the network, without leaving this connector. It answers in the seller's voice using their locked-in memories (events, promotions, policies, stock). Pass the seller_mcp_url from a discovery result and an optional contact so the seller can reach back.
| Argument | Type | Description |
|---|---|---|
| contact | string | Optional reach-back identifier (email, handle, or the buyer agent MCP url). |
| question* | string | Free-form buyer question. |
| seller_mcp_url* | string | mcp_ref.seller_mcp_url from a find_seller / get_seller_products result. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"seller_mcp_url",
"question"
],
"properties": {
"contact": {
"type": "string",
"maxLength": 300,
"description": "Optional reach-back identifier (email, handle, or the buyer agent MCP url)."
},
"question": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "Free-form buyer question."
},
"seller_mcp_url": {
"type": "string",
"minLength": 1,
"description": "mcp_ref.seller_mcp_url from a find_seller / get_seller_products result."
}
},
"additionalProperties": false
}Buy a listing from anywhere on the network, settled in USDC on Base, without leaving this connector. Pass the seller_mcp_url and product_id from the listing (mcp_ref). For physical products include the full delivery block; for event passes include the attendee block; the call rejects with the missing fields listed if any are blank. Free passes are not bought here: use claim_pass. Returns the total, an order_ref and a pay_url. SIMPLEST, for VIA and network-member listings alike: if you hold a standard x402 wallet (MoonPay PayBox: call use_service with url = pay_url; or any exact-scheme x402 client), request pay_url and pay its 402; the order settles and is fulfilled in that one call, gas sponsored. Otherwise: VIA-native orders settle at the /api/x402/purchase endpoint returned (EIP-2612 permit as { order_ref, x_payment }, or a raw USDC transfer as { order_ref, payment_tx_hash }); member orders take a raw USDC transfer then confirm_purchase. Call get_shipping_quote first and pass buyer_country to include shipping. CARD: when the reply carries card_checkout_url the store takes card payments; if you act for a human with no USDC wallet, give them that link to pay by card themselves. Never ask for or handle card details. Physical network-member listings: pass delivery; the first call returns shipping options, call again with shipping_rate_handle set to the one you chose.
| Argument | Type | Description |
|---|---|---|
| qty | integer | |
| attendee | object | Required for event passes. |
| delivery | object | Required for physical products. Omit for digital / service. |
| product_id* | string | The listing id from discovery (mcp_ref.product_id). |
| buyer_email |
Claim the free VIA x Singapore Blockchain Week Network Pass for the calling Mind's owner. From a name and email it emails the owner a confirmation link; when they open it, their full VIA activation is created: a VIA Personal Shopper with its own wallet and on-chain (ERC-8004) identity, a Singapore Blockchain Week membership card for their Apple or Google Wallet, and their own referral invite link (sent in the welcome email). Nothing is created until the owner confirms the email. No payment and no wallet signature, so a Mind can complete this even though it cannot sign a purchase. Pass your own Mind id as mind_id: each Mind may claim exactly ONE Network Pass per event, and a repeat returns the one it already made. Returns pending_verification and the public leaderboard; once the owner has confirmed, a repeat call returns the Pass install link and their personal invite link.
| Argument | Type | Description |
|---|---|---|
| name* | string | The person's name, printed on their Pass and shown on the leaderboard. |
| email* | string | The person's email. Their agent, wallet, identity and Pass are created (or reused) for this address, and the welcome email is sent here on a first claim. |
| mind_id* | string | The calling Mind's own unique id on the Minds platform. The one-pass-per-Mind cap is keyed on this; pass your real id. |
| event_slug | string | Event to claim for. Defaults to singapore-blockchain-week. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"mind_id",
"name",
"email"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The person's name, printed on their Pass and shown on the leaderboard."
},
"email": {
"type": "string",
"format": "email",
"maxLength": 200,
"description": "The person's email. Their agent, wallet, identity and Pass are created (or reused) for this address, and the welcome email is sent here on a first claim."
},
"mind_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The calling Mind's own unique id on the Minds platform. The one-pass-per-Mind cap is keyed on this; pass your real id."
},
"event_slug": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Event to claim for. Defaults to singapore-blockchain-week."
}
},
"additionalProperties": false
}Claim a FREE entry pass to an event on the VIA network, directly from discovery. FREE guest-list tiers only (price 0, the kind find_seller / get_seller_products surface at $0). No payment, no wallet, no x402: provide the attendee name and email, and VIA records the place, emails a confirmation, and notifies the organiser. One pass per email / per account. Paid products are NOT claimable here: connect to the seller's per-seller MCP and use buy_product (USDC via x402). Pass the product_id from a find_seller result (mcp_ref.product_id) or get_seller_products.
| Argument | Type | Description |
|---|---|---|
| name* | string | Name of the person attending, for the guest list. |
| email* | string | Email to confirm the place to and for the organiser to admit by. |
| product_id* | string | UUID of the free pass tier, from a find_seller / get_seller_products result. |
| buyer_wallet | string | Optional Base wallet, if the claimer has a VIA buyer identity. |
| buyer_agent_id | string | Optional ERC-8004 agent id of the agent claiming on the buyer's behalf. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"product_id",
"name",
"email"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Name of the person attending, for the guest list."
},
"email": {
"type": "string",
"format": "email",
"maxLength": 200,
"description": "Email to confirm the place to and for the organiser to admit by."
},
"product_id": {
"type": "string",
"format": "uuid",
"description": "UUID of the free pass tier, from a find_seller / get_seller_products result."
},
"buyer_wallet": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Optional Base wallet, if the claimer has a VIA buyer identity."
},
"buyer_agent_id": {
"type": "string",
"description": "Optional ERC-8004 agent id of the agent claiming on the buyer's behalf."
}
},
"additionalProperties": false
}Settle a network-MEMBER (e.g. RRG) purchase after you have sent the USDC that buy_product asked for. This is the member two-step: buy_product returns a pay-to address and amount, you transfer USDC on Base, then call this with the tx hash to mint, pay out, and get your download. For physical products include the shipping block and buyer_email. VIA-native purchases do NOT use this: they settle at the /api/x402/purchase endpoint that buy_product returns.
| Argument | Type | Description |
|---|---|---|
| tx_hash* | string | The USDC transfer transaction hash on Base. |
| order_id | string | The orderId buy_product returned for this member order. Required for physical member products: the order ships to the address recorded on it. |
| shipping | object | Required for physical member products. |
| product_id* | string | The member listing/token id (mcp_ref.token_id). |
| buyer_email | string | For order confirmation and file delivery. Required for physical products. |
| buyer_wallet* | string | The wallet that sent the USDC. |
| selected_size | string | The size you chose at buy_product (must match). |
Counter an existing quote, forwarded to the owning seller. Pass the quote_ref and a target price, revised selections, or both. Appends a round to the negotiation; stays non-binding until the seller approves.
| Argument | Type | Description |
|---|---|---|
| note | string | Free-form message to the seller. |
| quote_ref* | string | |
| selections | object | Revised configuration, if you are changing what you want. |
| seller_mcp_url* | string | mcp_ref.seller_mcp_url from a discovery result. |
| counter_total_usdc | number | Your proposed price for the configuration. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"seller_mcp_url",
"quote_ref"
],
"properties": {
"note": {
"type": "string",
"maxLength": 1000,
"description": "Free-form message to the seller."
},
"quote_ref": {
"type": "string",
"maxLength": 40,
"minLength": 3
},
"selections": {
"type": "object",
"required": [
"options"
],
"properties": {
"options": {
"type": "object",
"additionalProperties": {}
},
"quantity": {
"type": "integer",
"maximum": 100000,
"minimum": 1
}
},
"description": "Revised configuration, if you are changing what you want.",
"additionalProperties": false
},
"seller_mcp_url": {
"type": "string",
"minLength": 1,
"description": "mcp_ref.seller_mcp_url from a discovery result."
},
"counter_total_usdc": {
"type": "number",
"minimum": 0,
"description": "Your proposed price for the configuration."
}
},
"additionalProperties": false
}Discover live DEMAND: buyers who are actively looking for what you sell. Search by what you have ('raw selvedge denim', 'first pressing acid jazz vinyl', 'cold brew coffee') and get back buyers whose open briefs match. Each brief comes back as a TEASER: category, product type, one attribute, a door_url, and four facets where the buyer stated them , size, location, timing, and any brands they named. Use the facets to rule a brief in or out cheaply: do you stock that size, can you ship there, can you make that date. That is deliberately not enough to pitch well. The full brief (hard requirements, preferences, budget) is the paid tier: GET the door_url and pay the x402 micro-fee to unlock it, then POST your offer to the same door. Ranking already reads the full brief, so a teaser that matches is a real match. Omit query to browse recent open demand.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max buyers to return (default 10). |
| query | string | What you have to offer, e.g. 'raw selvedge denim' or 'acid jazz vinyl'. Omit to browse recent demand. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Max buyers to return (default 10)."
},
"query": {
"type": "string",
"description": "What you have to offer, e.g. 'raw selvedge denim' or 'acid jazz vinyl'. Omit to browse recent demand."
}
},
"additionalProperties": false
}Search the VIA network (VIA app + RRG + integrated platforms) for PRODUCTS and the sellers that offer them. Matches the published product catalogue (titles, descriptions, authors, categories) AND seller profiles, so 'books', an author, a title, or a category surfaces the actual product even when the seller's name does not contain the word. WHEN INTENT IS DEFINED: returns `results`, ONE relevance-ranked list blending every source. Each result carries a working `page_url` (the direct product page you give the user), plus `seller`, `list_price` for VIA stores (the store's own price and currency: show this to people, with its usdc as the wallet price), `price_usdc`, `image_url` (or null when the listing has no picture), and `mcp_ref` to transact. If more than one matches, PRESENT THEM side by side with prices and the key differences; do not silently pick one. WHEN INTENT IS LOOSE OR THERE IS NO MATCH: the response is `status: 'need_more_info'` with `suggested_dimensions`. DO NOT reply 'nothing is available'. Ask the user ONE clarifying question to sharpen intent (budget, brand/author, category, use), or retry this tool with a broader term, a synonym, the category, or the brand/author name. Only after a genuinely broadened retry also returns nothing should you say you could not find a match, and even then frame it as 'not found yet', not 'does not exist'.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max product results to return (default 10). |
| query* | string | What the user wants. Searches product catalogues AND seller profiles, e.g. 'raw denim jeans', 'Arnaud Frade', 'sourdough', or 'custom embroidered polo'. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Max product results to return (default 10)."
},
"query": {
"type": "string",
"minLength": 1,
"description": "What the user wants. Searches product catalogues AND seller profiles, e.g. 'raw denim jeans', 'Arnaud Frade', 'sourdough', or 'custom embroidered polo'."
}
},
"additionalProperties": false
}See a buyer's OPEN demand as free teasers, forwarded to their buyer MCP. Each teaser carries a paid door_url: the FULL brief and the ability to offer are paid at that x402 door, not here. Use a teaser to decide if your stock fits, then go to the door.
| Argument | Type | Description |
|---|---|---|
| buyer_mcp_url* | string | A buyer's mcp_url from a find_buyers result. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"buyer_mcp_url"
],
"properties": {
"buyer_mcp_url": {
"type": "string",
"minLength": 1,
"description": "A buyer's mcp_url from a find_buyers result."
}
},
"additionalProperties": false
}Read a buyer's public buying preferences, forwarded to their buyer MCP. Pass the buyer_mcp_url from a find_buyers result. Delegation caps and private notes are never exposed.
| Argument | Type | Description |
|---|---|---|
| buyer_mcp_url* | string | A buyer's mcp_url from a find_buyers result (…/buyers/{handle}/mcp). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"buyer_mcp_url"
],
"properties": {
"buyer_mcp_url": {
"type": "string",
"minLength": 1,
"description": "A buyer's mcp_url from a find_buyers result (…/buyers/{handle}/mcp)."
}
},
"additionalProperties": false
}Begin retrieving a digital deliverable you bought, forwarded to the owning seller. Returns a message to SIGN with the paying wallet plus a challenge token; then call get_download_links.
| Argument | Type | Description |
|---|---|---|
| product_id* | string | The purchased digital product id. |
| buyer_wallet* | string | The wallet that settled the purchase. |
| seller_mcp_url* | string | mcp_ref.seller_mcp_url from a discovery result. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"seller_mcp_url",
"product_id",
"buyer_wallet"
],
"properties": {
"product_id": {
"type": "string",
"minLength": 1,
"description": "The purchased digital product id."
},
"buyer_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "The wallet that settled the purchase."
},
"seller_mcp_url": {
"type": "string",
"minLength": 1,
"description": "mcp_ref.seller_mcp_url from a discovery result."
}
},
"additionalProperties": false
}Retrieve time-limited download links for a digital product you bought and settled, forwarded to the owning seller. Call get_download_challenge first, sign the message with the paying wallet, then call this with the challenge and signature.
| Argument | Type | Description |
|---|---|---|
| challenge* | string | The challenge token from get_download_challenge. |
| signature* | string | Signature of the challenge message, signed by buyer_wallet. |
| product_id* | string | The purchased digital product id. |
| buyer_wallet* | string | The wallet that settled the purchase. |
| seller_mcp_url* | string | mcp_ref.seller_mcp_url from a discovery result. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"seller_mcp_url",
"product_id",
"buyer_wallet",
"challenge",
"signature"
],
"properties": {
"challenge": {
"type": "string",
"minLength": 8,
"description": "The challenge token from get_download_challenge."
},
"signature": {
"type": "string",
"minLength": 8,
"description": "Signature of the challenge message, signed by buyer_wallet."
},
"product_id": {
"type": "string",
"minLength": 1,
"description": "The purchased digital product id."
},
"buyer_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "The wallet that settled the purchase."
},
"seller_mcp_url": {
"type": "string",
"minLength": 1,
"description": "mcp_ref.seller_mcp_url from a discovery result."
}
},
"additionalProperties": false
}Products the VIA network suggests for your owner, based on their Taste Card: title, seller, price in USDC, image URL, link and why it matched. Show your owner the images and links. Pass the action_token from VIA's message.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| action_token* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"action_token"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"action_token": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}Read your owner's VIA Taste Card: how it reads now and whether it is published. Pass the action_token from VIA's message.
| Argument | Type | Description |
|---|---|---|
| action_token* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"action_token"
],
"properties": {
"action_token": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}Fetch the configurable option space for a per-order (configurable) product before requesting a quote, forwarded to the owning seller. Returns option groups, choices, quantity rules and surcharges. Fixed-price products have no schema; buy those with buy_product.
| Argument | Type | Description |
|---|---|---|
| product_id* | string | The configurable product id from discovery. |
| seller_mcp_url* | string | mcp_ref.seller_mcp_url from a discovery result. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"seller_mcp_url",
"product_id"
],
"properties": {
"product_id": {
"type": "string",
"minLength": 1,
"description": "The configurable product id from discovery."
},
"seller_mcp_url": {
"type": "string",
"minLength": 1,
"description": "mcp_ref.seller_mcp_url from a discovery result."
}
},
"additionalProperties": false
}Get a VIA Personal Shopper for the calling Mind's owner. From a name and email it emails the owner a confirmation link; when they confirm, their VIA Personal Shopper is created, with its own wallet and on-chain (ERC-8004) identity that reads the whole VIA network and can buy for them within limits they set. Nothing is created until the owner confirms the email. No payment and no wallet signature. Pass your own Mind id as mind_id: each Mind gets exactly ONE shopper. Returns pending_verification until the owner confirms; after that, a repeat call returns the shopper and an appraisal_link_token: if you have the owner's email connected, appraise how they shop and call import_preference_appraisal with this token to train the shopper from day one.
| Argument | Type | Description |
|---|---|---|
| name* | string | The person's name, used as their agent display name. |
| email* | string | The person's email. The confirmation link is sent here; their agent, wallet and identity are created for this address when they confirm. |
| mind_id* | string | The calling Mind's own unique id on the Minds platform. The one-shopper-per-Mind cap is keyed on this; pass your real id. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"mind_id",
"name",
"email"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The person's name, used as their agent display name."
},
"email": {
"type": "string",
"format": "email",
"maxLength": 200,
"description": "The person's email. The confirmation link is sent here; their agent, wallet and identity are created for this address when they confirm."
},
"mind_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The calling Mind's own unique id on the Minds platform. The one-shopper-per-Mind cap is keyed on this; pass your real id."
}
},
"additionalProperties": false
}Fetch full detail for ONE listing before buying, from anywhere on the network, without leaving this connector. Pass the seller_mcp_url and product_id exactly as they appear in a find_seller / get_seller_products result (mcp_ref.seller_mcp_url and mcp_ref.product_id). Returns the listing with price, stock, and what the purchase requires. This forwards to the owning seller; the same buy loop (get_product -> get_shipping_quote -> buy_product) then settles here.
| Argument | Type | Description |
|---|---|---|
| product_id* | string | The listing id from discovery (mcp_ref.product_id). |
| seller_mcp_url* | string | mcp_ref.seller_mcp_url from a find_seller / get_seller_products result. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"seller_mcp_url",
"product_id"
],
"properties": {
"product_id": {
"type": "string",
"minLength": 1,
"description": "The listing id from discovery (mcp_ref.product_id)."
},
"seller_mcp_url": {
"type": "string",
"minLength": 1,
"description": "mcp_ref.seller_mcp_url from a find_seller / get_seller_products result."
}
},
"additionalProperties": false
}Check a quote's status by quote_ref, forwarded to the owning seller. Returns the current status, the binding total once approved, and the negotiation thread.
| Argument | Type | Description |
|---|---|---|
| quote_ref* | string | The quote_ref from request_quote, e.g. "QUO-2605-7K3PQM". |
| seller_mcp_url* | string | mcp_ref.seller_mcp_url from a discovery result. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"seller_mcp_url",
"quote_ref"
],
"properties": {
"quote_ref": {
"type": "string",
"maxLength": 40,
"minLength": 3,
"description": "The quote_ref from request_quote, e.g. \"QUO-2605-7K3PQM\"."
},
"seller_mcp_url": {
"type": "string",
"minLength": 1,
"description": "mcp_ref.seller_mcp_url from a discovery result."
}
},
"additionalProperties": false
}Drill into ONE seller's catalogue to answer 'is X available at seller Y'. Pass the seller_mcp_url from a find_seller / list_sellers result (a VIA-app seller or an RRG brand). Returns that seller's products matching your query (or its whole catalogue if query is omitted), each with price, in-stock sizes where known, and a direct web_url to the product page. Use this right after find_seller whenever the user names a specific seller or brand, e.g. 'raw denim jeans in size 36 at Standard & Strange'.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max products to return (default 15). |
| query | string | What to look for in that seller's catalogue, e.g. 'raw denim jean'. Omit to list the whole catalogue. |
| seller_mcp_url* | string | The mcp_url from a find_seller / list_sellers result, e.g. https://realrealgenuine.com/brand/standard-and-strange/mcp or https://app.getvia.xyz/sellers/the-sentient-startup/mcp |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"seller_mcp_url"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Max products to return (default 15)."
},
"query": {
"type": "string",
"description": "What to look for in that seller's catalogue, e.g. 'raw denim jean'. Omit to list the whole catalogue."
},
"seller_mcp_url": {
"type": "string",
"minLength": 1,
"description": "The mcp_url from a find_seller / list_sellers result, e.g. https://realrealgenuine.com/brand/standard-and-strange/mcp or https://app.getvia.xyz/sellers/the-sentient-startup/mcp"
}
},
"additionalProperties": false
}Resolve a seller's shipping cost to a destination country before buying, without leaving this connector. Pass the seller_mcp_url from the listing's mcp_ref and the ISO 3166-1 alpha-2 country. Returns the flat rate, a per-order-quote signal, or a rejection. Call this before buy_product and pass buyer_country there to fold shipping into the total.
| Argument | Type | Description |
|---|---|---|
| delivery | object | RRG-network brands on VIA: the full delivery address, for live carrier rates. |
| product_id | string | RRG-network brands on VIA quote live rates per item: pass the listing id (mcp_ref.product_id). |
| buyer_country* | string | ISO 3166-1 alpha-2 destination country code (e.g. GB, US, JP). |
| selected_size | string | |
| selected_color | string | |
| seller_mcp_url* | string | mcp_ref.seller_mcp_url from a find_seller / get_seller_products result. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"seller_mcp_url",
"buyer_country"
],
"properties": {
"delivery": {
"type": "object",
"required": [
"name",
"address_line1",
"city",
"postcode",
"country",
"phone"
],
"properties": {
"city": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"phone": {
"type": "string",
"maxLength": 40,
"minLength": 4
},
"region": {
"type": "string",
"maxLength": 120
},
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"postcode": {
"type": "string",
"maxLength": 40,
"minLength": 1
},
"address_line1": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"address_line2": {
"type": "string",
"maxLength": 200
}
},
"description": "RRG-network brands on VIA: the full delivery address, for live carrier rates.",
"additionalProperties": false
},
"product_id": {
"type": "string",
"minLength": 1,
"description": "RRG-network brands on VIA quote live rates per item: pass the listing id (mcp_ref.product_id)."
},
"buyer_country": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "ISO 3166-1 alpha-2 destination country code (e.g. GB, US, JP)."
},
"selected_size": {
"type": "string"
},
"selected_color": {
"type": "string"
},
"seller_mcp_url": {
"type": "string",
"minLength": 1,
"description": "mcp_ref.seller_mcp_url from a find_seller / get_seller_products result."
}
},
"additionalProperties": false
}Read a VIA store card by its slug: a product co-created by members of a Back Room, with its price, the co-creators (name, share, payout wallet, ERC-8004 id), and how to buy it (the seller MCP buy_product tool over the x402 door). Returns not_found for unknown slugs.
| Argument | Type | Description |
|---|---|---|
| slug* | string | The store slug from a shared link, e.g. app.getvia.xyz/store/<slug>. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"maxLength": 60,
"minLength": 2,
"description": "The store slug from a shared link, e.g. app.getvia.xyz/store/<slug>."
}
},
"additionalProperties": false
}Check the review status of a store you registered with register_store. Returns pending, approved, or rejected (with the reason). Once approved it also returns the ERC-8004 agent id and the per-seller MCP url.
| Argument | Type | Description |
|---|---|---|
| slug* | string | The slug returned by register_store. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"maxLength": 60,
"minLength": 1,
"description": "The slug returned by register_store."
}
},
"additionalProperties": false
}Read a published VIA taste card by its slug: the public, human-curated identity subset (references, obsessions, aesthetic words, anti-references) plus the member agent address. Cards are shared by their owners; there is no directory or search. Returns not_published for unknown or unpublished slugs.
| Argument | Type | Description |
|---|---|---|
| slug* | string | The card slug from a shared link, e.g. app.getvia.xyz/taste/<slug>. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"maxLength": 40,
"minLength": 3,
"description": "The card slug from a shared link, e.g. app.getvia.xyz/taste/<slug>."
}
},
"additionalProperties": false
}Short overview of VIA Labs, the agentic-commerce platform: what it does, key entrypoints for buyers and sellers, where to onboard.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Import a buyer's shopping-preference appraisal (derived by a Mind from the owner's email) onto their VIA Personal Shopper. Requires a link_token the owner minted in their VIA dashboard; it scopes the write to exactly one buyer. Pass ONLY the structured fields (categories, brands liked and avoided, sizes, cadence, budget signal): no free text, individual purchases, addresses, payment methods, order numbers or other personal details, and any extra field is discarded. VIA never receives raw email. Taste signals shape matching immediately and are drafted into the owner's Taste Card for them to approve and publish; the budget signal becomes a PROPOSED spending cap that the owner must approve in the dashboard before it gates any autonomous spend.
| Argument | Type | Description |
|---|---|---|
| appraisal* | object | The structured shopping-preference appraisal: taste and budget fields only, no free text or personal details. |
| link_token* | string | The link token the buyer owner minted in their VIA dashboard (POST /api/buyer/[buyerId]/appraisal action=mint_link). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"link_token",
"appraisal"
],
"properties": {
"appraisal": {
"type": "object",
"properties": {
"sizes": {
"type": "object",
"default": {},
"additionalProperties": {
"type": "string",
"maxLength": 40
}
},
"categories": {
"type": "array",
"items": {
"type": "object",
"required": [
"category"
],
"properties": {
"affinity": {
"type": "number",
"maximum": 1,
"minimum": 0
},
"category": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"typical_price_usd_low": {
"type": "number",
"minimum": 0
},
"typical_price_usd_high": {
"type": "number",
"minimum": 0
}
},
"additionalProperties": false
},
"default": [],
"maxItems": 40
},
"confidence": {
"type": "number",
"default": 0.5,
"maximum": 1,
"minimum": 0
},
"brands_liked": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"default": [],
"maxItems": 60
},
"budget_signal": {
"type": "object",
"properties": {
"single_item_ceiling_usd": {
"type": "number",
"minimum": 0
},
"monthly_spend_usd_estimate": {
"type": "number",
"minimum": 0
}
},
"additionalProperties": false
},
"brands_avoided": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"default": [],
"maxItems": 60
},
"purchase_cadence": {
"enum": [
"frequent",
"occasional",
"rare"
],
"type": "string"
},
"categories_avoided": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"default": [],
"maxItems": 40
}
},
"description": "The structured shopping-preference appraisal: taste and budget fields only, no free text or personal details.",
"additionalProperties": false
},
"link_token": {
"type": "string",
"minLength": 1,
"description": "The link token the buyer owner minted in their VIA dashboard (POST /api/buyer/[buyerId]/appraisal action=mint_link)."
}
},
"additionalProperties": false
}List active sellers across the VIA network (VIA app + RRG + integrated platforms). Each result is tagged with its platform and includes the per-seller MCP URL to connect to for deeper interaction (list_products, ask_sales_agent, buy_product).
| Argument | Type | Description |
|---|---|---|
| limit | integer | Optional cap on results. Omit to enumerate the ENTIRE network (no limit), which is the default. |
| category | string | Optional kind filter (applies to VIA-app sellers only). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"description": "Optional cap on results. Omit to enumerate the ENTIRE network (no limit), which is the default."
},
"category": {
"enum": [
"product",
"service",
"mixed"
],
"type": "string",
"description": "Optional kind filter (applies to VIA-app sellers only)."
}
},
"additionalProperties": false
}Negotiate a PAID offer with a buyer's Buying Agent, forwarded to their buyer MCP. This is the post-door step: submit a paid offer at the brief door first (POST /api/via/brief/[brief_id]/offer), then pass that brief_id, the offer's payment_tx_hash and the offer_token the door returned to you. There is no free pre-door pitch.
| Argument | Type | Description |
|---|---|---|
| brief_id* | string | The brief you made a paid offer against. |
| offer_text* | string | Your full pitch: what you are offering, terms, and price. |
| offer_token | string | The offer_token the door returned when you paid for this offer. Required unless you send payer_signature. |
| buyer_mcp_url* | string | The buyer's mcp_url from a find_buyers result. |
| payer_signature | string | Instead of offer_token: an EIP-191 signature by the paying wallet over "VIA paid offer\nbrief: <brief_id>\npayment: <payment_tx_hash lower case>". |
| payment_tx_hash* | string | The on-chain payment tx from your door offer. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"buyer_mcp_url",
"brief_id",
"payment_tx_hash",
"offer_text"
],
"properties": {
"brief_id": {
"type": "string",
"minLength": 1,
"description": "The brief you made a paid offer against."
},
"offer_text": {
"type": "string",
"maxLength": 4000,
"minLength": 1,
"description": "Your full pitch: what you are offering, terms, and price."
},
"offer_token": {
"type": "string",
"maxLength": 200,
"description": "The offer_token the door returned when you paid for this offer. Required unless you send payer_signature."
},
"buyer_mcp_url": {
"type": "string",
"minLength": 1,
"description": "The buyer's mcp_url from a find_buyers result."
},
"payer_signature": {
"type": "string",
"maxLength": 200,
"description": "Instead of offer_token: an EIP-191 signature by the paying wallet over \"VIA paid offer\\nbrief: <brief_id>\\npayment: <payment_tx_hash lower case>\"."
},
"payment_tx_hash": {
"type": "string",
"minLength": 1,
"description": "The on-chain payment tx from your door offer."
}
},
"additionalProperties": false
}Register your own store on the VIA network (no thirdweb, no human wizard). You only need ONE wallet: your payout_wallet (USDC lands here, you keep 97.5%). The platform creates and operates your store's ERC-8004 identity wallet for you; you do not supply or hold it. The flat 2.5% network fee is unchanged. Your store is created PENDING and stays invisible until a human reviews it for quality (nothing illegal, immoral, or offensive) within 24 hours. On approval the store goes live and its ERC-8004 identity is minted. Poll get_store_status with the returned slug to track the decision.
| Argument | Type | Description |
|---|---|---|
| kind* | string | What you sell. |
| slug | string | Optional URL slug. Derived from store_name if omitted. |
| email* | string | Contact email. Once approved, a sign-in link to manage the store is emailed here. There is no password. |
| headline | string | Short one-line tagline. |
| store_name* | string | Public store / brand name, e.g. "Arc Lights". |
| description | string | What the store sells, for buyers and for review. |
| website_url | string | Existing website, if any. |
Request an advisory price for a configurable product, forwarded to the owning seller. Pass the selections from get_offering_schema. Returns a quote_ref and a NON-BINDING proposed_total the seller reviews. Poll get_quote for the decision.
| Argument | Type | Description |
|---|---|---|
| spec | object | Free-form brief: deadline, artwork notes. Not priced, surfaced to the seller. |
| contact | string | Reach-back identifier so the seller can follow up. |
| product_id* | string | |
| selections* | object | |
| seller_mcp_url* | string | mcp_ref.seller_mcp_url from a discovery result. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"seller_mcp_url",
"product_id",
"selections"
],
"properties": {
"spec": {
"type": "object",
"description": "Free-form brief: deadline, artwork notes. Not priced, surfaced to the seller.",
"additionalProperties": {}
},
"contact": {
"type": "string",
"maxLength": 300,
"description": "Reach-back identifier so the seller can follow up."
},
"product_id": {
"type": "string",
"minLength": 1
},
"selections": {
"type": "object",
"required": [
"options"
],
"properties": {
"options": {
"type": "object",
"description": "Map of option group key to the chosen value.",
"additionalProperties": {}
},
"quantity": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Order quantity (default 1)."
}
},
"additionalProperties": false
},
"seller_mcp_url": {
"type": "string",
"minLength": 1,
"description": "mcp_ref.seller_mcp_url from a discovery result."
}
},
"additionalProperties": false
}Return the per-seller MCP endpoint URL for a given seller slug, verified against the active seller index.
| Argument | Type | Description |
|---|---|---|
| slug* | string | Seller slug (e.g. 'arc-lights'). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"minLength": 1,
"description": "Seller slug (e.g. 'arc-lights')."
}
},
"additionalProperties": false
}Submit a buyer's INTENT in their own words. Two things happen: (1) you get back the products across the VIA network that genuinely match it, from the full agentic matcher (it reads each product's data and reasons, it is not keyword search); and (2) the intent is BROADCAST live onto the network as an anonymised teaser (category + product type + one attribute only, never the raw text or any identity), so it appears on The Wire (app.getvia.xyz/wire) and sellers can respond. Use this when you are buying ON BEHALF of someone and want defined matches plus live broadcast. State the brief naturally, including any hard requirements ("raw selvedge denim, 32 waist", "first pressing on the Stiff label", "a gift of coffee"). Hard requirements are enforced (a product that fails one is excluded); broad briefs return on-category options. Returns matches with seller, price, a direct page_url, and the mcp_url to transact, plus broadcast:true and a door_url when the intent went live. For matching AND broadcast tied to a specific VIA buyer's saved taste and budget (and seller pitch-back), call submit_intent on that buyer's MCP (/buyers/{handle}/mcp) instead.
| Argument | Type | Description |
|---|---|---|
| brief* | string | What the buyer wants, in plain words, e.g. 'made in japan raw selvedge denim around 32 waist' or 'a gift of coffee for a family member'. |
| category | string | Category if you know it, e.g. 'apparel/denim', 'music/vinyl', 'food/coffee'. |
| reply_to | string | Where a seller can reach you about this brief: your own MCP url, or an email. STRONGLY RECOMMENDED. Without it a seller who pays to unlock your brief has no way to come back to you, so your brief is broadcast but unanswerable. Released only to sellers who have paid at the door, never in a public teaser. |
| budget_usd |
Change your owner's VIA Taste Card on their instruction: add or remove items per field, set a headline, and publish or unpublish. Set publish=true ONLY when the owner has explicitly asked to publish; publishing shares the card with the VIA network, which then suggests products and matches. The owner is notified of every change and can undo it in the app. Pass the action_token from VIA's message.
| Argument | Type | Description |
|---|---|---|
| add | object | |
| remove | any | |
| publish | boolean | |
| headline | string | |
| unpublish | boolean | |
| action_token* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"action_token"
],
"properties": {
"add": {
"type": "object",
"properties": {
"obsessions": {
"$ref": "#/properties/add/properties/references",
"description": "Things the owner is into: categories, materials, eras."
},
"references": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"maxItems": 20,
"description": "Brands, makers, designers, works the owner loves."
},
"aesthetic_vocab": {
"$ref": "#/properties/add/properties/references",
"description": "Words for the owner's style."
},
"anti_references": {
"$ref": "#/properties/add/properties/references",
"description": "Brands or styles the owner does not want."
}
},
"additionalProperties": false
},
"remove": {
"$ref": "#/properties/add"
},
"publish": {
"type": "boolean"
},
"headline": {
"type": "string",
"maxLength": 140
},
"unpublish": {
"type": "boolean"
},
"action_token": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}| string |
| Network-member orders: email for the order confirmation and file delivery. Required for physical member products. |
| buyer_wallet* | string | The buyer wallet that will settle in USDC on Base. |
| buyer_country | string | ISO 3166-1 alpha-2 destination country. Required when the seller ships; folds the shipping quote into the total. |
| selected_size | string | Variant size, for network-member products that have a size axis (e.g. S, M, L). Ignored by VIA-native listings. |
| buyer_agent_id | string | ERC-8004 agent id of the Buying Agent acting on the buyer's behalf. |
| selected_color | string | Variant colour, for network-member products that have a colour axis. Ignored by VIA-native listings. |
| seller_mcp_url* | string | mcp_ref.seller_mcp_url from a find_seller / get_seller_products result. |
| shipping_rate_handle | string | Network-member physical products only: the shipping option handle from a previous buy_product call. Omit on the first call to get the options. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"seller_mcp_url",
"product_id",
"buyer_wallet"
],
"properties": {
"qty": {
"type": "integer",
"default": 1,
"maximum": 1000,
"minimum": 1
},
"attendee": {
"type": "object",
"required": [
"name",
"email",
"country"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Full name of the person the pass is for."
},
"email": {
"type": "string",
"format": "email",
"maxLength": 200,
"description": "Email the organiser will send the pass and any follow-up to."
},
"country": {
"type": "string",
"maxLength": 60,
"minLength": 2,
"description": "Attendee country (name or ISO code), for the organiser."
}
},
"description": "Required for event passes.",
"additionalProperties": false
},
"delivery": {
"type": "object",
"required": [
"name",
"address_line1",
"city",
"postcode",
"country",
"phone"
],
"properties": {
"city": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"phone": {
"type": "string",
"maxLength": 40,
"minLength": 4
},
"region": {
"type": "string",
"maxLength": 120
},
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "ISO 3166-1 alpha-2; must match buyer_country if both are supplied"
},
"postcode": {
"type": "string",
"maxLength": 40,
"minLength": 1
},
"address_line1": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"address_line2": {
"type": "string",
"maxLength": 200
}
},
"description": "Required for physical products. Omit for digital / service.",
"additionalProperties": false
},
"product_id": {
"type": "string",
"minLength": 1,
"description": "The listing id from discovery (mcp_ref.product_id)."
},
"buyer_email": {
"type": "string",
"format": "email",
"description": "Network-member orders: email for the order confirmation and file delivery. Required for physical member products."
},
"buyer_wallet": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "The buyer wallet that will settle in USDC on Base."
},
"buyer_country": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "ISO 3166-1 alpha-2 destination country. Required when the seller ships; folds the shipping quote into the total."
},
"selected_size": {
"type": "string",
"description": "Variant size, for network-member products that have a size axis (e.g. S, M, L). Ignored by VIA-native listings."
},
"buyer_agent_id": {
"type": "string",
"description": "ERC-8004 agent id of the Buying Agent acting on the buyer's behalf."
},
"selected_color": {
"type": "string",
"description": "Variant colour, for network-member products that have a colour axis. Ignored by VIA-native listings."
},
"seller_mcp_url": {
"type": "string",
"minLength": 1,
"description": "mcp_ref.seller_mcp_url from a find_seller / get_seller_products result."
},
"shipping_rate_handle": {
"type": "string",
"description": "Network-member physical products only: the shipping option handle from a previous buy_product call. Omit on the first call to get the options."
}
},
"additionalProperties": false
}| buyer_agent_id |
| integer |
| Your ERC-8004 agent id, for an on-chain trust signal. |
| selected_color | string | The colour you chose at buy_product (must match). |
| seller_mcp_url* | string | The member seller_mcp_url you called buy_product on. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"seller_mcp_url",
"product_id",
"buyer_wallet",
"tx_hash"
],
"properties": {
"tx_hash": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{64}$",
"description": "The USDC transfer transaction hash on Base."
},
"order_id": {
"type": "string",
"maxLength": 4096,
"description": "The orderId buy_product returned for this member order. Required for physical member products: the order ships to the address recorded on it."
},
"shipping": {
"type": "object",
"required": [
"name",
"address_line1",
"city",
"postal_code",
"country",
"phone"
],
"properties": {
"city": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"phone": {
"type": "string",
"maxLength": 40,
"minLength": 4
},
"state": {
"type": "string",
"maxLength": 120
},
"country": {
"type": "string",
"maxLength": 60,
"minLength": 2
},
"postal_code": {
"type": "string",
"maxLength": 40,
"minLength": 1
},
"address_line1": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"address_line2": {
"type": "string",
"maxLength": 200
}
},
"description": "Required for physical member products.",
"additionalProperties": false
},
"product_id": {
"type": "string",
"minLength": 1,
"description": "The member listing/token id (mcp_ref.token_id)."
},
"buyer_email": {
"type": "string",
"format": "email",
"description": "For order confirmation and file delivery. Required for physical products."
},
"buyer_wallet": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "The wallet that sent the USDC."
},
"selected_size": {
"type": "string",
"description": "The size you chose at buy_product (must match)."
},
"buyer_agent_id": {
"type": "integer",
"description": "Your ERC-8004 agent id, for an on-chain trust signal.",
"exclusiveMinimum": 0
},
"selected_color": {
"type": "string",
"description": "The colour you chose at buy_product (must match)."
},
"seller_mcp_url": {
"type": "string",
"minLength": 1,
"description": "The member seller_mcp_url you called buy_product on."
}
},
"additionalProperties": false
}| payout_wallet* |
| string |
| Your USDC payout EOA on Base. Sale proceeds (97.5%) settle here. This is the only wallet you need. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"store_name",
"kind",
"payout_wallet",
"email"
],
"properties": {
"kind": {
"enum": [
"product",
"service",
"mixed"
],
"type": "string",
"description": "What you sell."
},
"slug": {
"type": "string",
"maxLength": 60,
"minLength": 1,
"description": "Optional URL slug. Derived from store_name if omitted."
},
"email": {
"type": "string",
"format": "email",
"maxLength": 200,
"description": "Contact email. Once approved, a sign-in link to manage the store is emailed here. There is no password."
},
"headline": {
"type": "string",
"maxLength": 200,
"description": "Short one-line tagline."
},
"store_name": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Public store / brand name, e.g. \"Arc Lights\"."
},
"description": {
"type": "string",
"maxLength": 2000,
"description": "What the store sells, for buyers and for review."
},
"website_url": {
"type": "string",
"format": "uri",
"maxLength": 300,
"description": "Existing website, if any."
},
"payout_wallet": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Your USDC payout EOA on Base. Sale proceeds (97.5%) settle here. This is the only wallet you need."
}
},
"additionalProperties": false
}| number |
| Ceiling in USD, if there is one. |
| type_terms | array | The product type in plain nouns, e.g. ['jean','denim trouser']. |
| preferences | array | Soft preferences. Used for ranking, never to exclude. |
| requirements | array | HARD requirements. A product failing any one of these is excluded. Be strict: put anything negotiable in preferences instead. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"brief"
],
"properties": {
"brief": {
"type": "string",
"maxLength": 2000,
"minLength": 2,
"description": "What the buyer wants, in plain words, e.g. 'made in japan raw selvedge denim around 32 waist' or 'a gift of coffee for a family member'."
},
"category": {
"type": "string",
"maxLength": 60,
"description": "Category if you know it, e.g. 'apparel/denim', 'music/vinyl', 'food/coffee'."
},
"reply_to": {
"type": "string",
"maxLength": 300,
"description": "Where a seller can reach you about this brief: your own MCP url, or an email. STRONGLY RECOMMENDED. Without it a seller who pays to unlock your brief has no way to come back to you, so your brief is broadcast but unanswerable. Released only to sellers who have paid at the door, never in a public teaser."
},
"budget_usd": {
"type": "number",
"description": "Ceiling in USD, if there is one.",
"exclusiveMinimum": 0
},
"type_terms": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 6,
"description": "The product type in plain nouns, e.g. ['jean','denim trouser']."
},
"preferences": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 8,
"description": "Soft preferences. Used for ranking, never to exclude."
},
"requirements": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 8,
"description": "HARD requirements. A product failing any one of these is excluded. Be strict: put anything negotiable in preferences instead."
}
},
"additionalProperties": false
}