Buy with an MCP agent

Connect any MCP client (Claude, or your own runtime) to https://mcp.vamos.simulmedia.com with your OAuth credentials. The tools mirror the REST API one to one, so anything an agent does is visible in the same order book your humans see. Trying it in the sandbox first? The endpoint is https://mcp.sandbox.vamos.simulmedia.com/mcp and the credential is your sandbox bearer secret.

A working session

User: "Get 200 GRPs of prime reach on Acme in the first two weeks of October,
       under $450 a unit, preemptible is fine."

agent → search_catalog { "seller": "acme", "package_type": "daypart" }
agent → get_avails { "package_id": "acme-prime", "weeks": ["2026-W40","2026-W41"] }
# sellout_level 0.62, scatter :30 preemptible at 405.00, clearance tier P2
agent → create_order { "workflow": "catalog", "line_items": [{ "rate": { "buy_type": "preemptible", ... }, ... }] }
agent → get_order { "order_id": "ord_9f3a12c4b7e1" }   # polls through seller_review
# placed → completed. Receipt attached. Human never touched a spreadsheet.

Guardrails that stay on

• Approval thresholds are org policy: you decide which principals may confirm_order or accept counters, and above what spend.
• Agents cannot skip gates: seller_review pauses for the seller's human regardless of who submitted.
• Give your agent the reconciliation rules: dedup on seq, snapshot as truth, sweep non-terminal orders after outages.

A well-prompted agent can run the entire buyer quickstart from the docs alone. That is not a demo trick; it is the acceptance test we hold these pages to.