Skip to main content
Use Apostra’s V3 MCP if your buyer agent buys across more than one seller. Apostra builds on AdCP, the open Ad Context Protocol, and adds one endpoint, https://api.apostra.com/mcp/v3, lets the agent discover sellers, request proposals from them, keep campaign, creative and media-buy records, stage buys, launch only on explicit confirmation, and read delivery. If your agent buys on a single platform, that platform’s own MCP may be all you need.

What each option manages for you

For how the first two compare in detail, see Apostra compared with platform MCPs and direct seller APIs. You do not need Apostra to build an agent on AdCP. See Building on Apostra or on AdCP directly.

What the agent does with Apostra

Build a read-only client first, then add one durable step at a time. Every call names its account with accountId. The full loop, with what to persist at each checkpoint, is in Build an agent.

Limits to check before you commit

  • Apostra does not host your agent. Your application owns scheduling, retries, durable state and human checkpoints. There is no hosted end-to-end orchestrator in the current V3 catalog.
  • Sellers that sell through an ad platform sell wholesale only. They take no briefs, so request_proposals skips them and you browse their products with search and kind: "wholesale_product" instead.
  • A listed seller is not necessarily ready for your advertiser. A seller where the advertiser has no active account is not asked for a proposal.
  • One proposal execution can run per buyer at a time, and each seller attempt is bounded at 90 seconds. Follow every result cursor: a partial result is not the whole answer.
  • V3 saves and attaches a finished creative. It does not generate or revise creative content.
  • Buyer reporting is day-grain, and seller delivery ranges are limited to 90 days.
The complete list is in Capability limits.

When not to use Apostra

  • You buy on one platform and use only features its own MCP exposes. Use that platform’s MCP or API directly.
  • You need Apostra to run your agent for you. Hosting an arbitrary customer-defined agent is not a public V3 capability.
  • You need a seller that is not connected through Apostra and has no way to be. Apostra can record a supply request and an invitation for it, but it cannot buy from a seller that is not on Apostra.
  • You need real-time or hourly delivery reporting. Delivery reaches Apostra through seller reports and polling, and a successful response is not a promise that every event has arrived.

Next step

Install the developer plugin, then ask your coding agent to prove account access with get_status.
That is the Claude Code form. For Codex run codex plugin marketplace add https://github.com/apostra-public/apostra.git, then codex plugin add apostra-developer@apostra. Any MCP client that supports remote Streamable HTTP can add https://api.apostra.com/mcp/v3 and sign in with OAuth. Then follow Connect in five minutes and Build an agent.

Sources