Skip to main content

​
Overview

Sales agents provide access to advertising inventory through the ADCP protocol. They represent various types of sellers: publishers, ad networks, sales houses, and other inventory sources.

​
How It Works

By default, you have access to inventory through Scope3’s relationships with sales agents. You can optionally register your own accounts with sales agents for:
  • Direct billing - Pay the sales agent directly (Scope3 charges less for direct connections)
  • Your negotiated terms - Use your existing relationships and rates
  • Additional inventory - Access sales agents that Scope3 doesn’t have relationships with

​
Account Precedence

When you discover products, the system automatically:
  1. Your accounts - Uses your registered sales agent accounts
  2. Scope3 accounts - Falls back to Scope3’s relationships
  3. Unavailable - Skips agents with no available accounts

​
Managing Your Sales Agents

​
List All Sales Agents

Agent: Call tool agent_list with body: 
{
  "type": "SALES"
}
Shows all registered sales agents with account status:
  • ✅ Your account - You have a direct relationship
  • 🏢 Scope3 account - Available through Scope3’s relationship
  • ❌ Unavailable - No accounts registered

​
Register a New Sales Agent

Register the sales agent in your organization: Agent: Call tool agent_register with body: 
{
  "name": "Scribd Sales",
  "type": "SALES",
  "endpointUrl": "https://ads.scribd.com/adcp",
  "protocol": "MCP",
  "authenticationType": "API_KEY",
  "description": "Premium reading platform",
  "authConfig": {
    "auth_token_env": "SCRIBD_API_KEY"
  }
}
This creates the sales agent in the global registry. Note: organizationId is optional and will be auto-detected from your customer account if not provided.

​
Update Sales Agent

The owner of the globally registered sales agent is able to update the sales agent information: Agent: Call tool agent_update with body: 
{
  "agentId": "agent_123",
  "name": "Updated Name",
  "description": "Updated description"
}

​
Add Your Account to a Sales Agent

If you have a direct relationship with a sales agent, you can add your account credentials to access the sales agent: Agent: Call tool agent_account_register with body: 
{
  "agentId": "agent_123",
  "accountIdentifier": "your-account-id",
  "auth": {
    "type": "api_key",
    "token": "your_scribd_api_key"
  }
}
Agent accounts are only supported for SALES agents. OUTCOME and SIGNAL agents do not use the account system.

​
Update Your Account

Update your account details for a sales agent: Agent: Call tool agent_account_update with body: 
{
  "agentId": "agent_123",
  "accountIdentifier": "your-account-id",
  "auth": {
    "type": "api_key",
    "token": "updated_api_key"
  }
}

​
List Your Accounts

List all your accounts registered with a specific sales agent: Agent: Call tool agent_account_list with body: 
{
  "agentId": "agent_123"
}

​
Unregister Your Account

Deactivate your account with a sales agent: Agent: Call tool agent_account_unregister with body: 
{
  "agentId": "agent_123",
  "confirm": true
}

​
Unregister Sales Agent

Completely unregister a sales agent - deactivates all direct relationship accounts and disables the agent: Agent: Call tool agent_unregister with body: 
{
  "agentId": "agent_123",
  "confirm": true
}
This action deactivates ALL customer accounts associated with the agent and disables the agent itself. Only the owner who registered the agent can perform this action.

​
Using Sales Agents in Campaigns

Sales agents are automatically used for product discovery: Agent: Call tool tactic_discover_products with body: 
{
  "campaignBrief": "Premium coffee brand inventory"
}
What happens behind the scenes:
  1. Scope3 identifies available sales agents (your accounts + Scope3 accounts)
  2. Scope3 sends ADCP get-products calls to each sales agent via MCP/A-to-A protocol
  3. Each sales agent responds with their available inventory through the ADCP protocol
  4. Scope3 combines and ranks the results
ADCP uses MCP (Model Context Protocol) or A-to-A (Agent-to-Agent) communication, not REST APIs. For technical details, see the official ADCP documentation.
To use specific sales agents only: Agent: Call tool tactic_discover_products with body: 
{
  "campaignBrief": "Coffee brands",
  "salesAgents": ["scribd_sales", "pubmatic_direct"]
}

​
Important Notes

When you use your own sales agent account, you are responsible for payments directly with that sales agent. Scope3 is not involved in the financial relationship.
If you register a sales agent that Scope3 doesn’t have a relationship with, Scope3 cannot provide technical support or guarantees for that integration.

​
Next Steps

  • Use tactic_discover_products to find inventory across your available sales agents
  • Set up campaigns using discovered products
  • Monitor performance through reporting