github.com/adcontextprotocol/adcp @v3.0.21
Chat with this repoWhat it actually does AI analysis from the code graph — generated when you open this
README
AdCP - Advertising Context Protocol
Open standard for advertising automation over MCP and A2A protocols
AdCP is an open standard that enables AI agents to discover inventory, buy media, build creatives, activate audiences, and manage accounts across advertising platforms. It defines domain-specific tasks and schemas that work over MCP and A2A as transports.
Documentation
docs.adcontextprotocol.org — Full protocol specification, integration guides, and task reference.
Protocols
| Protocol | Description | Key tasks |
|---|---|---|
| Media Buy | Inventory discovery, campaign creation, delivery reporting | get_products, create_media_buy, get_media_buy_delivery |
| Creative | Ad creative management across channels | build_creative, preview_creative, list_creative_formats |
| Signals | Audience and targeting data activation | get_signals, activate_signal |
| Accounts | Commercial identity and billing | sync_accounts, list_accounts, report_usage |
| Governance | Brand suitability and content standards | create_content_standards, calibrate_content |
| Brand | Brand identity discovery and resolution | brand.json well-known file |
| Sponsored Intelligence | Conversational brand experiences | si_initiate_session, si_send_message |
| Curation | Media inventory curation | Coming soon |
Repository structure
adcontextprotocol/
├── docs/ # Protocol documentation (Mintlify)
│ ├── media-buy/ # Media Buy protocol
│ ├── creative/ # Creative protocol
│ ├── signals/ # Signals protocol
│ ├── accounts/ # Accounts protocol
│ ├── governance/ # Governance protocol
│ ├── brand-protocol/ # Brand protocol
│ └── sponsored-intelligence/
├── server/ # Express server (registry, API, MCP)
│ ├── src/ # TypeScript source
│ └── public/ # Static pages (homepage, registry UI)
├── static/
│ ├── schemas/ # JSON schemas
│ └── openapi/ # OpenAPI specs
├── tests/ # Schema validation and integration tests
└── scripts/ # Build and release tooling
Local development
Prerequisites
- Node.js 20+
- Docker
Setup
npm install
docker compose up --build # Starts PostgreSQL + app with auto-migrations
The server runs on port 3000. Docs run separately with mintlify dev on port 3333.
Commands
npm test # Run tests (schemas, examples, migrations)
npm run build # Build TypeScript
npm run typecheck # Type check
npm run lint # Lint
See CLAUDE.md for detailed development guidelines.
JSON schemas
Schemas are available at /schemas/latest/:
- Registry:
/schemas/latest/index.json - Core objects:
/schemas/latest/core/*.json - Task schemas:
/schemas/latest/media-buy/*.json,/schemas/latest/signals/*.json - Enums:
/schemas/latest/enums/*.json
See static/schemas/README.md for validation examples.
Governance
AdCP is a project of AgenticAdvertising.Org, a pending 501(c)(6) nonprofit trade association incorporated in Delaware. The Foundation operates with four equally-weighted voting classes (brands, agencies, publishers, technology providers) and an open Working Group that develops AdCP. Reference sell-side implementation is maintained by the Prebid community — spec governance (AAO) and reference-implementation development (Prebid) are intentionally separate organizations.
All contributions are under Apache 2.0, which includes an express patent grant from contributors. Examples in docs and test vectors use fictional brands only — see CONTRIBUTING.md.
- CHARTER.md — Foundation structure, voting classes, Board, specification lifecycle, and conduct rules
- IPR_POLICY.md — Copyright, patent grants, trademark, and contribution terms
- Working Groups — Each WG sets its own cadence; see the page for current meetings
Contributing
We welcome contributions from platform providers, agencies, developers, and industry experts. See CONTRIBUTING.md for guidelines. All contributors must agree to the IPR Policy.
Community
- GitHub Discussions
- Working Groups — Each WG sets its own cadence; see the page for current meetings
Links
- Protocol documentation
- AgenticAdvertising.org — Member organization
- Release notes
- Roadmap
License
Licensed under Apache 2.0.