# AdCrunch Documentation

> AdCrunch connects your ad platforms to AI agents. Documentation for end users, MCP integrators, and REST API consumers.

## mcp

- [Auth & scopes](https://docs.adcrunch.dev/mcp/auth): How OAuth works for the MCP server, scopes granted, token lifecycle, revocation.
- [What is MCP](https://docs.adcrunch.dev/mcp/overview): How the Model Context Protocol lets AI agents query AdCrunch in natural language.
- [Top campaigns yesterday](https://docs.adcrunch.dev/mcp/recipes/top-campaigns-yesterday): A one-line prompt to surface the best-spending campaigns of the previous day.
- [Meta vs TikTok ROAS](https://docs.adcrunch.dev/mcp/recipes/meta-vs-tiktok-roas): Side-by-side ROAS comparison across two providers for the same window.
- [Drill into one ad group](https://docs.adcrunch.dev/mcp/recipes/drill-into-ad-group): Find the underperforming creative inside a campaign.
- [Claude Desktop](https://docs.adcrunch.dev/mcp/setup/claude-desktop): Install the AdCrunch MCP server in Claude Desktop and authorize your organization.
- [Claude Code](https://docs.adcrunch.dev/mcp/setup/claude-code): Install AdCrunch in Claude Code via the MCP marketplace.
- [Cursor](https://docs.adcrunch.dev/mcp/setup/cursor): Install the AdCrunch MCP server in Cursor.
- [ChatGPT](https://docs.adcrunch.dev/mcp/setup/chatgpt): Install AdCrunch as a custom MCP connector in ChatGPT.
- [list_advertisers](https://docs.adcrunch.dev/mcp/tools/list-advertisers): List the advertisers (ad accounts) in your organization, optionally filtered by provider.
- [list_campaigns](https://docs.adcrunch.dev/mcp/tools/list-campaigns): List campaigns for one advertiser, optionally filtered by status or date.
- [list_ad_groups](https://docs.adcrunch.dev/mcp/tools/list-ad-groups): List ad groups under one campaign or one advertiser.
- [list_ads](https://docs.adcrunch.dev/mcp/tools/list-ads): List ads under one ad group or one campaign.
- [query_insights](https://docs.adcrunch.dev/mcp/tools/query-insights): Aggregate spend / impressions / clicks / conversions over a date range, by entity.

## use

- [Team & roles](https://docs.adcrunch.dev/use/account/team): Invite teammates, set roles, manage organization membership.
- [Security](https://docs.adcrunch.dev/use/account/security): SSO, sessions, revoking provider access, audit log.
- [Connect Meta](https://docs.adcrunch.dev/use/connect/meta): Authorize AdCrunch on a Meta ad account and pick which advertisers to sync.
- [Connect TikTok](https://docs.adcrunch.dev/use/connect/tiktok): Authorize AdCrunch on a TikTok Ads account.
- [Connect X](https://docs.adcrunch.dev/use/connect/x): Authorize AdCrunch on an X (Twitter) Ads account.
- [Connect Snapchat](https://docs.adcrunch.dev/use/connect/snapchat): Authorize AdCrunch on a Snapchat Ads account.
- [Getting started](https://docs.adcrunch.dev/use/getting-started): Create your AdCrunch account, connect your first ad platform, and read your first insight.
- [Advertisers](https://docs.adcrunch.dev/use/console/advertisers): An advertiser is one ad account on one provider. Stable ID prefix acc_.
- [Campaigns, ad groups, ads](https://docs.adcrunch.dev/use/console/campaigns): The three nested entities under an advertiser. IDs cmp_, agp_, ad_.
- [Insights & reports](https://docs.adcrunch.dev/use/console/insights): Daily metrics per campaign / ad group / ad. Saved views.