Operations 3
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/scope3:scope3-mcp-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Scope3 MCP API
version: 2.0.0
description: 'Operations tagged MCP across 2 of this provider''s published API definitions: scope3-buyer-openapi-original.yml, scope3-storefront-openapi-original.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.interchange.io/api/v2/buyer
description: Production server
- url: https://api.interchange.io/api/v2/storefront
description: Production server
tags:
- name: MCP
description: Model Context Protocol endpoints for AI agents
paths:
/:
servers:
- url: https://api.interchange.io/mcp/v2/buyer
description: Production MCP server
post:
operationId: mcpInitialize
summary: Initialize MCP session
description: 'Start a new MCP (Model Context Protocol) session. This must be called before using any other MCP tools.
## Request Format
Send a JSON-RPC 2.0 request with:
- `method`: "initialize"
- `params.protocolVersion`: "2024-11-05"
- `params.capabilities`: {} (empty object)
- `params.clientInfo`: Your agent info
## Example Request
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2024-11-05",
"capabilities": {},
"clientInfo": { "name": "your-agent", "version": "1.0" }
}
}
```
## Example Response
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"protocolVersion": "2024-11-05",
"capabilities": { "tools": {} },
"serverInfo": { "name": "scope3-buyer-api", "version": "2.0.0" }
}
}
```'
tags:
- MCP
parameters:
- name: mcp-session-id
in: header
required: true
schema:
type: string
format: uuid
description: MCP session identifier. Generate a new UUID for this request.
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/McpInitializeRequest'
example:
jsonrpc: '2.0'
id: 1
method: initialize
params:
protocolVersion: '2024-11-05'
capabilities: {}
clientInfo:
name: your-agent
version: '1.0'
responses:
'200':
description: Session initialized successfully
content:
application/json:
schema:
$ref: '#/components/schemas/McpInitializeResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
security:
- bearerAuth: []
/api-call:
servers:
- url: https://api.interchange.io/mcp/v2/buyer
description: Production MCP server
post:
operationId: mcpApiCall
summary: Make API call via MCP
description: 'Make REST API calls to any Buyer API endpoint through MCP.
## Parameters
- `method`: HTTP method (GET, POST, PUT, DELETE)
- `path`: API path (e.g., "/advertisers", "/campaigns/{id}")
- `body`: Request body for POST/PUT requests (optional)
- `query`: Query parameters (optional)
## Example: List Advertisers
```json
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "api_call",
"arguments": {
"method": "GET",
"path": "/advertisers",
"query": { "take": 10 }
}
}
}
```
## Example Response
```json
{
"jsonrpc": "2.0",
"id": 2,
"result": {
"content": [
{
"type": "text",
"text": "{ \"advertisers\": [...], \"total\": 5 }"
}
]
}
}
```'
tags:
- MCP
parameters:
- name: mcp-session-id
in: header
required: true
schema:
type: string
format: uuid
description: MCP session identifier from the initialize call.
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/McpApiCallRequest'
example:
jsonrpc: '2.0'
id: 2
method: tools/call
params:
name: api_call
arguments:
method: GET
path: /advertisers
query:
take: 10
responses:
'200':
description: API call executed successfully
content:
application/json:
schema:
$ref: '#/components/schemas/McpToolResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
security:
- bearerAuth: []
/ask-about-capability:
servers:
- url: https://api.interchange.io/mcp/v2/buyer
description: Production MCP server
post:
operationId: mcpAskAboutCapability
summary: Ask about API capabilities
description: 'Learn about Buyer API features and capabilities using natural language questions.
This tool helps AI agents understand what the API can do without needing to read documentation.
## Parameters
- `question`: A natural language question about API capabilities
## Example Questions
- "How do I create a campaign?"
- "What can I configure on a campaign?"
- "What authentication is required?"
## Example Request
```json
{
"jsonrpc": "2.0",
"id": 4,
"method": "tools/call",
"params": {
"name": "ask_about_capability",
"arguments": {
"question": "How do I create a campaign?"
}
}
}
```
## Example Response
```json
{
"jsonrpc": "2.0",
"id": 4,
"result": {
"content": [
{
"type": "text",
"text": "To create a campaign, use POST /campaigns with..."
}
]
}
}
```'
tags:
- MCP
parameters:
- name: mcp-session-id
in: header
required: true
schema:
type: string
format: uuid
description: MCP session identifier from the initialize call.
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/McpAskCapabilityRequest'
example:
jsonrpc: '2.0'
id: 4
method: tools/call
params:
name: ask_about_capability
arguments:
question: How do I create a campaign?
responses:
'200':
description: Capability information returned
content:
application/json:
schema:
$ref: '#/components/schemas/McpToolResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
security:
- bearerAuth: []
components:
schemas:
McpAskCapabilityRequest:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: JSON-RPC version
id:
oneOf:
- type: string
- type: number
description: Request ID
method:
type: string
enum:
- tools/call
description: Method name
params:
type: object
properties:
name:
type: string
enum:
- ask_about_capability
description: Tool name
arguments:
type: object
properties:
question:
type: string
description: Natural language question about API capabilities
required:
- question
required:
- name
- arguments
required:
- jsonrpc
- id
- method
- params
McpToolResponse:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
id:
oneOf:
- type: string
- type: number
result:
type: object
properties:
content:
type: array
items:
type: object
properties:
type:
type: string
enum:
- text
text:
type: string
description: Response content
McpInitializeRequest:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: JSON-RPC version
id:
oneOf:
- type: string
- type: number
description: Request ID
method:
type: string
enum:
- initialize
description: Method name
params:
type: object
properties:
protocolVersion:
type: string
description: MCP protocol version
example: '2024-11-05'
capabilities:
type: object
description: Client capabilities
clientInfo:
type: object
properties:
name:
type: string
description: Client name
version:
type: string
description: Client version
required:
- name
- version
required:
- protocolVersion
- capabilities
- clientInfo
required:
- jsonrpc
- id
- method
- params
McpApiCallRequest:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: JSON-RPC version
id:
oneOf:
- type: string
- type: number
description: Request ID
method:
type: string
enum:
- tools/call
description: Method name
params:
type: object
properties:
name:
type: string
enum:
- api_call
description: Tool name
arguments:
type: object
properties:
method:
type: string
enum:
- GET
- POST
- PUT
- DELETE
description: HTTP method
path:
type: string
description: API path (e.g., "/advertisers")
body:
type: object
description: Request body for POST/PUT
query:
type: object
description: Query parameters
required:
- method
- path
required:
- name
- arguments
required:
- jsonrpc
- id
- method
- params
McpInitializeResponse:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
id:
oneOf:
- type: string
- type: number
result:
type: object
properties:
protocolVersion:
type: string
capabilities:
type: object
serverInfo:
type: object
properties:
name:
type: string
version:
type: string
McpApiCallRequest_2:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: JSON-RPC version
id:
oneOf:
- type: string
- type: number
description: Request ID
method:
type: string
enum:
- tools/call
description: Method name
params:
type: object
properties:
name:
type: string
enum:
- api_call
description: Tool name
arguments:
type: object
properties:
method:
type: string
enum:
- GET
- POST
- PUT
- DELETE
description: HTTP method
path:
type: string
description: API path (e.g., "/inventory-sources")
body:
type: object
description: Request body for POST/PUT
query:
type: object
description: Query parameters
required:
- method
- path
required:
- name
- arguments
required:
- jsonrpc
- id
- method
- params
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: API key or access token
x-refined-from:
- scope3-buyer-openapi-original.yml
- scope3-storefront-openapi-original.yml