Link Google, Meta, or TikTok Ads to Flyweel (plus Pipedrive if you want CRM data). Read-only on ad platforms; we never post or change an ad.
HEADLESS FINANCE FOR ADS, OVER MCP
Connect to your ad data
Flyweel MCP is a free Model Context Protocol server for Claude, ChatGPT, Cursor, and any MCP client. One connection reads 222+ metrics across , , and Ads, Pipedrive deals, and the card charges behind them, so you scale on real spend and freeze a card in seconds.
claude-cli/flyweel-mcp
Connected
WHAT IS IT
What is Flyweel MCP?
Flyweel MCP is a free Model Context Protocol server. It gives any MCP-compatible AI client 222+ extended metrics across Google, Meta, and TikTok Ads, Pipedrive CRM for deal and pipeline data, and the Flyweel Card charges that paid for the ads.
Instead of clicking through dashboards, you just ask. "Which campaign drove the most pipeline, on what the card actually paid?" Claude checks your live data, joins it to your CRM and your card charges, and tells you.
Ad platforms stay read-only. An owner or admin can freeze a card, issue one or set its budget from the same thread, and every change waits for your OK. See our headless finance for ads launch post.
Works with
Connects to
Google Ads
Meta Ads
TikTok Ads
Pipedrive CRM
Flyweel Cards US
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?"
"Which campaign has the best cost per lead on what the card actually paid?"
"Does what my Meta card was charged last month line up with what Meta says I spent?"
"Find charges on my Meta card with no matching reported spend, and draft a refund request."
"Freeze the Meta card."
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 read-only on your ad platforms and CRM, so it never posts, edits, or deletes an ad. Card tools are limited to owners and admins, scoped to one organization, and never expose a full card number or CVV. Every card change needs your confirmation first. Revoke access 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. Card data updates on each card event and is re-checked every 30 minutes.
How do I authenticate to Flyweel MCP?
Sign in with OAuth in clients that support it, such as Claude, ChatGPT, Cursor and VS Code. For CLI clients that cannot use OAuth, generate a scoped API key (fwl_ token) in Flyweel Settings and paste it into your MCP client config as an Authorization: Bearer header. Keys are 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.
Can an agent see or freeze my Flyweel cards?
Yes, if you are an owner or admin. The agent can list cards and card transactions, compare settled charges with what the ad platform reported, freeze or unfreeze a card, issue a card to an existing cardholder, and set a card budget. Each change is previewed and waits for your OK. A freeze is reversible. Cancelling a card stays in the Flyweel app. Flyweel cards are for US businesses.
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
