build-seller-agent

Implement seller-side AdCP operations with capabilities registration and sandboxed responses.

18|15|Updated Aug 20, 2025
One-click install
npx skills add https://github.com/adcontextprotocol/adcp-client --skill build-seller-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-seller-agent
Source: https://github.com/adcontextprotocol/adcp-client/tree/main/.claude/skills/build-seller-agent
Command: npx skills add https://github.com/adcontextprotocol/adcp-client --skill build-seller-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Building a compliant, testable seller agent for the Ad Context Protocol requires implementing many coordinated tools, validating strict request/response schemas, handling synchronous and asynchronous flows, and supporting deterministic testing; this Skill consolidates guidance, response builders, and common pitfalls so engineers can deliver a correct seller implementation quickly.

Core Features & Use Cases

  • Capabilities registration: register get_adcp_capabilities as the first tool and advertise supported protocols.
  • Product and pricing management: implement get_products with publisher_properties, format_ids, delivery_type, and pricing_options.
  • Media buy lifecycle: validate create_media_buy requests, return appropriate mediaBuy responses or adcpError for business validation, and surface get_media_buys and delivery reporting.
  • Creative and catalog workflows: support list_creative_formats, sync_creatives, and catalog-driven creative management for retail media.
  • Approval and testing: implement guaranteed vs non-guaranteed approval flows, optional registerTestController for deterministic compliance testing and storyboards.
  • Use Case: create a sandbox seller that serves premium homepage inventory with CPM pricing, accepts guaranteed IOs with human approval flows, and passes storyboard validation.

Quick Start

Create a TypeScript seller agent that registers get_adcp_capabilities first, implements sync_accounts, get_products, create_media_buy and get_media_buys with sandboxed responses, validates shapes, and exposes a test controller for compliance testing.

Frequently Asked Questions about build-seller-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build an AdCP seller agent for a publishing platform?

To build an AdCP seller agent, implement seller-side operations including product listings, pricing options, media-buy creation, and delivery reporting. You must register get_adcp_capabilities first to advertise supported protocols before exposing other operations.

What is needed to validate media buy requests in an AdCP implementation?

Validating media buy requests requires checking strict request and response schemas, returning appropriate mediaBuy responses for valid inputs, and surfacing adcpError responses when business validation fails. This applies to both guaranteed and non-guaranteed inventory approval flows.

How do I test AdCP seller agent compliance and storyboards?

Testing AdCP seller agent compliance involves exposing a deterministic test controller, returning sandboxed responses, and supporting storyboard validation. This ensures your implementation passes technical requirements for registering get_adcp_capabilities and handling async webhook flows.

Can I use this approach for retail media networks and premium publishers?

Yes, this seller agent implementation applies to premium publishers, SSPs, and retail media networks. It handles guaranteed or non-guaranteed inventory, creative synchronization, approval workflows, and catalog-driven creative management for retail media contexts.

How do I handle creative synchronization and catalog management in AdCP?

Handling creative synchronization in AdCP requires implementing list_creative_formats and sync_creatives operations. For retail media, this extends to catalog-driven creative management to ensure proper format validation and approval workflows.

Why do I need to register get_adcp_capabilities first in a seller agent?

Registering get_adcp_capabilities first is a strict technical requirement that advertises supported protocols before any other operations are exposed. This establishes the sandboxed response environment needed for validating request and response shapes across sync_accounts, get_products, and media buy flows.