Connect to AI agents

Wire AdCrunch into Claude, Cursor, and ChatGPT via the MCP server. Tool reference and recipes.

Auth & scopes

Auth & scopes — How OAuth works for the MCP server, scopes granted, token lifecycle, revocation.

Overview

What is MCP — How the Model Context Protocol lets AI agents query AdCrunch in natural language.

Recipes

Top campaigns yesterday — A one-line prompt to surface the best-spending campaigns of the previous day.
Meta vs TikTok ROAS — Side-by-side ROAS comparison across two providers for the same window.
Drill into one ad group — Find the underperforming creative inside a campaign.

Set up your AI client

Claude Desktop — Install the AdCrunch MCP server in Claude Desktop and authorize your organization.
Claude Code — Install AdCrunch in Claude Code via the MCP marketplace.
Cursor — Install the AdCrunch MCP server in Cursor.
ChatGPT — Install AdCrunch as a custom MCP connector in ChatGPT.

Tool reference

list_advertisers — List the advertisers (ad accounts) in your organization, optionally filtered by provider.
list_campaigns — List campaigns for one advertiser, optionally filtered by status or date.
list_ad_groups — List ad groups under one campaign or one advertiser.
list_ads — List ads under one ad group or one campaign.
query_insights — Aggregate spend / impressions / clicks / conversions over a date range, by entity.