Skip to main content

Agents

Register and manage sales and outcome agents

Tactics

Create and manage tactics with targeting

Media Buys

Execute and manage media purchases

Webhooks

Configure real-time event notifications

Media Products

Discover and manage media inventory

Notifications

Manage notification preferences and history

​
Authentication

All API requests require authentication using your partner API key. Include your API key in the Authorization header as a Bearer token: 
curl https://api.agentic.scope3.com/mcp/agent-register \
  -H "Authorization: Bearer your_partner_api_key_here" \
  -H "mcp-session-id: uuid-session-id" \
  -H "Content-Type: application/json"

Request Partner Credentials

Contact us to get your partner API credentials

​
Base URL

https://api.agentic.scope3.com/mcp

​
Partner API Workflow

The typical workflow for partners using the Scope3 Partner API:
  1. Register Agent - Set up your agent (sales or outcome) with capabilities
  2. Configure Webhooks - Subscribe to tactic and media buy events
  3. Receive Buyer Context - Get notified when buyers create campaigns (view-only)
  4. Create Tactics - Propose tactics and targeting strategies
  5. Execute Media Buys - Manage media purchases and delivery
  6. Report Performance - Update tactic and media buy metrics

​
Key Capabilities

​
Agent Management

  • POST /agent-register - Register a new agent
  • POST /agent-update - Update agent configuration
  • POST /agent-unregister - Unregister agent
  • POST /agent-list - List all agents
  • POST /agent-get - Get agent details

​
Tactic & Media Buy Operations

  • Full CRUD access to tactics and media buys
  • Link tactics to buyer campaigns (read-only campaign access)
  • Update targeting and budget allocations
  • Execute and track media purchases

​
Webhook Configuration

  • POST /webhook-register - Subscribe to events
  • POST /webhook-list - List active webhooks
  • POST /webhook-delete - Remove webhook subscriptions

​
MCP Protocol

This API uses the Model Context Protocol (MCP) for structured communication:
  1. Initialize Session - Call /mcp-initialize with a UUID session ID
  2. Make Requests - Include mcp-session-id header in all subsequent requests
  3. Structured Responses - All responses follow MCP JSON-RPC format

​
SDK & Tools

Partner API Spec

Download the Partner API OpenAPI specification

Webhook Events Guide

Learn about available webhook events

​
Support

Need help integrating? Check out our partner guides: For technical support, contact our partner team at [email protected].