Developer Docs

MCP Server

CreatorIQ exposes a Model Context Protocol server so any MCP-capable agent — Claude Desktop, Claude Code, or a custom LLM pipeline — can search creators, score brand fit, and draft outreach emails as native tool calls.

What is MCP?

Model Context Protocol is an open standard that lets AI agents call external tools over a structured JSON-RPC interface. Instead of hand-crafting API calls, you give an agent the MCP server URL and it discovers all available tools automatically.

Connect

The MCP server runs at:

The API key authenticates the session. Alternatively, pass it as a header:Authorization: Bearer cdp_xxx

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "creator-discovery": {
      "url": "/api/mcp/sse?apiKey=cdp_your_key_here"
    }
  }
}

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows). Restart Claude Desktop after saving.

Claude Code

Add the server from your terminal:

claude mcp add creator-discovery \
  --transport sse \
  "/api/mcp/sse?apiKey=cdp_your_key_here"

Or use the project-scoped .claude/settings.json:

{
  "mcpServers": {
    "creator-discovery": {
      "type": "sse",
      "url": "/api/mcp/sse?apiKey=cdp_your_key_here"
    }
  }
}

Tools reference

The server exposes 7 tools. The agent discovers them automatically on connection.

API Keys

API keys start with cdp_ and are shown once on creation. Each key can be named and revoked individually.

Example session

Here's what a typical agent interaction looks like once connected: