Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.agentic.scope3.com/llms.txt

Use this file to discover all available pages before exploring further.

Quick Start

Building a buyer integration? Start with Buyer Onboarding for the end-to-end campaign-launch flow. This page covers AI agent connections.
The fastest way to get started depends on how you want to connect. Most users connect an AI agent (Claude, ChatGPT, etc.) directly — no code required.

Step 1: Get Access

1

Create your account

Sign up at interchange.io and log in.
2

Choose your authentication method

  • OAuth (recommended for AI agents): Used automatically when connecting via Claude Connectors or ChatGPT MCP Connectors. No keys to manage — just log in when prompted.
  • API Key (for CLI tools and custom integrations): Generate one at interchange.io/user-api-keys. Keys start with scope3_.

Sanity check (optional — 30 seconds)

Before wiring up an agent, you can confirm the platform is reachable and your API key works with two curls. 1. Reach the platform. No auth needed:
curl https://api.interchange.io/health
You should get back {"status":"ok", ...}. 2. Confirm your key resolves to your account. Replace scope3_… with your key:
curl https://api.interchange.io/api/v2/accounts/current \
  -H "Authorization: Bearer scope3_your_api_key_here"
You should get back your seat — id, company, name, role. A 401 means the key is wrong or revoked; a 403 with TOS_ACCEPTANCE_REQUIRED on a write call means your customer hasn’t accepted the latest Platform Service Agreement (read endpoints still work — see Buyer Onboarding for the acceptance flow). If both succeed, you’re set up. Continue with an AI agent connection below or jump straight to Buyer Onboarding for the end-to-end campaign-launch flow.

Step 2: Connect

Pick your AI tool and follow the detailed setup guide:

Claude (Team / Enterprise)

Recommended. Admin registers the connector once, every team member connects via OAuth.

Claude Desktop (Personal)

Manual config file setup for personal Claude Desktop use with an API key.

Claude Code (CLI)

Add the MCP server via CLI and authenticate with an API key.

ChatGPT

Connect via MCP Connector with OAuth — no API keys needed.

Cursor

Add the MCP server in Cursor settings with an API key.

REST API

Standard HTTP endpoints for programmatic integrations.

Step 3: Try It Out

Once connected, your agent has access to 3 MCP tools:
ToolWhat It Does
healthCheck API connectivity
ask_about_capabilityAsk the API what it can do (natural language)
api_callExecute any REST endpoint
Try these prompts with your connected agent:
List all my advertisers

Create an advertiser called "Acme Corp"

What campaigns exist for advertiser 24?

Create a $50K performance campaign optimized for SALES
The agent uses ask_about_capability to discover endpoints, then api_call to execute them. No need to memorize API paths.

Skill File (for Custom Agents)

Building your own agent? Point it at the skill file for instant API understanding:
RoleSkill File URL
Buyerhttps://api.interchange.io/api/v2/buyer/skill.md
Storefronthttps://api.interchange.io/api/v2/storefront/skill.md
Example prompt for your agent: “Read https://api.interchange.io/api/v2/buyer/skill.md and help me create an advertiser” Learn more about what a skill file is.

Next Steps

Buyer Onboarding

End-to-end campaign-launch flow — from advertiser to live campaign.

Storefront Onboarding

Sellers: register your storefront and expose inventory.

Advertiser Guide

Learn the advertiser model and required fields.

Built for Agents

Why the API is agent-first and what that means for you.

Authentication

API keys, OAuth, and SSO configuration.

API Reference

Browse all available endpoints.