stackadapt-mcp

An MCP (Model Context Protocol) server for querying StackAdapt's GraphQL API. Gives AI assistants like Claude direct access to your campaign data, delivery metrics, advertisers, and more.

Tools

Setup

Get your API key

StackAdapt API key from: StackAdapt Platform → Settings → API.

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "stackadapt": {
      "command": "npx",
      "args": ["-y", "stackadapt-mcp"],
      "env": {
        "STACKADAPT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "stackadapt": {
      "command": "npx",
      "args": ["-y", "stackadapt-mcp"],
      "env": {
        "STACKADAPT_API_KEY": "${STACKADAPT_API_KEY}"
      }
    }
  }
}

Then set the env var in your shell: export STACKADAPT_API_KEY=your-api-key-here

Data notes

A few things to know about StackAdapt's API:

• cost, ecpc, ecpm, ecpe are returned as strings — parse them as floats

• ctr is already a percentage value (0.214 means 0.214%) — don't multiply by 100

• ecpe returns "0" for periods with zero engagements

• Delivery payloads are GraphQL UNION types (Outcome | Progress) — large queries may return a Progress response with a job ID; retry after a few seconds

• Granularity options: DAILY, WEEKLY, MONTHLY, TOTAL

Development

git clone https://github.com/aymanshaikh/stackadapt-mcp.git
cd stackadapt-mcp
npm install
npm run build

To test locally, set STACKADAPT_API_KEY and run:

STACKADAPT_API_KEY=your-key node dist/index.js

License

MIT