AdCrunch MCP server
Commit Oct 14, 2026Query Meta, TikTok, and Google Ads performance and campaign setup using natural language through an AI client.
Also known as adcrunchdev/mcp, mcp
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.2
- Last commit
- Oct 14, 2026
- License
- —
What is AdCrunch MCP?
AdCrunch queries Meta, TikTok, and Google Ads performance and campaign setup using natural language through an AI client.
Summary generated from the project's README
About AdCrunch MCP server
AdCrunch provides a remote connection between AI clients and major advertising platforms including Meta Ads, TikTok Ads, and Google Ads. It allows users to query campaign setup and performance metrics using natural language instead of navigating complex dashboards. This server works with Claude Desktop, Claude.ai, Claude Code, and ChatGPT by adding a custom connector via the provided server URL.
Users connect by authorizing their AdCrunch account through OAuth, which ensures that credentials remain hidden from the AI model. The service is currently available for free during an early access period without requiring a credit card. Developers can integrate it into their workflows using the specific plugin command for Claude Code or by configuring the connector settings in web-based AI interfaces.
What you can do with it
- 1Analyze campaign profitabilityAsk the AI to identify which specific campaign achieved the highest return on ad spend over a thirty day period.
- 2Compare platform efficiencyRequest a comparison of spending efficiency between TikTok and Meta for a specific two week window.
- 3Identify high cost ad setsFind the ad set with the highest cost per acquisition this month and retrieve its associated creative assets.
Written from the project's README. Every use case is checked against a quote from it.
How to install AdCrunch MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall AdCrunch MCP in Claude Code
$ claude mcp add --transport http mcp https://mcp.adcrunch.dev/mcpInstall AdCrunch MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.adcrunch.dev/mcp"
}
}
}Install AdCrunch MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.adcrunch.dev/mcp"
}
}
}Install AdCrunch MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://mcp.adcrunch.dev/mcp"}'Install AdCrunch MCP in Codex
$ codex mcp add mcp --url https://mcp.adcrunch.dev/mcpInstall AdCrunch MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] url = "https://mcp.adcrunch.dev/mcp"
Install AdCrunch MCP in Gemini CLI
$ gemini mcp add -s user --transport http mcp https://mcp.adcrunch.dev/mcpInstall AdCrunch MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.adcrunch.dev/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableadcrunchdev/mcp is public and reachablegithub.com/adcrunchdev/mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-10-14github.com/adcrunchdev/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubAdCrunch MCP Server
Ask AI about your ads. AdCrunch is a remote MCP server that connects Meta Ads, TikTok Ads, and Google Ads to Claude and ChatGPT — query campaign setup and performance in natural language, no dashboards needed.
- Server URL:
https://mcp.adcrunch.dev/mcp(streamable HTTP, OAuth) - Website: adcrunch.dev
- Docs: docs.adcrunch.dev
- Security: credentials are never exposed to the AI model.
Free during early access — no credit card. Pricing.
Connect
Claude (claude.ai / Claude Desktop)
Settings → Connectors → Add custom connector → https://mcp.adcrunch.dev/mcp, then authorize with your AdCrunch account.
Claude Code
Install the AdCrunch plugin from this repository:
/plugin install adcrunch --marketplace adcrunchdev/mcp
Then run /mcp, select adcrunch, and authorize with your AdCrunch account.
ChatGPT
Settings → Connectors → Add custom connector → https://mcp.adcrunch.dev/mcp.
Full per-client guides: docs.adcrunch.dev.
Tools
Every tool, with its inputs and its outputs, is in the tool reference.
Example questions
- "Which campaign had the best ROAS in the last 30 days?"
- "Compare TikTok vs Meta spend efficiency for the last 14 days"
- "Which ad set has the highest CPA this month — and show its creative"
This repository hosts documentation for connecting to the AdCrunch MCP server. The service itself is hosted at adcrunch.dev.
AdCrunch MCP questions
How do I add AdCrunch MCP to Claude Code?
Run claude mcp add --transport http mcp https://mcp.adcrunch.dev/mcp in your terminal. Add --scope user to make it available in every project.
How do I add AdCrunch MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Can I use AdCrunch with Claude Code?
Yes, you can install the AdCrunch plugin using the marketplace command and then authorize it via the /mcp command.
Is there a cost to use AdCrunch?
The service is free during its early access period and does not require a credit card.
Are my credentials safe?
Yes, the server is designed so that credentials are never exposed to the AI model.