Flyweel Ad-MCP (Google+Meta)

Optional — add it manually:openSettings → MCP → Add Server, give it a name, paste the server URL above, and approve access. (OAuth, no header needed.)

Optional — add it manually:open the Command Palette, runMCP: Add Server, choose an HTTP server, paste the server URL above, and approve access.

claude mcp add --transport http flyweel-mcp-server https://api.flyweel.co/functions/v1/mcp-server/mcp

“What Google Ads accounts do I have connected to Flyweel?”

If you see your accounts listed, it works.

Your key starts withfwl_followed by 64 characters. Keep it safe. Don’t share it. Manage or revoke keys anytime from the same page — toggle a key off to deactivate it, or delete it to revoke access immediately.

Paste this into your client’s MCP config file (e.g.~/.claude.json,~/.cursor/mcp.json, or a project-local.mcp.json):

"mcpServers": { "flyweel-mcp-server": { "type": "http", "url": "https://api.flyweel.co/functions/v1/mcp-server/mcp", "headers": { "Authorization": "Bearer fwl_YOUR_TOKEN_HERE" } } }

Replacefwl_YOUR_TOKEN_HEREwith your key.

- Client only accepts a custom header?ReplaceAuthorization: BearerwithX-API-Keyand drop theBearerprefix (value is just thefwl_…token).
- VS Code:save to.vscode/mcp.jsonand rename themcpServerskey toservers.

Or add it from the command line with Claude Code:

claude mcp add --transport http flyweel-mcp-server https://api.flyweel.co/functions/v1/mcp-server/mcp --header "Authorization: Bearer fwl_YOUR_TOKEN_HERE"

Just talk to your AI like you’re talking to a person. Here’s what works.

You can control syncing and which accounts you’re analyzing:

Try:“What’s my CTR and cost per conversion for my Google Search campaigns this month?”

If you have multiple accounts, say which one:

Try:“Show me campaigns in my Main Google Ads account”
- “Which campaign has the most conversions?”
- “What’s the cost per conversion for that one?”
- “How does that compare to last month?”

- “Which is better: my Search campaign or my PMAX campaign?”
- “Compare my top 3 campaigns by conversions”
- “Is my Meta or Google account more efficient?”

- “Based on this data, which campaign should I scale?”
- “Which campaign should I pause?”
- “Where am I wasting money?”

Your data syncs automatically from Google and Meta:

Need fresher data?Ask your AI: “Sync my Google Ads data” or go to your Flyweel dashboard and clickSync Now.

You can also ask “Is my data syncing?” to check progress.

It’s read-only.Your AI can look at your ads. It cannot change them.

- Pause or start campaigns
- Change budgets
- Edit your ads
- Delete anything

- One account per question (ask about each account separately)
- Daily numbers only (no hourly breakdown)
- Google Ads, Meta Ads, and TikTok Ads (public release end of April 2026). LinkedIn and X are not supported yet.
- Campaign data only (no ad creative images or audience details)
- Data refresh depends on platform (Google: 4-6 hours, Meta: 1-3 hours behind)
- 20 requests per second per token (more than enough for normal use)

Flyweel MCP tools are organization-aware.list_organizationslists every organization you belong to. Each call acts on your primary organization unless you pass anorgid. The id is membership-checked: naming an org you don’t belong to returnsNot a member of that organization.query_metricsenforces campaign view for ads data and CRM view for CRM data.select_ad_accountsrequires campaign-manage permission on the org being written.trigger_syncrequires campaign view on the target org (all four roles hold it) and is rate-limited. Connecting a platform enforces connection-manage in the OAuth flow itself. Your token acts as you, with your role, not more.

API Keys Are Secrets — Treat Them Like Passwords

If you use an API key for a headless or CLI client, the usual rules apply:

- Don’t share your key
- Don’t put it in emails or Slack
- Don’t commit it to Git or paste it into logs

Make a separate key per client and name it clearly (“Work Laptop - Claude Code”, “CI - nightly report”). If one leaks or a device is lost, deactivate or delete just that key — the others keep working.

Go toSettings → API & MCP. Toggle a key off to deactivate it, or click the trash icon to delete it. Deleting revokes access immediately.

MCP stands for Model Context Protocol. It’s a standard way for AI tools like Claude to connect to external apps and data. Think of it like a universal plug that lets your AI talk to other software.

Flyweel MCP lets you ask your AI questions about your Google Ads and Meta Ads campaigns. Instead of logging into dashboards and clicking around, you just ask in plain English and get answers with real data.

Flyweel MCP works with Claude (web & desktop), ChatGPT, Cursor, VS Code, Windsurf, Zed, and more. Any AI tool that supports MCP will work. Claude, ChatGPT, Cursor, and VS Code connect via OAuth (no API key needed).

Which ad platforms does Flyweel MCP support?

Flyweel MCP supports Google Ads, Meta Ads (Facebook and Instagram), and TikTok Ads (public release end of April 2026). That includes Search, Display, Shopping, PMAX, and YouTube on Google; Feed, Reels, and Stories on Meta; and In-Feed and Spark Ads on TikTok. Pipedrive CRM is also available for deal, pipeline, velocity, and win-rate questions.

No. Flyweel MCP is read-only. Your AI can view your ad data but cannot pause campaigns, change budgets, or edit anything. Your campaigns are completely safe.

Streamable HTTP — the current remote-MCP standard. There’s a single server URL (https://api.flyweel.co/functions/v1/mcp-server/mcp); your client handles the rest.

If you’re using the API-key fallback, your key starts withfwl_followed by 64 characters — a long string of letters and numbers. Keep it private like a password. (OAuth connections don’t use a visible key.)

Most people finish setup in under 5 minutes. For OAuth clients you just paste Flyweel’s server URL and approve access — no config file or token to manage.

Yes. Flyweel syncs your ad data to provide fast responses. Your data is encrypted and stored securely. You control when to sync and can disconnect anytime.

Yes. You can connect multiple Google Ads and Meta Ads accounts to Flyweel. When asking questions, specify which account you want to know about.

Can I choose which accounts my AI looks at?

If you’re using an API key, it’s wrong or has been deleted. Go to Flyweel → Settings → API & MCP and check the key exists and is active. If not, generate a new one and update your config file. If you connected via OAuth, disconnect and reconnect the Flyweel connector in your AI tool.

You haven’t connected your ad accounts to Flyweel yet. Go to Settings → Connections and link your Google Ads or Meta Ads accounts. Wait a minute for the first sync.

Emailteam@flyweel.cofor anything. We reply within 24 hours.

”Authentication Error” or “Invalid Token”

Your API key is wrong, inactive, or deleted.

You haven’t connected your ad accounts to Flyweel yet.

Fix:Go to Settings → Connections in Flyweel. Connect your Google Ads or Meta Ads. Wait a minute for it to sync.

On OAuth clients, the connector didn’t finish connecting. On API-key clients, the config file is in the wrong spot or has a typo.

Fix (OAuth):Reopen the Flyweel connector in your AI tool and finish the sign-in and approve step, then restart the tool.
- Check the file is named exactly right
- Check it’s in the right folder:

- Claude Code:~/.claude.json

- Cursor:~/.cursor/mcp.json
- VS Code:.vscode/mcp.json(rename themcpServerskey toservers)
- Project-local:.mcp.json

Fix:Go to your Flyweel dashboard. ClickSync Nowon the account.