# 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-284.adcrunch.dev/mcp/auth): How OAuth works for the MCP server, scopes granted, token lifecycle, revocation.
- [What is MCP](https://docs.pr-284.adcrunch.dev/mcp/overview): How the Model Context Protocol lets AI agents query AdCrunch in natural language.
- [Bring your own creative](https://docs.pr-284.adcrunch.dev/mcp/assets): Upload images and video you own, then register them into an advertiser's provider-side library — from your AI agent, over MCP.
- [Top campaigns yesterday](https://docs.pr-284.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-284.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-284.adcrunch.dev/mcp/recipes/drill-into-ad-group): Find the underperforming creative inside a campaign.
- [Save and run a Skill](https://docs.pr-284.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.
- [Upload and register a creative](https://docs.pr-284.adcrunch.dev/mcp/recipes/upload-and-register-a-creative): Hand the agent a file, and it uploads it, adds it to your library, and places it in an ad account — end to end.
- [Claude Desktop](https://docs.pr-284.adcrunch.dev/mcp/setup/claude-desktop): Install the AdCrunch MCP server in Claude Desktop and authorize your organization.
- [Claude Code](https://docs.pr-284.adcrunch.dev/mcp/setup/claude-code): Install the AdCrunch MCP server in Claude Code and authorize your organization.
- [Cursor](https://docs.pr-284.adcrunch.dev/mcp/setup/cursor): Install the AdCrunch MCP server in Cursor and authorize your organization.
- [ChatGPT](https://docs.pr-284.adcrunch.dev/mcp/setup/chatgpt): Install AdCrunch as a custom MCP connector in ChatGPT.
- [list_advertisers](https://docs.pr-284.adcrunch.dev/mcp/tools/list-advertisers): List the advertisers (ad accounts) in your organization, optionally filtered by provider.
- [list_entities](https://docs.pr-284.adcrunch.dev/mcp/tools/list-entities): List ad entities (campaigns, ad sets, ad groups, ads, creatives, …) under one advertiser, filtered by type or parent.
- [get_entity](https://docs.pr-284.adcrunch.dev/mcp/tools/get-entity): Fetch the full raw provider payload for one ad entity by provider, type, and id.
- [query_insights](https://docs.pr-284.adcrunch.dev/mcp/tools/query-insights): Aggregate spend / impressions / clicks / conversions over a date range, by entity.
- [skill_list](https://docs.pr-284.adcrunch.dev/mcp/tools/skill-list): List your organization's ad-ops playbooks (Skills) by slug, name, and description.
- [skill_get](https://docs.pr-284.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-284.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-284.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-284.adcrunch.dev/mcp/tools/skill-delete): Delete an ad-ops playbook (Skill), guarded by base_revision.
- [asset_list](https://docs.pr-284.adcrunch.dev/mcp/tools/asset-list): List the source media (images and video) your organization owns, each with where it has been registered.
- [asset_get](https://docs.pr-284.adcrunch.dev/mcp/tools/asset-get): Fetch one Asset with its Registrations — where it has been placed, and how each placement went. Also how you poll a running registration.
- [asset_create_upload](https://docs.pr-284.adcrunch.dev/mcp/tools/asset-create-upload): Reserve an Asset and get a short-lived URL to upload the file to. Step one of bringing your own creative in.
- [asset_finalize](https://docs.pr-284.adcrunch.dev/mcp/tools/asset-finalize): Complete an upload after the bytes have been PUT, validate the file, and add the Asset to your library — optionally registering it in the same call.
- [asset_register](https://docs.pr-284.adcrunch.dev/mcp/tools/asset-register): Place an Asset in one advertiser's provider-side library so ads in that account can use it. Returns immediately; poll asset_get for readiness.

## use

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