# 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-373.adcrunch.dev/mcp/auth): How OAuth works for the MCP server, what each scope grants, what an agent can and cannot change, and how access is revoked.
- [What is MCP](https://docs.pr-373.adcrunch.dev/mcp/overview): How the Model Context Protocol lets AI agents query AdCrunch in natural language.
- [Bring your own creative](https://docs.pr-373.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-373.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-373.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-373.adcrunch.dev/mcp/recipes/drill-into-ad-group): Find the underperforming creative inside a campaign.
- [Save and run a Skill](https://docs.pr-373.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-373.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-373.adcrunch.dev/mcp/setup/claude-desktop): Install the AdCrunch MCP server in Claude Desktop and authorize your organization.
- [Claude Code](https://docs.pr-373.adcrunch.dev/mcp/setup/claude-code): Install the AdCrunch MCP server in Claude Code and authorize your organization.
- [Cursor](https://docs.pr-373.adcrunch.dev/mcp/setup/cursor): Install the AdCrunch MCP server in Cursor and authorize your organization.
- [ChatGPT](https://docs.pr-373.adcrunch.dev/mcp/setup/chatgpt): Install AdCrunch as a custom MCP connector in ChatGPT.
- [list_advertisers](https://docs.pr-373.adcrunch.dev/mcp/tools/list-advertisers): List the advertisers (ad accounts) in your organization, optionally filtered by provider.
- [list_entities](https://docs.pr-373.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-373.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-373.adcrunch.dev/mcp/tools/query-insights): Aggregate spend / impressions / clicks / conversions over a date range, by entity.
- [meta_list_pages](https://docs.pr-373.adcrunch.dev/mcp/tools/meta-list-pages): List the Facebook Pages a Meta ad account can advertise from.
- [meta_list_pixels](https://docs.pr-373.adcrunch.dev/mcp/tools/meta-list-pixels): List the Meta Pixels installed on a Meta ad account.
- [meta_create_campaign](https://docs.pr-373.adcrunch.dev/mcp/tools/meta-create-campaign): Create a Meta campaign from a conversation. It always arrives PAUSED.
- [meta_create_adset](https://docs.pr-373.adcrunch.dev/mcp/tools/meta-create-adset): Create a Meta ad set under a campaign — budget, audience, and optimization goal.
- [meta_create_creative](https://docs.pr-373.adcrunch.dev/mcp/tools/meta-create-creative): Build a Meta ad creative from media you uploaded to AdCrunch. Image and video both work.
- [meta_create_ad](https://docs.pr-373.adcrunch.dev/mcp/tools/meta-create-ad): Create a Meta ad under an ad set, using a creative that already exists. Always paused.
- [meta_set_status](https://docs.pr-373.adcrunch.dev/mcp/tools/meta-set-status): Pause, resume or archive a Meta campaign, ad set or ad on a live account. Runs asynchronously and returns a workflowId to poll.
- [meta_update_budget](https://docs.pr-373.adcrunch.dev/mcp/tools/meta-update-budget): Change a Meta campaign or ad set's daily or lifetime budget, with a safety cap and a level guardrail.
- [get_mutation_status](https://docs.pr-373.adcrunch.dev/mcp/tools/get-mutation-status): Poll a change started by a write tool and find out whether it succeeded, failed, or is still running.
- [skill_list](https://docs.pr-373.adcrunch.dev/mcp/tools/skill-list): List your organization's ad-ops playbooks (Skills) by slug, name, and description.
- [skill_get](https://docs.pr-373.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-373.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-373.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-373.adcrunch.dev/mcp/tools/skill-delete): Delete an ad-ops playbook (Skill), guarded by base_revision.
- [asset_list](https://docs.pr-373.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-373.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-373.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-373.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-373.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.
- [brand_list](https://docs.pr-373.adcrunch.dev/mcp/tools/brand-list): List your organization's brands as slug + name + description, so an agent can pick one before loading its context.
- [brand_get](https://docs.pr-373.adcrunch.dev/mcp/tools/brand-get): Fetch one brand by slug — its identity, voice, guidelines and messaging — so an agent knows who it is acting for.
- [brand_resolve](https://docs.pr-373.adcrunch.dev/mcp/tools/brand-resolve): Given an ad account, find which brands' context applies to it.
- [brand_create](https://docs.pr-373.adcrunch.dev/mcp/tools/brand-create): Create a brand in your organization. Every context section is optional — start with a name and fill it in over time.
- [brand_update](https://docs.pr-373.adcrunch.dev/mcp/tools/brand-update): Edit a brand's context, guarded by base_revision so a concurrent change can't be silently overwritten.
- [brand_attach_advertiser](https://docs.pr-373.adcrunch.dev/mcp/tools/brand-attach-advertiser): Attach an ad account to a brand, so agents can resolve brand context from the account.
- [brand_detach_advertiser](https://docs.pr-373.adcrunch.dev/mcp/tools/brand-detach-advertiser): Remove the link between an ad account and a brand, leaving the brand and its context untouched.
- [brand_delete](https://docs.pr-373.adcrunch.dev/mcp/tools/brand-delete): Delete a brand and the context authored on it, guarded by base_revision.
- [document_create_upload](https://docs.pr-373.adcrunch.dev/mcp/tools/document-create-upload): Reserve a file against a brand and get a short-lived URL to upload the bytes to.
- [document_finalize](https://docs.pr-373.adcrunch.dev/mcp/tools/document-finalize): Complete a document upload once the bytes have landed — size and type are read from the stored file, not from what you declared.
- [document_get](https://docs.pr-373.adcrunch.dev/mcp/tools/document-get): Fetch one brand document — images come back as an image the assistant can actually look at.
- [document_list](https://docs.pr-373.adcrunch.dev/mcp/tools/document-list): List the files attached to a brand, each with a URL you can fetch.
- [document_delete](https://docs.pr-373.adcrunch.dev/mcp/tools/document-delete): Delete a file attached to a brand, along with its stored bytes.

## use

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