OpenRTB Plugin for Claude Code

A Claude Code plugin that provides real tools for working with OpenRTB 2.6 protocol - validation, generation, conversion, and more.

Features

MCP Server Tools (Deterministic)

Tool	Description
openrtb_validate	Validate payloads against official JSON Schema
openrtb_convert_25_to_26	Convert bid requests from 2.5 to 2.6
openrtb_generate_request	Generate bid requests from parameters
openrtb_generate_response	Generate bid responses
openrtb_calculate_pod_floor	Calculate CTV pod floor with mincpmpersec
openrtb_diff	Compare two payloads and show differences

Slash Commands

• /openrtb-plugin:validate - Validate a payload
• /openrtb-plugin:generate - Generate from description

Agent & Skill

• expert agent - Deep OpenRTB knowledge for complex questions
• openrtb skill - Protocol expertise loaded automatically

Installation

# Build the MCP server first
cd ~/Code/projects/openrtb-plugin/mcp-server
npm install
npm run build

# Test the plugin
claude --plugin-dir ~/Code/projects/openrtb-plugin

Usage Examples

Validate a payload

Use the openrtb_validate tool on this payload: {"id": "123", "imp": [...]}

Generate a CTV pod request

Use openrtb_generate_request with type=ctv_pod, pod_duration=90, pod_max_ads=4

Calculate pod floor

Use openrtb_calculate_pod_floor with mincpmpersec=0.5 and duration=30

Convert 2.5 to 2.6

Use openrtb_convert_25_to_26 on this payload: {...}

OpenRTB 2.6 Highlights

Key features over 2.5:

• Ad Pods: poddur, podid, podseq, slotinpod, mincpmpersec
• Structured UA: sua object for better device identification
• Content objects: network and channel for CTV inventory
• Media type signaling: mtype and dur in bid responses
• Live TV: rqddurs for exact duration requirements

References

• OpenRTB 2.6 Spec
• AdCOM 1.0
• MCP TypeScript SDK

License

MIT