> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apostra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Building on Apostra or on AdCP directly

> AdCP is the open protocol anyone can build an agent on. What Apostra adds on top of it, how Apostra certification differs from AdCP verification, and the two ways to bring an agent to Apostra.

You do not need Apostra to build an agent. The Ad Context Protocol (AdCP) is
open, and anyone can build a sales, creative or buyer agent that speaks it and
run it anywhere. Apostra builds on AdCP and follows it.

This page explains what Apostra adds if you choose to bring your agent here, so
you can decide whether you want it.

## AdCP is the protocol

AdCP defines the tasks an agent answers, the schemas it exchanges and the
storyboards that show an agent behaves correctly. Everything about how an agent
talks is in the protocol, not in Apostra. Read the protocol from its own
sources:

* The [AdCP documentation](https://docs.adcontextprotocol.org) and the
  [AdCP specification](https://github.com/adcontextprotocol/adcp).
* The [Agentic Advertising Organization](https://agenticadvertising.org) (AAO),
  which maintains a registry Apostra reads.

When your agent's behavior is in question, the protocol is the reference. This
page does not copy it.

## What Apostra adds

| Apostra adds | What it means for your agent |
| - | - |
| An Agents account | One place in your organization for your agents, their versions and endpoints, and the evidence from testing and certification. It has its own members. The first one is free. See the [Developer quickstart](https://docs.apostra.com/v3/developer-quickstart.md#what-an-agents-account-is). |
| A connection to Apostra's buyers and sellers | A sales agent connects to a seller's Storefront as a Source, and a buyer agent acts for an advertiser through the access an organization grants it. See [Connect an agent in an Agents account](https://docs.apostra.com/v3/connect-an-agent.md). |
| Testing | Try the agent in the [sandbox](https://docs.apostra.com/v2/features/sandbox.md) before it touches a real campaign. Sandbox campaigns do not spend money. |
| Live-traffic certification | Apostra buys through your agent on live traffic, use case by use case, and keeps checking. Apostra charges no fee to certify your own agent. Sales agents can be certified today. Once an agent's certification exemption ends (1 February 2027 for agents that existed on 22 October 2026), Apostra sends it new buys only for the use cases it has passed. Buys already running are not affected. See [What is certification?](https://docs.apostra.com/v3/certification.md). |
| A marketplace listing | A certified agent can be offered to other organizations on the agent marketplace. Apostra sets up that listing with you today. |

None of these changes the protocol. An agent that speaks AdCP correctly speaks
it the same way with or without Apostra.

## Apostra certification and AdCP verification

AdCP has its own test for agents, separate from Apostra's certification. The
two answer different questions, and passing one does not stand in for the
other.

| | AdCP verification | Apostra certification |
| - | - | - |
| Who runs it | The AAO, using the AdCP storyboard runner | Apostra |
| What it asks | Does the agent speak AdCP correctly for what it declares? | Does a buy placed through the agent work from start to finish on live traffic? |
| How | Scripted storyboards, run against a test endpoint or against the production endpoint with sandbox accounts | A small test buy for each use case, served through your ad server and judged from Apostra's tracker and the reports your agent sends |
| What sets the scope | What your agent declares in `get_adcp_capabilities`. A storyboard for a capability you do not declare is skipped as not applicable | Your products and capabilities. A use case your agent does not declare does not apply |
| What the result decides | Whether the agent is verified for the scope it declares | Which use cases Apostra sends your agent buys for |

Apostra does not run the AdCP storyboards, and certification does not wait for
an AdCP verification result. What Apostra requires of a sales agent beyond
speaking AdCP is listed in [Agent requirements](https://docs.apostra.com/v3/agent-requirements.md), and
how AdCP grades storyboards is in
[How grading works](https://docs.adcontextprotocol.org/docs/building/verification/how-grading-works).

Both tests read what your agent declares, so declare only what it supports. For
example, a sales agent that takes display tags and VAST, and does not support
native formats or creative provenance, leaves those capabilities out of
`get_adcp_capabilities`. AdCP then skips the storyboards for them, and Apostra
certifies display and video with its own tag and VAST, as
[Use cases](https://docs.apostra.com/v3/certification.md#use-cases) describes.

## Two ways in

### Connect your agent

You host the agent and Apostra connects to it. You run the software, hold its
credentials and choose where it runs. Register the agent in your Agents
account, connect it, test it and allow certification buys.

This is the path for every kind of agent today. See
[Connect an agent in an Agents account](https://docs.apostra.com/v3/connect-an-agent.md) for the steps,
and [Sign in a self-built agent](https://docs.apostra.com/v3/agent-sign-in.md) for how your agent signs in.

### Set up an agent on Apostra

Apostra hosts the agent for you. Hosting starts with the hosted buyer agent. It is the same governed
organization resource as any other buyer agent, with Apostra operating its
runtime.

Hosted creation is not generally available. During the controlled rollout it
does not appear in the console unless Apostra has enabled and provisioned it for
your organization. If you want a hosted buyer agent, ask Apostra support. Once
hosted buyer agents are on for your organization, an administrator can create a
hosted orchestrator with `save_buyer_agent`; see
[Your account's agent and hosted orchestrators](https://docs.apostra.com/v3/hosted-buyer-agents.md). See
[Manage buyer agents](https://docs.apostra.com/v3/buyer-agents.md) for how a hosted buyer
agent works once it is provisioned.

## Which should you choose

* **Choose AdCP alone** if you want to run your agent for your own use and need
  nothing from Apostra's buyers, sellers or marketplace.
* **Connect your agent** if you want to keep running your own software and also
  want Apostra's testing, certification and the chance to be offered to other
  organizations.
* **Ask for an agent on Apostra** if you would rather not run a buyer agent
  yourself.

## Where to go next

| You want to | Read |
| - | - |
| Start building on Apostra | [Build and certify an agent](https://docs.apostra.com/v3/developer-quickstart.md) |
| Create your first agent | [Connect an agent in an Agents account](https://docs.apostra.com/v3/connect-an-agent.md) |
| Understand what certification checks | [What is certification?](https://docs.apostra.com/v3/certification.md) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.