Built for Agents

​

Overview

​

Using Our API via MCP

​

Quick Setup

​

Popular AI Agents

// ~/.config/claude/claude_desktop_config.json
{
  "mcpServers": {
    "scope3": {
      "command": "npx",
      "args": ["-y", "@scope3/campaign-mcp-server"],
      "env": {
        "SCOPE3_API_KEY": "your-api-key"
      }
    }
  }
}

export SCOPE3_API_KEY="your-api-key"
npx @scope3/campaign-mcp-server --http --port 3001

npm install @scope3/campaign-mcp-server

​

What Your Agents Can Do

• “Launch a $25K video campaign targeting Gen Z sports fans”
• “Pause underperforming campaigns and reallocate budget to winners”
• “Create A/B tests comparing different audience segments”

• “Which campaigns are overpacing and need budget adjustments?”
• “Show me completion rates by publisher and recommend optimizations”
• “Export last month’s performance data for the board presentation”

• “Analyze our brand’s performance across all campaigns this quarter”
• “What audience signals are driving the best ROI?”
• “Recommend budget allocation for next month based on performance trends”

​

Building Agents with Our API

​

MCP Server Architecture

// Brand Agent Management
create_brand_agent, list_brand_agents, update_brand_agent

// Campaign Operations  
create_campaign, update_campaign, list_campaigns

// Creative Management
create_creative, list_creatives, update_creative_status

// Performance Analytics
get_campaign_summary, analyze_tactics, export_campaign_data

// Reporting & Insights
generate_performance_report, get_campaign_health_score

​

Developer Integration Patterns

import { FastMCP } from 'fastmcp';

const mcp = new FastMCP({
  server: 'https://api.agentic.scope3.com/mcp',
  headers: {
    'x-scope3-api-key': process.env.SCOPE3_API_KEY
  }
});

// Your agent can now call Scope3 tools
const campaign = await mcp.call('create_campaign', {
  brandAgentId: 'ba_123',
  name: 'AI-Generated Campaign',
  prompt: 'Target high-intent users with video creative',
  budget: { total: 10000, currency: 'USD' }
});

import mcp_client

client = mcp_client.Client(
    server_url='https://api.agentic.scope3.com/mcp',
    headers={'x-scope3-api-key': os.environ['SCOPE3_API_KEY']}
)

# Create campaigns programmatically
campaign = client.call_tool('create_campaign', {
    'brandAgentId': 'ba_123',
    'name': 'AI-Optimized Campaign',
    'prompt': 'Focus on premium inventory with strong completion rates',
    'budget': {'total': 15000, 'currency': 'USD'}
})

// Example agent using our MCP endpoints
class AdvertisingAgent {
  constructor(scope3MCP) {
    this.scope3 = scope3MCP;
  }
  
  async optimizeCampaigns(brandAgentId) {
    // Get campaign performance
    const campaigns = await this.scope3.call('list_campaigns', { brandAgentId });
    
    // Analyze tactics for optimization opportunities  
    for (const campaign of campaigns) {
      const analysis = await this.scope3.call('analyze_tactics', {
        campaignId: campaign.id,
        analysisType: 'efficiency'
      });
      
      // Make optimization decisions based on AI analysis
      if (analysis.recommendations.length > 0) {
        await this.implementOptimizations(campaign, analysis);
      }
    }
  }
}

​

Advanced Agent Capabilities

• Campaign managers that coordinate with creative and analytics agents
• Portfolio optimization across multiple brand agents
• Automated A/B testing with statistical significance detection

• Build agents that implement your proprietary bidding strategies
• Create custom attribution models using our performance data
• Develop specialized audience targeting based on your business rules

• Connect agents to your CRM, BI tools, and marketing stack
• Implement custom approval workflows and budget controls
• Create automated reporting and alerting systems

​

Developer Resources

​

Why Agents Love Scope3

​

🗣️ Natural Language First

​

🧠 AI-Optimized Architecture

​

⚡ Real-time Intelligence

​

🔗 Seamless Integration

​

Next Steps