> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adspo.co/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Connect Adspo directly to Claude, ChatGPT, and other AI tools using the Model Context Protocol.

The Adspo MCP server lets AI assistants query ad creative data, browse brands, and access your saved boards without copy-pasting anything. Ask a question, get an answer powered by real data from your account.

MCP (Model Context Protocol) is an open standard that works across AI platforms. Connect once and you're good to go.

***

## MCP Server URL

```
https://mcp.adspo.co
```

Connecting will prompt you to authorise your Adspo account via your browser. Once connected, the AI has access to all the tools listed below.

***

## Connect to Claude

### Claude Desktop

1. In Claude, go to **Settings → Connectors** (or visit `claude.ai/settings/connectors` directly)
2. Select **Add Custom Connector**
3. Name the connection (e.g. `Adspo`) and paste the server URL: `https://mcp.adspo.co`
4. Click **Add**
5. You'll be taken back to the Connectors page — find Adspo and click **Connect**
6. When prompted by your browser, select **Open Claude**
7. Complete the Adspo sign-in in the browser window that opens

Once connected, start asking Claude questions about your Adspo data.

### Claude Code

```bash theme={null}
claude mcp add adspo --transport http https://mcp.adspo.co
```

***

## Connect to ChatGPT

1. In ChatGPT, go to **Settings → Apps** (or visit `chatgpt.com/#settings/Connectors` directly)
2. Select **Advanced Settings**
3. Turn on **Developer mode**
4. Click **Create App**
5. Name the connection (e.g. `Adspo`) and paste the server URL: `https://mcp.adspo.co`
6. Click **Create**
7. You'll be prompted to authenticate — select **Allow**
8. Return to ChatGPT, find the Adspo app, and click **Connect**
9. Click **Continue to Adspo** and complete the sign-in

***

## Everything else

For any MCP-compatible client not listed above, add the server using this config:

```json theme={null}
{
  "mcpServers": {
    "adspo": {
      "url": "https://mcp.adspo.co"
    }
  }
}
```

Or just tell your AI client:

```
Add this MCP server and give me the command: https://mcp.adspo.co
```

Your client will walk you through the authentication flow from there.

***

## Available tools

Your AI calls these automatically based on your questions — you don't need to reference tool names directly.

| Tool                      | What it does                                                                    |
| ------------------------- | ------------------------------------------------------------------------------- |
| `search_brands`           | Search for any brand by name or domain                                          |
| `get_brand`               | Get a brand's full profile — metrics, competitors, image/video mix, and traffic |
| `get_brand_creatives`     | Browse ad creatives for a specific brand with filters                           |
| `get_creatives`           | Browse ad creatives across all brands with filters                              |
| `get_creative_transcript` | Get the full transcript and timestamped segments for a video creative           |
| `get_spaces`              | List your spaces                                                                |
| `get_boards`              | List your boards, optionally filtered by space                                  |
| `get_board_creatives`     | Get creatives saved to a board                                                  |
| `get_usage`               | Check your API credit usage and when your quota resets                          |