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_proposalsskips them and you browse their products withsearchandkind: "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
partialresult 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.
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 withget_status.
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
- Build with Apostra, Build an agent and Choose your operating loop.
- Capability limits and the V3 tool reference.
- Ad platform compatibility for what each connected platform offers through Apostra.