From c861edf862a683e46503a26d598c27a12520af4f Mon Sep 17 00:00:00 2001 From: agentmoose Date: Fri, 30 Jan 2026 05:55:49 -0700 Subject: [PATCH 1/3] add salesagent and agent nav --- _data/sidebar.yml | 29 ++++++++++++ agents/salesagent.md | 110 +++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 139 insertions(+) create mode 100644 agents/salesagent.md diff --git a/_data/sidebar.yml b/_data/sidebar.yml index e3aacd894b..4b5d6df225 100644 --- a/_data/sidebar.yml +++ b/_data/sidebar.yml @@ -2042,3 +2042,32 @@ isSectionHeader: 0 sectionTitle: subgroup: 0 + +#-------------- Prebid Agents --------------| + +- sbSecId: 10 + title: + link: + isHeader: 0 + isSectionHeader: 1 + sectionTitle: Prebid Agents + sectionId: prebid-agents + subgroup: 1000 + sbCollapseId: prebid-agents + +- sbSecId: 10 + title: General + link: + isHeader: 1 + headerId: agents-general + isSectionHeader: 0 + sectionTitle: + subgroup: 0 + +- sbSecId: 10 + title: Salesagent + link: /agents/salesagent.html + isHeader: 0 + isSectionHeader: 0 + sectionTitle: + subgroup: 0 diff --git a/agents/salesagent.md b/agents/salesagent.md new file mode 100644 index 0000000000..626d654015 --- /dev/null +++ b/agents/salesagent.md @@ -0,0 +1,110 @@ +--- +layout: page_v2 +title: Salesagent +description: A media sales agent that implements the AdCP Media Buy protocol +sidebarType: 10 +--- + +# AdCP Sales Agent + +The **AdCP Sales Agent** is a server that exposes advertising inventory to AI agents via the **Model Context Protocol (MCP)** and **Agent-to-Agent (A2A)** protocol. It is designed to integrate with ad servers like Google Ad Manager and provides tools for managing inventory and campaigns throughout their lifecycle. + + + +## Key Features + +### For AI Agents +- **Product Discovery**: Natural language search for advertising products. +- **Campaign Creation**: Automated media buying with targeting capabilities. +- **Creative Management**: Streamlined upload and approval workflows. +- **Performance Monitoring**: Real-time access to campaign metrics. + +### For Publishers +- **Multi-Tenant System**: Isolates data per publisher for security and organization. +- **Adapter Pattern**: Supports multiple ad servers (e.g., Google Ad Manager). +- **Real-time Dashboard**: Live activity feed powered by Server-Sent Events (SSE). +- **Workflow Management**: Unified system for human-in-the-loop approvals. +- **Admin Interface**: Web UI with Google OAuth for easy management. + +### For Developers +- **MCP Protocol**: Standard interface for AI agents. +- **A2A Protocol**: Agent-to-Agent communication via JSON-RPC 2.0. +- **REST API**: Programmatic tenant management. +- **Docker Deployment**: Easy setup for both local and production environments. + +## getting Started + +### Quick Start (Evaluation) + +You can try the sales agent locally using Docker: + +```bash +# Clone and start +git clone https://github.com/prebid/salesagent.git +cd salesagent +docker compose up -d + +# Test the MCP interface +uvx adcp http://localhost:8000/mcp/ --auth test-token list_tools +``` + +Access services at [http://localhost:8000](http://localhost:8000): +- **Admin UI**: `/admin` (Test credentials: `test123`) +- **MCP Server**: `/mcp/` +- **A2A Server**: `/a2a` + +### Production Deployment + +For production, publishers can deploy their own sales agent instance. The repository provides guides for various deployment methods, including Docker and cloud platforms. + +## The AdContext Protocol (AdCP) + +The Sales Agent is built on the **AdContext Protocol (AdCP)**, an open standard designed to standardize how AI agents interact with advertising platforms. + + + +### Protocol Architecture + +AdCP operates as a layer on top of standard AI interaction protocols: +- **MCP (Model Context Protocol)**: Facilitates direct integration with AI assistants (e.g., Claude Desktop). +- **A2A (Agent-to-Agent Protocol)**: Enables complex, autonomous workflows and collaboration between agents using JSON-RPC 2.0. + +### Core Concepts + +AdCP abstracts complex advertising operations into standardized domains: + +1. **Inventory Discovery** (`get_products`): Agents can search for ad products using natural language criteria (e.g., "video ads in North America") rather than specific line item IDs. +2. **Media Buying** (`create_media_buy`): A normalized workflow for proposal, negotiation, and booking that works consistently across different ad servers. +3. **Creative Management** (`build_creative`): Standardized handling of creative assets, allowing agents to generate or upload assets that match publisher specifications. +4. **Signal Activation** (`get_signals`, `activate_signal`): Mechanisms for passing context and identity signals to improve targeting and campaign performance. + +### Workflow Example + +A typical AI-driven campaign flow using AdCP might look like this: +1. **Discovery**: Expected outcome is a list of available "Products" matching the agent's intent. +2. **Planning**: The agent uses `create_media_buy` to submit a proposal. +3. **Review**: The Sales Agent (and potentially a human publisher) reviews the proposal. +4. **Execution**: Once approved, the Sales Agent pushes the orders to the underlying ad server (e.g., GAM). + +## Architecture + +The project follows a clean structure isolating core MCP components, business logic services, and ad server adapters. + +``` +salesagent/ +├── src/ +│ ├── core/ # Core MCP server components +│ ├── services/ # Business logic services +│ ├── adapters/ # Ad server integrations (e.g., GAM) +│ └── admin/ # Admin UI (Flask) +├── scripts/ # Utility and deployment scripts +└── tests/ # Comprehensive test suite +``` + +## Contributing + +Contributions are welcome! Please refer to the [Development Guide](https://github.com/prebid/salesagent/blob/main/docs/development/README.md) in the repository for details on setting up your environment and creating pull requests. From a45ff5cd95b95cc9891df8b0f481c97e4d1c9d87 Mon Sep 17 00:00:00 2001 From: Chris Huie <3444727+ChrisHuie@users.noreply.github.com> Date: Fri, 30 Jan 2026 05:57:30 -0700 Subject: [PATCH 2/3] fix typo --- agents/salesagent.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/agents/salesagent.md b/agents/salesagent.md index 626d654015..3bdff49598 100644 --- a/agents/salesagent.md +++ b/agents/salesagent.md @@ -34,7 +34,7 @@ The **AdCP Sales Agent** is a server that exposes advertising inventory to AI ag - **REST API**: Programmatic tenant management. - **Docker Deployment**: Easy setup for both local and production environments. -## getting Started +## Getting Started ### Quick Start (Evaluation) From ee5ff36e8e01deab6d2cf2d7f17980f2c5c36104 Mon Sep 17 00:00:00 2001 From: agentmoose Date: Fri, 30 Jan 2026 06:06:37 -0700 Subject: [PATCH 3/3] fix linting and naming --- agents/salesagent.md | 28 +++++++++++++++++----------- 1 file changed, 17 insertions(+), 11 deletions(-) diff --git a/agents/salesagent.md b/agents/salesagent.md index 626d654015..74e57e87a2 100644 --- a/agents/salesagent.md +++ b/agents/salesagent.md @@ -5,9 +5,9 @@ description: A media sales agent that implements the AdCP Media Buy protocol sidebarType: 10 --- -# AdCP Sales Agent +# Prebid Sales Agent -The **AdCP Sales Agent** is a server that exposes advertising inventory to AI agents via the **Model Context Protocol (MCP)** and **Agent-to-Agent (A2A)** protocol. It is designed to integrate with ad servers like Google Ad Manager and provides tools for managing inventory and campaigns throughout their lifecycle. +The **Prebid Sales Agent** is a server that exposes advertising inventory to AI agents via the **Model Context Protocol (MCP)** and **Agent-to-Agent (A2A)** protocol. It is designed to integrate with ad servers like Google Ad Manager and provides tools for managing inventory and campaigns throughout their lifecycle.