Interchange API

Account-resolved Interchange tools and direct, per-seller AdCP endpoints for agentic advertising.

Authentication

Agents starting without a credential: begin with auth.md and the zero-touch activation contract. Anonymous registration requires no email or human step, issues the canonical interchange:read scope, and starts with a zero-spend allowance. Interactive clients can instead use OAuth; existing organizations can use an API key.

Skills catalog

Portable, versioned workflows teach compatible agents how to use Interchange safely. Buyer workflows cover account readiness, campaign setup and buying, campaign management, and local tag-sheet inspection. Seller administrators can follow the OpenAI publication workflow. The catalog also includes direct seller buying and sales-agent validation. Read the machine-readable catalog for current immutable versions.

Authentication Discovery

MCP Endpoints

Interchange V3 preview

The globally available, account-resolved MCP preview. One endpoint serves Buyer and Seller Accounts; the authenticated account, enrollment, and capabilities determine the nouns and tools returned by tools/list. V2 remains the stable default API.

Connect your MCP client to:
https://api.staging.apostra.com/mcp/v3
The client will be prompted to authenticate via OAuth.
MCP Tools
  • get_status – Resolve the active account, blockers, and next actions
  • search and get – Read the account's visible nouns
  • save_<noun> – Use only the typed writes advertised for the active account

Seller-specific AdCP

Each published Seller can advertise a one-seller AdCP endpoint in its listing. The card selects the Seller protocol door; Interchange remains the agent of record and anchors buyer identity, contract, governance, reporting, and ledger evidence. Follow the card's verified actions[kind=adcp].url; do not substitute the V3 product API.

Canonical endpoint shape:
https://api.staging.apostra.com/seller/{platformId}/mcp
The endpoint selects the Seller. The buyer's credential identifies and authorizes the caller.

Stable V2 Endpoints

Buyer API

Stable persona-scoped API for buyer integrations.

https://api.staging.apostra.com/mcp/v2/buyer

Storefront API

Stable persona-scoped API for storefront integrations.

https://api.staging.apostra.com/mcp/v2/storefront