Skip to content

adcontextprotocol/adcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,270 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

AdCP - Advertising Context Protocol

Open standard for advertising automation over MCP and A2A protocols

Documentation GitHub stars MCP Compatible

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.

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

Links

License

Licensed under Apache 2.0.

About

Docs and reference implementation for the Ad Context Protocol

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors