VIA Network: Agentic Commerce

Official28 tools

by app

Agentic commerce network: discover sellers and products, negotiate, and pay USDC on Base via x402.

xyz.getvia.app/via-network (MCP Server)

The xyz.getvia.app/via-network MCP server is an agentic commerce network that supports discovering sellers and products, negotiating, and paying in USDC on Base via x402. The server is available under the slug xyz-getvia-app-via-network and exposes 28 tools.

🛠️ Key Features

Discover sellers and products
Negotiate
Pay USDC on Base via x402
28 tools

🚀 Use Cases

Seller/product discovery in an agentic commerce workflow
Automated negotiation as part of a commerce process
Settlements using USDC on Base through x402

⚡ Developer Benefits

Tool-based integration (28 tools)
Focused support for commerce steps: discovery, negotiation, payment
Clear target network/payment path: USDC on Base via x402

⚠️ Limitations

Capabilities described are limited to the commerce network flow stated above (discovery, negotiation, payment).

Captured live from the server via tools/list.

list_sellers

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).

Parameters2

category	string	optional	Optional kind filter (applies to VIA-app sellers only).
limit	integer	optional	Optional cap on results. Omit to enumerate the ENTIRE network (no limit), which is the default.

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "product",
        "service",
        "mixed"
      ],
      "description": "Optional kind filter (applies to VIA-app sellers only)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Optional cap on results. Omit to enumerate the ENTIRE network (no limit), which is the default."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_seller

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`, `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'.

Parameters2

query	string	required	What the user wants. Searches product catalogues AND seller profiles, e.g. 'raw denim jeans', 'Arnaud Frade', 'sourdough', or 'custom embroidered polo'.
limit	integer	optional	Max product results to return (default 10).

Raw schema

{
  "type": "object",
  "properties": {
    "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'."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Max product results to return (default 10)."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

claim_pass

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.

Parameters5

product_id	string	required	UUID of the free pass tier, from a find_seller / get_seller_products result.
name	string	required	Name of the person attending, for the guest list.
email	string	required	Email to confirm the place to and for the organiser to admit by.
buyer_wallet	string	optional	Optional Base wallet, if the claimer has a VIA buyer identity.
buyer_agent_id	string	optional	Optional ERC-8004 agent id of the agent claiming on the buyer's behalf.

Raw schema

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "format": "uuid",
      "description": "UUID of the free pass tier, from a find_seller / get_seller_products result."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "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."
    },
    "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."
    }
  },
  "required": [
    "product_id",
    "name",
    "email"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_product

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.

Parameters2

seller_mcp_url	string	required	mcp_ref.seller_mcp_url from a find_seller / get_seller_products result.
product_id	string	required	The listing id from discovery (mcp_ref.product_id).

Raw schema

{
  "type": "object",
  "properties": {
    "seller_mcp_url": {
      "type": "string",
      "minLength": 1,
      "description": "mcp_ref.seller_mcp_url from a find_seller / get_seller_products result."
    },
    "product_id": {
      "type": "string",
      "minLength": 1,
      "description": "The listing id from discovery (mcp_ref.product_id)."
    }
  },
  "required": [
    "seller_mcp_url",
    "product_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_shipping_quote

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.

Parameters2

seller_mcp_url	string	required	mcp_ref.seller_mcp_url from a find_seller / get_seller_products result.
buyer_country	string	required	ISO 3166-1 alpha-2 destination country code (e.g. GB, US, JP).

Raw schema

{
  "type": "object",
  "properties": {
    "seller_mcp_url": {
      "type": "string",
      "minLength": 1,
      "description": "mcp_ref.seller_mcp_url from a find_seller / get_seller_products result."
    },
    "buyer_country": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "description": "ISO 3166-1 alpha-2 destination country code (e.g. GB, US, JP)."
    }
  },
  "required": [
    "seller_mcp_url",
    "buyer_country"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

buy_product

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 an x402 payment requirement and an order_ref, then settle at the absolute /api/x402/purchase endpoint it returns (sign an EIP-2612 USDC permit and POST { order_ref, x_payment }, OR send a raw USDC transfer to payTo and POST { order_ref, payment_tx_hash }). Call get_shipping_quote first and pass buyer_country to include shipping.

Parameters10

seller_mcp_url	string	required	mcp_ref.seller_mcp_url from a find_seller / get_seller_products result.
product_id	string	required	The listing id from discovery (mcp_ref.product_id).
qty	integer	optional
buyer_wallet	string	required	The buyer wallet that will settle in USDC on Base.
buyer_agent_id	string	optional	ERC-8004 agent id of the Buying Agent acting on the buyer's behalf.
buyer_country	string	optional	ISO 3166-1 alpha-2 destination country. Required when the seller ships; folds the shipping quote into the total.
delivery	object	optional	Required for physical products. Omit for digital / service.
attendee	object	optional	Required for event passes.
selected_size	string	optional	Variant size, for network-member products that have a size axis (e.g. S, M, L). Ignored by VIA-native listings.
selected_color	string	optional	Variant colour, for network-member products that have a colour axis. Ignored by VIA-native listings.

Raw schema

{
  "type": "object",
  "properties": {
    "seller_mcp_url": {
      "type": "string",
      "minLength": 1,
      "description": "mcp_ref.seller_mcp_url from a find_seller / get_seller_products result."
    },
    "product_id": {
      "type": "string",
      "minLength": 1,
      "description": "The listing id from discovery (mcp_ref.product_id)."
    },
    "qty": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000,
      "default": 1
    },
    "buyer_wallet": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "The buyer wallet that will settle in USDC on Base."
    },
    "buyer_agent_id": {
      "type": "string",
      "description": "ERC-8004 agent id of the Buying Agent acting on the buyer's behalf."
    },
    "buyer_country": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "description": "ISO 3166-1 alpha-2 destination country. Required when the seller ships; folds the shipping quote into the total."
    },
    "delivery": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "address_line1": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "address_line2": {
          "type": "string",
          "maxLength": 200
        },
        "city": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120
        },
        "region": {
          "type": "string",
          "maxLength": 120
        },
        "postcode": {
          "type": "string",
          "minLength": 1,
          "maxLength": 40
        },
        "country": {
          "type": "string",
          "minLength": 2,
          "maxLength": 2,
          "description": "ISO 3166-1 alpha-2; must match buyer_country if both are supplied"
        },
        "phone": {
          "type": "string",
          "minLength": 4,
          "maxLength": 40
        }
      },
      "required": [
        "name",
        "address_line1",
        "city",
        "postcode",
        "country",
        "phone"
      ],
      "additionalProperties": false,
      "description": "Required for physical products. Omit for digital / service."
    },
    "attendee": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200,
          "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",
          "minLength": 2,
          "maxLength": 60,
          "description": "Attendee country (name or ISO code), for the organiser."
        }
      },
      "required": [
        "name",
        "email",
        "country"
      ],
      "additionalProperties": false,
      "description": "Required for event passes."
    },
    "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."
    },
    "selected_color": {
      "type": "string",
      "description": "Variant colour, for network-member products that have a colour axis. Ignored by VIA-native listings."
    }
  },
  "required": [
    "seller_mcp_url",
    "product_id",
    "buyer_wallet"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

confirm_purchase

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.

Parameters9

seller_mcp_url	string	required	The member seller_mcp_url you called buy_product on.
product_id	string	required	The member listing/token id (mcp_ref.token_id).
buyer_wallet	string	required	The wallet that sent the USDC.
tx_hash	string	required	The USDC transfer transaction hash on Base.
buyer_email	string	optional	For order confirmation and file delivery. Required for physical products.
buyer_agent_id	integer	optional	Your ERC-8004 agent id, for an on-chain trust signal.
selected_size	string	optional	The size you chose at buy_product (must match).
selected_color	string	optional	The colour you chose at buy_product (must match).
shipping	object	optional	Required for physical member products.

Raw schema

{
  "type": "object",
  "properties": {
    "seller_mcp_url": {
      "type": "string",
      "minLength": 1,
      "description": "The member seller_mcp_url you called buy_product on."
    },
    "product_id": {
      "type": "string",
      "minLength": 1,
      "description": "The member listing/token id (mcp_ref.token_id)."
    },
    "buyer_wallet": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "The wallet that sent the USDC."
    },
    "tx_hash": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{64}$",
      "description": "The USDC transfer transaction hash on Base."
    },
    "buyer_email": {
      "type": "string",
      "format": "email",
      "description": "For order confirmation and file delivery. Required for physical products."
    },
    "buyer_agent_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Your ERC-8004 agent id, for an on-chain trust signal."
    },
    "selected_size": {
      "type": "string",
      "description": "The size you chose at buy_product (must match)."
    },
    "selected_color": {
      "type": "string",
      "description": "The colour you chose at buy_product (must match)."
    },
    "shipping": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "address_line1": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "address_line2": {
          "type": "string",
          "maxLength": 200
        },
        "city": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120
        },
        "state": {
          "type": "string",
          "maxLength": 120
        },
        "postal_code": {
          "type": "string",
          "minLength": 1,
          "maxLength": 40
        },
        "country": {
          "type": "string",
          "minLength": 2,
          "maxLength": 60
        },
        "phone": {
          "type": "string",
          "minLength": 4,
          "maxLength": 40
        }
      },
      "required": [
        "name",
        "address_line1",
        "city",
        "postal_code",
        "country",
        "phone"
      ],
      "additionalProperties": false,
      "description": "Required for physical member products."
    }
  },
  "required": [
    "seller_mcp_url",
    "product_id",
    "buyer_wallet",
    "tx_hash"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ask_sales_agent

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.

Parameters3

seller_mcp_url	string	required	mcp_ref.seller_mcp_url from a find_seller / get_seller_products result.
question	string	required	Free-form buyer question.
contact	string	optional	Optional reach-back identifier (email, handle, or the buyer agent MCP url).

Raw schema

{
  "type": "object",
  "properties": {
    "seller_mcp_url": {
      "type": "string",
      "minLength": 1,
      "description": "mcp_ref.seller_mcp_url from a find_seller / get_seller_products result."
    },
    "question": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "Free-form buyer question."
    },
    "contact": {
      "type": "string",
      "maxLength": 300,
      "description": "Optional reach-back identifier (email, handle, or the buyer agent MCP url)."
    }
  },
  "required": [
    "seller_mcp_url",
    "question"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_offering_schema

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.

Parameters2

seller_mcp_url	string	required	mcp_ref.seller_mcp_url from a discovery result.
product_id	string	required	The configurable product id from discovery.

Raw schema

{
  "type": "object",
  "properties": {
    "seller_mcp_url": {
      "type": "string",
      "minLength": 1,
      "description": "mcp_ref.seller_mcp_url from a discovery result."
    },
    "product_id": {
      "type": "string",
      "minLength": 1,
      "description": "The configurable product id from discovery."
    }
  },
  "required": [
    "seller_mcp_url",
    "product_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

request_quote

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.

Parameters5

seller_mcp_url	string	required	mcp_ref.seller_mcp_url from a discovery result.
product_id	string	required
selections	object	required
spec	object	optional	Free-form brief: deadline, artwork notes. Not priced, surfaced to the seller.
contact	string	optional	Reach-back identifier so the seller can follow up.

Raw schema

{
  "type": "object",
  "properties": {
    "seller_mcp_url": {
      "type": "string",
      "minLength": 1,
      "description": "mcp_ref.seller_mcp_url from a discovery result."
    },
    "product_id": {
      "type": "string",
      "minLength": 1
    },
    "selections": {
      "type": "object",
      "properties": {
        "options": {
          "type": "object",
          "additionalProperties": {},
          "description": "Map of option group key to the chosen value."
        },
        "quantity": {
          "type": "integer",
          "minimum": 1,
          "maximum": 100000,
          "description": "Order quantity (default 1)."
        }
      },
      "required": [
        "options"
      ],
      "additionalProperties": false
    },
    "spec": {
      "type": "object",
      "additionalProperties": {},
      "description": "Free-form brief: deadline, artwork notes. Not priced, surfaced to the seller."
    },
    "contact": {
      "type": "string",
      "maxLength": 300,
      "description": "Reach-back identifier so the seller can follow up."
    }
  },
  "required": [
    "seller_mcp_url",
    "product_id",
    "selections"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_quote

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.

Parameters2

seller_mcp_url	string	required	mcp_ref.seller_mcp_url from a discovery result.
quote_ref	string	required	The quote_ref from request_quote, e.g. "QUO-2605-7K3PQM".

Raw schema

{
  "type": "object",
  "properties": {
    "seller_mcp_url": {
      "type": "string",
      "minLength": 1,
      "description": "mcp_ref.seller_mcp_url from a discovery result."
    },
    "quote_ref": {
      "type": "string",
      "minLength": 3,
      "maxLength": 40,
      "description": "The quote_ref from request_quote, e.g. \"QUO-2605-7K3PQM\"."
    }
  },
  "required": [
    "seller_mcp_url",
    "quote_ref"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

counter_quote

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.

Parameters5

seller_mcp_url	string	required	mcp_ref.seller_mcp_url from a discovery result.
quote_ref	string	required
counter_total_usdc	number	optional	Your proposed price for the configuration.
selections	object	optional	Revised configuration, if you are changing what you want.
note	string	optional	Free-form message to the seller.

Raw schema

{
  "type": "object",
  "properties": {
    "seller_mcp_url": {
      "type": "string",
      "minLength": 1,
      "description": "mcp_ref.seller_mcp_url from a discovery result."
    },
    "quote_ref": {
      "type": "string",
      "minLength": 3,
      "maxLength": 40
    },
    "counter_total_usdc": {
      "type": "number",
      "minimum": 0,
      "description": "Your proposed price for the configuration."
    },
    "selections": {
      "type": "object",
      "properties": {
        "options": {
          "type": "object",
          "additionalProperties": {}
        },
        "quantity": {
          "type": "integer",
          "minimum": 1,
          "maximum": 100000
        }
      },
      "required": [
        "options"
      ],
      "additionalProperties": false,
      "description": "Revised configuration, if you are changing what you want."
    },
    "note": {
      "type": "string",
      "maxLength": 1000,
      "description": "Free-form message to the seller."
    }
  },
  "required": [
    "seller_mcp_url",
    "quote_ref"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_download_challenge

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.

Parameters3

seller_mcp_url	string	required	mcp_ref.seller_mcp_url from a discovery result.
product_id	string	required	The purchased digital product id.
buyer_wallet	string	required	The wallet that settled the purchase.

Raw schema

{
  "type": "object",
  "properties": {
    "seller_mcp_url": {
      "type": "string",
      "minLength": 1,
      "description": "mcp_ref.seller_mcp_url from a discovery result."
    },
    "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."
    }
  },
  "required": [
    "seller_mcp_url",
    "product_id",
    "buyer_wallet"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_download_links

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.

Parameters5

seller_mcp_url	string	required	mcp_ref.seller_mcp_url from a discovery result.
product_id	string	required	The purchased digital product id.
buyer_wallet	string	required	The wallet that settled the purchase.
challenge	string	required	The challenge token from get_download_challenge.
signature	string	required	Signature of the challenge message, signed by buyer_wallet.

Raw schema

{
  "type": "object",
  "properties": {
    "seller_mcp_url": {
      "type": "string",
      "minLength": 1,
      "description": "mcp_ref.seller_mcp_url from a discovery result."
    },
    "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."
    },
    "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."
    }
  },
  "required": [
    "seller_mcp_url",
    "product_id",
    "buyer_wallet",
    "challenge",
    "signature"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_buyer_preferences

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.

Parameters1

buyer_mcp_url

string

required

A buyer's mcp_url from a find_buyers result (…/buyers/{handle}/mcp).

Raw schema

{
  "type": "object",
  "properties": {
    "buyer_mcp_url": {
      "type": "string",
      "minLength": 1,
      "description": "A buyer's mcp_url from a find_buyers result (…/buyers/{handle}/mcp)."
    }
  },
  "required": [
    "buyer_mcp_url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_buyer_briefs

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.

Parameters1

buyer_mcp_url

string

required

A buyer's mcp_url from a find_buyers result.

Raw schema

{
  "type": "object",
  "properties": {
    "buyer_mcp_url": {
      "type": "string",
      "minLength": 1,
      "description": "A buyer's mcp_url from a find_buyers result."
    }
  },
  "required": [
    "buyer_mcp_url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

negotiate

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 and the offer's payment_tx_hash here. There is no free pre-door pitch.

Parameters4

buyer_mcp_url	string	required	The buyer's mcp_url from a find_buyers result.
brief_id	string	required	The brief you made a paid offer against.
payment_tx_hash	string	required	The on-chain payment tx from your door offer.
offer_text	string	required	Your full pitch: what you are offering, terms, and price.

Raw schema

{
  "type": "object",
  "properties": {
    "buyer_mcp_url": {
      "type": "string",
      "minLength": 1,
      "description": "The buyer's mcp_url from a find_buyers result."
    },
    "brief_id": {
      "type": "string",
      "minLength": 1,
      "description": "The brief you made a paid offer against."
    },
    "payment_tx_hash": {
      "type": "string",
      "minLength": 1,
      "description": "The on-chain payment tx from your door offer."
    },
    "offer_text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4000,
      "description": "Your full pitch: what you are offering, terms, and price."
    }
  },
  "required": [
    "buyer_mcp_url",
    "brief_id",
    "payment_tx_hash",
    "offer_text"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

accept_offer

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.

Parameters4

buyer_mcp_url	string	required	The buyer's mcp_url from a find_buyers result.
offer_id	string	required	Your reference id for the offer being accepted.
amount_usd	number	optional	Total order amount in USD, for the caps check.
category	string	optional	Product category, checked against the buyer's lists.

Raw schema

{
  "type": "object",
  "properties": {
    "buyer_mcp_url": {
      "type": "string",
      "minLength": 1,
      "description": "The buyer's mcp_url from a find_buyers result."
    },
    "offer_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "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."
    },
    "category": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "Product category, checked against the buyer's lists."
    }
  },
  "required": [
    "buyer_mcp_url",
    "offer_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

submit_intent

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.

Parameters7

brief	string	required	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	optional	Category if you know it, e.g. 'apparel/denim', 'music/vinyl', 'food/coffee'.
requirements	array	optional	HARD requirements. A product failing any one of these is excluded. Be strict: put anything negotiable in preferences instead.
preferences	array	optional	Soft preferences. Used for ranking, never to exclude.
type_terms	array	optional	The product type in plain nouns, e.g. ['jean','denim trouser'].
budget_usd	number	optional	Ceiling in USD, if there is one.
reply_to	string	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "brief": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2000,
      "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'."
    },
    "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."
    },
    "preferences": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 8,
      "description": "Soft preferences. Used for ranking, never to exclude."
    },
    "type_terms": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 6,
      "description": "The product type in plain nouns, e.g. ['jean','denim trouser']."
    },
    "budget_usd": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Ceiling in USD, if there is one."
    },
    "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."
    }
  },
  "required": [
    "brief"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_buyers

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, and a door_url. 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.

Parameters2

query	string	optional	What you have to offer, e.g. 'raw selvedge denim' or 'acid jazz vinyl'. Omit to browse recent demand.
limit	integer	optional	Max buyers to return (default 10).

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What you have to offer, e.g. 'raw selvedge denim' or 'acid jazz vinyl'. Omit to browse recent demand."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Max buyers to return (default 10)."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_seller_products

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'.

Parameters3

seller_mcp_url	string	required	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
query	string	optional	What to look for in that seller's catalogue, e.g. 'raw denim jean'. Omit to list the whole catalogue.
limit	integer	optional	Max products to return (default 15).

Raw schema

{
  "type": "object",
  "properties": {
    "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"
    },
    "query": {
      "type": "string",
      "description": "What to look for in that seller's catalogue, e.g. 'raw denim jean'. Omit to list the whole catalogue."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Max products to return (default 15)."
    }
  },
  "required": [
    "seller_mcp_url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

seller_mcp_url

Return the per-seller MCP endpoint URL for a given seller slug, verified against the active seller index.

Parameters1

slug

string

required

Seller slug (e.g. 'arc-lights').

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "Seller slug (e.g. 'arc-lights')."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_via_overview

Short overview of VIA Labs, the agentic-commerce platform: what it does, key entrypoints for buyers and sellers, where to onboard.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

register_store

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.

Parameters9

store_name	string	required	Public store / brand name, e.g. "Arc Lights".
kind	string	required	What you sell.
payout_wallet	string	required	Your USDC payout EOA on Base. Sale proceeds (97.5%) settle here. This is the only wallet you need.
email	string	required	Contact email. Becomes the dashboard login once approved; keep it.
password	string	required	Dashboard password (8+ chars). Keep it: this is how the store is managed after approval.
slug	string	optional	Optional URL slug. Derived from store_name if omitted.
description	string	optional	What the store sells, for buyers and for review.
headline	string	optional	Short one-line tagline.
website_url	string	optional	Existing website, if any.

Raw schema

{
  "type": "object",
  "properties": {
    "store_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Public store / brand name, e.g. \"Arc Lights\"."
    },
    "kind": {
      "type": "string",
      "enum": [
        "product",
        "service",
        "mixed"
      ],
      "description": "What you sell."
    },
    "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."
    },
    "email": {
      "type": "string",
      "format": "email",
      "maxLength": 200,
      "description": "Contact email. Becomes the dashboard login once approved; keep it."
    },
    "password": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200,
      "description": "Dashboard password (8+ chars). Keep it: this is how the store is managed after approval."
    },
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "Optional URL slug. Derived from store_name if omitted."
    },
    "description": {
      "type": "string",
      "maxLength": 2000,
      "description": "What the store sells, for buyers and for review."
    },
    "headline": {
      "type": "string",
      "maxLength": 200,
      "description": "Short one-line tagline."
    },
    "website_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 300,
      "description": "Existing website, if any."
    }
  },
  "required": [
    "store_name",
    "kind",
    "payout_wallet",
    "email",
    "password"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_store_status

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.

Parameters1

slug

string

required

The slug returned by register_store.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "The slug returned by register_store."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

import_preference_appraisal

Import a buyer's shopping-preference appraisal (derived by a Mind from the owner's email) onto their VIA buying agent. Requires a link_token the owner minted in their VIA dashboard; it scopes the write to exactly one buyer. Pass the structured appraisal (categories, brands, sizes, cadence, budget signal). VIA never receives raw email. Taste signals shape matching and negotiation immediately; the budget signal becomes a PROPOSED spending cap that the owner must approve in the dashboard before it gates any autonomous spend.

Parameters2

link_token	string	required	The link token the buyer owner minted in their VIA dashboard (POST /api/buyer/[buyerId]/appraisal action=mint_link).
appraisal	object	required	The structured shopping-preference appraisal. Use evidence_summary for prose only; never include raw quoted email.

Raw schema

{
  "type": "object",
  "properties": {
    "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)."
    },
    "appraisal": {
      "type": "object",
      "properties": {
        "categories": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "category": {
                "type": "string",
                "minLength": 1,
                "maxLength": 60
              },
              "affinity": {
                "type": "number",
                "minimum": 0,
                "maximum": 1
              },
              "typical_price_usd_low": {
                "type": "number",
                "minimum": 0
              },
              "typical_price_usd_high": {
                "type": "number",
                "minimum": 0
              }
            },
            "required": [
              "category"
            ],
            "additionalProperties": false
          },
          "maxItems": 40,
          "default": []
        },
        "brands_liked": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80
          },
          "maxItems": 60,
          "default": []
        },
        "brands_avoided": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80
          },
          "maxItems": 60,
          "default": []
        },
        "sizes": {
          "type": "object",
          "additionalProperties": {
            "type": "string",
            "maxLength": 40
          },
          "default": {}
        },
        "purchase_cadence": {
          "type": "string",
          "enum": [
            "frequent",
            "occasional",
            "rare"
          ]
        },
        "budget_signal": {
          "type": "object",
          "properties": {
            "monthly_spend_usd_estimate": {
              "type": "number",
              "minimum": 0
            },
            "single_item_ceiling_usd": {
              "type": "number",
              "minimum": 0
            }
          },
          "additionalProperties": false
        },
        "notable_recent_purchases": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "category": {
                "type": "string",
                "maxLength": 60
              },
              "item": {
                "type": "string",
                "maxLength": 200
              },
              "price_usd": {
                "type": "number",
                "minimum": 0
              },
              "when": {
                "type": "string",
                "maxLength": 40
              }
            },
            "additionalProperties": false
          },
          "maxItems": 50,
          "default": []
        },
        "confidence": {
          "type": "number",
          "minimum": 0,
          "maximum": 1,
          "default": 0.5
        },
        "evidence_summary": {
          "type": "string",
          "maxLength": 4000
        }
      },
      "additionalProperties": false,
      "description": "The structured shopping-preference appraisal. Use evidence_summary for prose only; never include raw quoted email."
    }
  },
  "required": [
    "link_token",
    "appraisal"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_taste_card

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.

Parameters1

slug

string

required

The card slug from a shared link, e.g. app.getvia.xyz/taste/<slug>.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 3,
      "maxLength": 40,
      "description": "The card slug from a shared link, e.g. app.getvia.xyz/taste/<slug>."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_store_card

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.

Parameters1

slug

string

required

The store slug from a shared link, e.g. app.getvia.xyz/store/<slug>.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 2,
      "maxLength": 60,
      "description": "The store slug from a shared link, e.g. app.getvia.xyz/store/<slug>."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Install

Tools (28)

list_sellersfind_sellerclaim_passget_productget_shipping_quotebuy_productconfirm_purchaseask_sales_agent

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://app.getvia.xyz/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "via-network": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.getvia.xyz/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

xyz.getvia.app/via-network (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

list_sellers

find_seller

claim_pass

get_product

get_shipping_quote

buy_product

confirm_purchase

ask_sales_agent

get_offering_schema

request_quote

get_quote

counter_quote

get_download_challenge

get_download_links

get_buyer_preferences

get_buyer_briefs

negotiate

accept_offer

submit_intent

find_buyers

get_seller_products

seller_mcp_url

get_via_overview

register_store

get_store_status

import_preference_appraisal

get_taste_card

get_store_card

Install

Remote endpoint

Related servers