MCP server
Connect any MCP client to https://mcp.vamos.simulmedia.com with your OAuth credentials. Tools mirror the REST API one to one, on both sides of the marketplace; everything an agent does lands in the same order book, audit trail, and approval gates as everything a human does.
https://mcp.sandbox.vamos.simulmedia.com/mcp, over Streamable HTTP, authenticated with your sandbox bearer secret rather than OAuth (see Sandbox). Send the same X-Sandbox-Session value your REST calls use and both surfaces drive one run. The Sandbox column below says which tools answer there now; tools/list is always the authoritative set.Seller tools
| Tool | Does | Sandbox |
|---|---|---|
publish_catalog | Packages and taxonomy versions (integrity-checked) | Planned |
update_rates / update_avails | Commit-versioned cards; tri-state avails | Planned |
list_review_queue | Orders awaiting your decision | Planned |
decide_order | Approve, reject, or counter, per unit; counters open a negotiation round | Live |
The sandbox seller is read-only apart from the decision: it publishes a seeded catalog rather than accepting one, so the three publish tools have no endpoint behind them yet. list_review_queue has one (GET /v1/me/orders) and no tool wrapping it.
Buyer tools
| Tool | Does | Sandbox |
|---|---|---|
list_sellers | Sellers within your scope | Live |
search_catalog | Packages by seller, type, network, buy type | Live |
get_avails | Tri-state availability, rates, locked-rate handles | Live |
create_order | Any buy-type mix and workflow, including proposals from an audience plan or an open brief; idempotent on your external ID | Live |
get_order | The current folded snapshot for one order | Live |
get_events | Replay an order's events in sequence, from after_seq | Live |
list_orders | Sweeps across the order book | Planned |
confirm_order | Resume document-path confirmations | Planned |
respond_negotiation | Accept, counter, or withdraw | Planned |
cancel_order | Idempotent cancel | Planned |
Approval thresholds are organization policy: agents transact, people keep the gates. A well-prompted agent should complete either quickstart from these docs unassisted; if yours cannot, that is a docs bug, and we want to hear about it.