# 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.pr-107.adcrunch.dev/mcp/auth): How OAuth works for the MCP server, scopes granted, token lifecycle, revocation.
- [What is MCP](https://docs.pr-107.adcrunch.dev/mcp/overview): How the Model Context Protocol lets AI agents query AdCrunch in natural language.
- [Top campaigns yesterday](https://docs.pr-107.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.pr-107.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.pr-107.adcrunch.dev/mcp/recipes/drill-into-ad-group): Find the underperforming creative inside a campaign.
- [Save and run a Skill](https://docs.pr-107.adcrunch.dev/mcp/recipes/save-and-run-a-skill): Teach the agent a workflow once, save it as a Skill, then run it by name on any future session.
- [Claude Desktop](https://docs.pr-107.adcrunch.dev/mcp/setup/claude-desktop): Install the AdCrunch MCP server in Claude Desktop and authorize your organization.
- [Claude Code](https://docs.pr-107.adcrunch.dev/mcp/setup/claude-code): Install the AdCrunch MCP server in Claude Code and authorize your organization.
- [Cursor](https://docs.pr-107.adcrunch.dev/mcp/setup/cursor): Install the AdCrunch MCP server in Cursor and authorize your organization.
- [ChatGPT](https://docs.pr-107.adcrunch.dev/mcp/setup/chatgpt): Install AdCrunch as a custom MCP connector in ChatGPT.
- [list_advertisers](https://docs.pr-107.adcrunch.dev/mcp/tools/list-advertisers): List the advertisers (ad accounts) in your organization, optionally filtered by provider.
- [list_campaigns](https://docs.pr-107.adcrunch.dev/mcp/tools/list-campaigns): List campaigns for one advertiser, optionally filtered by status or date.
- [list_ad_groups](https://docs.pr-107.adcrunch.dev/mcp/tools/list-ad-groups): List ad groups under one campaign or one advertiser.
- [list_ads](https://docs.pr-107.adcrunch.dev/mcp/tools/list-ads): List ads under one ad group or one campaign.
- [query_insights](https://docs.pr-107.adcrunch.dev/mcp/tools/query-insights): Aggregate spend / impressions / clicks / conversions over a date range, by entity.
- [search_ads](https://docs.pr-107.adcrunch.dev/mcp/tools/search-ads): Search the shared competitor ad-library corpus with structured filters and/or a free-text semantic query.
- [request_crawl](https://docs.pr-107.adcrunch.dev/mcp/tools/request-crawl): Subscribe your organization to a Crawl Target so the AdCrunch Library starts pulling that brand or keyword.
- [skill_list](https://docs.pr-107.adcrunch.dev/mcp/tools/skill-list): List your organization's ad-ops playbooks (Skills) by slug, name, and description.
- [skill_get](https://docs.pr-107.adcrunch.dev/mcp/tools/skill-get): Fetch one ad-ops playbook (Skill) by slug, including its full instructions and current revision.
- [skill_create](https://docs.pr-107.adcrunch.dev/mcp/tools/skill-create): Create a new ad-ops playbook (Skill) in your organization from an agent session.
- [skill_update](https://docs.pr-107.adcrunch.dev/mcp/tools/skill-update): Update an ad-ops playbook (Skill), guarded by base_revision so concurrent edits aren't clobbered.
- [skill_delete](https://docs.pr-107.adcrunch.dev/mcp/tools/skill-delete): Delete an ad-ops playbook (Skill), guarded by base_revision.

## use

- [Team & roles](https://docs.pr-107.adcrunch.dev/use/account/team): Invite teammates, set roles, manage organization membership.
- [Security](https://docs.pr-107.adcrunch.dev/use/account/security): SSO, sessions, revoking provider access, audit log.
- [Connect Meta](https://docs.pr-107.adcrunch.dev/use/connect/meta): Authorize AdCrunch on a Meta ad account and pick which advertisers to sync.
- [Connect TikTok](https://docs.pr-107.adcrunch.dev/use/connect/tiktok): Authorize AdCrunch on a TikTok Ads account.
- [Getting started](https://docs.pr-107.adcrunch.dev/use/getting-started): Create your AdCrunch account, connect your first ad platform, and read your first insight.
- [Advertisers](https://docs.pr-107.adcrunch.dev/use/console/advertisers): An advertiser is one ad account on one provider. Stable ID prefix acc_.
- [Campaigns, ad groups, ads](https://docs.pr-107.adcrunch.dev/use/console/campaigns): The three nested entities under an advertiser. IDs cmp_, agp_, ad_.
- [Insights & reports](https://docs.pr-107.adcrunch.dev/use/console/insights): Daily metrics per campaign / ad group / ad. Saved views.
- [Skills](https://docs.pr-107.adcrunch.dev/use/console/skills): Ad-ops playbooks your connected AI agents can run via the AdCrunch MCP server. Manage them in the console.