Skip to content

Conversation

@bmilekic
Copy link
Contributor

@bmilekic bmilekic commented Dec 5, 2025

Summary

This PR implements the complete Deals Protocol (renamed from Curation Protocol) to enable buyer agents to discover and activate pre-packaged and ad-hoc inventory deal packages from SSPs and curation platforms.

New Protocol: Deals Protocol

The Deals Protocol provides an alternative to the Media Buy Protocol for package-based buying, enabling:

  • Natural language deal discovery
  • Activation on SSP platforms (Magnite, Pubmatic, OpenX, Index Exchange, Microsoft Curate, etc.)
  • Support for PMP and Curated deal types
  • Integration with Signals Protocol for audience-targeted inventory packages

Tasks Implemented

get_deals

  • Discover deal packages using natural language descriptions
  • Simplified API similar to get_products from the Media Buy protocol
  • Returns deals with platforms array showing where they can be activated

activate_deal

  • Activate deals on specific SSP platforms
  • Atomic success/error responses
  • Uses deployment model similar to Signals Protocol

Architecture

Integration Flow:
Buyer Agent → Deals Agent → Signals Agent
(Deals Protocol) (Signals Protocol)

  • Deals Agents integrate with Signals Agents (using Signals Protocol)
  • Buyer Agents interact with Deals Agents (using Deals Protocol)
  • Parallel architecture to Media Buy Protocol's Sales Agent integration

Documentation

  • /docs/deals/overview.mdx: User-friendly protocol introduction with use cases
  • /docs/deals/specification.mdx: Complete RFC specification with task definitions and data models
  • Updated intro, README, and navigation to reflect Deals Protocol

Key Design Decisions

  1. Simplified get_deals: Natural language brief and optional filters (similar to get_products)
  2. Platform availability in deals: Each deal includes platforms array showing where it can be activated
  3. SSP-focused: All examples use SSPs (not DSPs) as activation destinations
  4. Draft deals: Discovered deals have status "draft" until activated

Testing

✅ All schema validation tests pass (111 schemas validated)
✅ All example data validation tests pass
✅ TypeScript type checking passes

Changeset

A changeset has been included for major version bump automation.

🤖 Generated with Claude Code and verified and edited by humans

The Deals Protocol enables buyer agents to discover and activate pre-packaged and bespoke signal-enriched inventory deal packages from SSPs and curation platforms.

The Deals Protocol provides an alternative to the Media Buy Protocol for package-based buying, enabling:

- Natural language deal discovery
- Activation on SSP platforms (Magnite, Pubmatic, OpenX, Index Exchange, Microsoft Curate, etc.)
- Support for PMP and Curated deal types
- Integration with Signals Protocol for audience-targeted inventory packages
Updates the Deals Protocol schemas and documentation to match the established patterns used in the Media Buy Protocol, improving consistency across AdCP.

Key changes:
- Rename deal_spec → brief to match get_products pattern
- Add structured filters support via new deal-filters.json schema
- Add brand_manifest support (inline or URL reference)
- Add ext field for platform-specific extensions
- Update context/ext to use $ref to core schemas throughout

This improves developer experience by providing consistent request/response patterns across protocols while maintaining backward compatibility via changesets.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant