Skip to main content
The Scope3 Agentic API provides a machine-readable skill file that AI agents can use to understand and interact with the API.

​
Skill File URL

Buyer Skill File

Machine-readable API spec for buyer operations

Storefront Skill File

Machine-readable API spec for storefront operations

​
What is a Skill File?

A skill file is a single markdown document that gives AI agents everything they need to use an API. Instead of forcing agents to parse complex OpenAPI specs or navigate multiple documentation pages, a skill file provides a concise, LLM-optimized format. Why skill files work better for agents:
  • Single context load - One file contains the complete API surface, fitting within an agent’s context window
  • Natural language first - Written in prose that LLMs understand natively, not just structured schemas
  • Actionable examples - Real request/response pairs agents can adapt, not abstract specifications
  • Prioritized information - Common operations and gotchas highlighted, not buried in exhaustive docs
What’s included:
  • API base URL and authentication
  • Available endpoints with example requests
  • MCP tools for agent integration
  • Response formats and error handling
  • Rate limits and best practices

​
Buyer Skill File Capabilities

​
Advertiser & Account Management

  • Create and manage advertisers with brand domain linking
  • Multi-account support with account switching
  • Sandbox mode for testing without real spend
  • Configure optimization apply mode (auto vs manual)

​
Campaign Management

  • Create, update, launch, and pause campaigns
  • Support for discovery, performance, and audience campaign types
  • Flight date and budget configuration
  • Channel and country targeting constraints
  • Audience targeting and suppression via audienceConfig
  • Catalog attachment for product feed campaigns

​
Product Discovery

  • Browse available inventory with AI-powered relevance matching
  • Filter by publisher domain, sales agent, and pricing model
  • Interactive product selection with per-product budgets
  • Auto-select products using AI-based scoring and budget allocation
  • Attach discovery sessions to campaigns

​
Performance Optimization

  • Set optimization goals for ROAS, CPA, and custom metrics
  • Event-based and metric-based goal types
  • Attribution window configuration
  • AI-generated optimization suggestions with approve/reject workflow

​
Event Tracking & Measurement

  • Configure event sources for conversion tracking
  • Log conversion events (purchases, leads, sign-ups, etc.)
  • View event summaries with hourly aggregation
  • Sync measurement data to partner platforms

​
Sales Agents & Partner Accounts

  • Discover available partner agents and their capabilities
  • Register credentials with partner platforms
  • Discover and link partner accounts to advertisers
  • View billing options and account resolution methods

​
Audiences & Catalogs

  • Sync first-party CRM audiences to Scope3
  • Manage product catalogs (create, update, sync to partners)
  • Support for multiple catalog types (product, hotel, vehicle, etc.)
  • Syndicate audiences, events, and catalogs to ADCP agents

​
Reporting & Analytics

  • Campaign and media buy performance metrics (impressions, spend, clicks)
  • Summary and timeseries reporting views
  • CSV export support
  • Property list management for publisher domain include/exclude

​
Notifications

  • Unread notifications surfaced in help and ask_about_capability responses
  • List, filter, and manage notifications via REST endpoints
  • Mark as read or acknowledged, bulk mark-all-as-read

​
Creative Manifests

  • Campaign-scoped creative configuration
  • Template-based creative generation with asset references

​
Storefront Skill File Capabilities

​
Storefront Management

  • Create, update, and delete storefronts
  • Readiness checks before going live
  • Enable/disable storefront with validation

​
Inventory Sources & Agent Registration

  • Register agents as inventory sources (MCP or REST protocol)
  • Configure authentication types (API key, OAuth, JWT, no auth)
  • Activate, update, and delete inventory sources

​
Billing

  • Stripe Connect provisioning and onboarding
  • Account verification status and balance
  • Transaction and payout history with cursor pagination

​
OAuth Configuration

  • Set up OAuth flows for agent authentication
  • Callback endpoint management

​
Notifications

  • System notifications for resource events
  • List, read, and acknowledge notification endpoints
To use a skill file, point your AI agent to the URL above. For detailed connection instructions, see Built for Agents.