Skip to main content

​
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:
You should get back {"status":"ok", ...}. 2. Confirm your key resolves to your account. Replace scope3_… with your key:
You should get back your account — 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 organization 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: Try these prompts with your connected agent:
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: 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.