Link Google, Meta, or TikTok Ads to Flyweel (plus Pipedrive if you want CRM data). Read-only access; we never post or change anything.
LABS: MODEL CONTEXT PROTOCOL FOR ADS
Connect to your ad data
Flyweel MCP is a free, read-only Model Context Protocol server that lets Claude, ChatGPT, Cursor, and any MCP client query 222+ metrics across , , and Ads, plus Pipedrive CRM, using 8 tools authenticated by a scoped X-API-Key.
Free. Unlimited usage.
claude-cli/flyweel-mcp
Connected
WHAT IS IT
What is Flyweel MCP?
Flyweel MCP is a free, read-only Model Context Protocol server. It gives 8 tools and 222 extended metrics across Google, Meta, and TikTok Ads to any MCP-compatible AI client, plus Pipedrive CRM for deal and pipeline data.
Instead of clicking through dashboards, you just ask. "Which campaign drove the most pipeline?" Claude checks your live data, joins it to your CRM, and tells you.
Works with
Connects to
Google Ads
Meta Ads
TikTok Ads
Pipedrive CRM Three steps to connect
Drop the config into Claude Desktop, Cursor, ChatGPT, Zed, Codex CLI, or any MCP client. 30 seconds or less.
Type: "What's my CTR this month?" Claude fetches live data and answers instantly.
EXAMPLE QUERIES
Prompts to try with Flyweel MCP
"What Google, Meta, and TikTok accounts do I have?"
"Show me my Meta campaigns."
"Which accounts are active?"
"What's my CTR this month across Google, Meta, and TikTok?"
"Best campaign by clicks?"
"Which campaign has the lowest CPA?"
"How much did I spend last week?"
"Show spend by platform."
"Compare Google, Meta, and TikTok costs."
"Show me ROAS by campaign."
"Which campaigns have the best conversion value?"
"What's my cost per conversion this month?"
Pipedrive is live. CRM-tied metrics work the same as ad metrics, just ask.
"Which Google Ads campaigns drove the most Pipedrive pipeline last month?"
"What's the win rate on deals sourced from Meta Ads this quarter?"
"Show average deal size by ad platform for deals closed in Q1 2026."
"Which Pipedrive stage has the most stuck deals from paid traffic?"
FAQ MCP Questions
MCP Questions
& Answers
How much does Flyweel MCP cost?
Free. Unlimited queries, no credit card, no trial. The MCP server and every tool it exposes are included with any Flyweel account.
Which ad platforms does Flyweel MCP connect to?
Google Ads, Meta Ads (Facebook and Instagram), and TikTok Ads. Pipedrive CRM is also supported for deal, pipeline, velocity, and win-rate questions.
How long does setup take?
Under 2 minutes. Drop one config block into your AI client (Claude Desktop, Cursor, ChatGPT, Zed, Codex, Gemini CLI, or any MCP client), paste your fwl_ token, and ask your first question.
Is my data safe?
Yes. Flyweel MCP is strictly read-only, so it never posts, edits, or deletes anything on your ad platforms. Authenticate with a scoped X-API-Key (fwl_ token) and revoke it anytime from Flyweel settings.
How many metrics can I query?
222 extended metrics (132 Google, 67 Meta, 23 TikTok) on top of the base registry. A single query can request up to 30 metrics, 5 dimensions, and 500 rows, with 1 to 5 correlated queries per request.
Which AI clients are supported?
Claude (Desktop, Web, Code CLI), ChatGPT (web), Cursor, VS Code, Windsurf, Zed, Cline, Continue.dev, JetBrains AI, Codex CLI, Gemini CLI, Warp, Raycast, and any MCP-compliant client via the mcp-remote shim. See the docs for per-client setup.
How fresh is the data?
Flyweel auto-syncs when data is more than 15 minutes stale. Google Ads typically runs 4 to 6 hours behind the platform, Meta runs 1 to 3 hours behind, and TikTok runs 2 to 4 hours behind. You can also trigger a sync manually.
How do I authenticate to Flyweel MCP?
Generate a scoped X-API-Key (fwl_ token) in Flyweel Settings, then paste it into your MCP client config as an X-API-Key header. Tokens are per-client, per-device, and revocable anytime from Flyweel Settings.
Can I ask about CRM deals, not just ad metrics?
Yes. Connect Pipedrive in Flyweel and the same query_metrics tool joins ad performance to pipeline, deal velocity, win rate, and revenue attributed to any Google, Meta, or TikTok campaign.
What about LinkedIn Ads or X Ads?
Not supported yet. Google, Meta, and TikTok only as of May 2026. Follow the changelog at flyweel.co/changelogs for platform additions.
How do I get help?
Email team@flyweel.co (24-hour response) or check the full docs at flyweel.co/docs/mcp/setup for per-client install guides and troubleshooting.
What if I need help? Email team@flyweel.co. We reply within 24 hours. You can also check our documentation for setup guides.
Start Free
Get your free API key
Connect your ads. Ask Claude.
Get your free API token
No credit card required
