About stackadapt-mcp
stackadapt-mcp is an MCP server published by aymanshaikh in the Data category: an MCP server for querying StackAdapt's GraphQL API. Gives AI assistants like Claude direct access to your campaign data, delivery metrics, advertisers, and more.
Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/aymanshaikh/stackadapt-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (8)
campaign_deliveryPull performance metrics per campaign (impressions, clicks, spend, CTR, ATOS, engagements) with date range and granularity
Parameters not published.
campaign_group_deliverySame metrics aggregated at the campaign group level
Parameters not published.
get_campaignGet detailed campaign info — targeting, budget, flight dates, ads
Parameters not published.
get_campaign_groupGet campaign group details — flights, budget, frequency caps, child campaigns
Parameters not published.
graphql_queryExecute any custom GraphQL query against the StackAdapt API
Parameters not published.
list_advertisersList advertisers on the account
Parameters not published.
list_campaign_groupsList campaign groups with advertiser info
Parameters not published.
list_campaignsList campaigns with optional filters (campaign group, advertiser)
Parameters not published.
Ask AI
Ask AI about stackadapt-mcp
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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
| Tool | Description |
|---|---|
list_campaigns |
List campaigns with optional filters (campaign group, advertiser) |
get_campaign |
Get detailed campaign info — targeting, budget, flight dates, ads |
get_campaign_group |
Get campaign group details — flights, budget, frequency caps, child campaigns |
campaign_delivery |
Pull performance metrics per campaign (impressions, clicks, spend, CTR, ATOS, engagements) with date range and granularity |
campaign_group_delivery |
Same metrics aggregated at the campaign group level |
list_advertisers |
List advertisers on the account |
list_campaign_groups |
List campaign groups with advertiser info |
graphql_query |
Execute any custom GraphQL query against the StackAdapt API |
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,ecpeare returned as strings — parse them as floatsctris already a percentage value (0.214 means 0.214%) — don't multiply by 100ecpereturns"0"for periods with zero engagements- Delivery payloads are GraphQL UNION types (
Outcome | Progress) — large queries may return aProgressresponse 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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.