Labsco
brandu-mos logo

Flyweel Ad-MCP (Google+Meta)

from brandu-mos

Connect your Google Ads and Meta accounts to Claude, Cursor, or any AI tool that supports MCP.

🔥🔥🔥✓ VerifiedAccount requiredNeeds API keys
#email#automation#crm#social-media#slack#git#search#maps

Connect your AI to your ads. Ask questions. Get answers.

What Flyweel’s MCP exposes

Capability Detail Platforms Google Ads, Meta Ads, TikTok Ads (public release end of April 2026) Tools 8 (get_setup_status, list_ad_accounts, connect_ad_platform, get_connection_status, select_ad_accounts, trigger_sync, get_sync_status, query_metrics) Metrics 222 extended metrics (132 Google, 67 Meta, 23 TikTok) plus the base registry CRM Pipedrive (deals, pipeline, velocity, win rate) Auth Scoped X-API-Key header (fwl_… tokens), per-key revocation Data freshness Auto-syncs when data is more than 15 minutes stale Query limits 30 metrics, 5 dimensions, 500 rows per query, 1 to 5 queries per call

What Is Flyweel MCP?

Flyweel MCP lets you talk to your ad data.

Instead of clicking through Google Ads or Meta Ads dashboards, you just ask your AI. It looks at your real numbers and tells you what’s happening.

**Think of it like this:**Your ads live in one house (Google/Meta). Your AI lives in another house (Claude/Cursor). Flyweel MCP is the phone line between them. Now they can talk.

What Do I Need to Get Started?

  • A Flyweel account with your ad accounts connected

  • An AI tool that speaks MCP. Supported today:

  • Claude Desktop, Claude Code CLI

  • ChatGPT (web, requires Developer Mode), Cursor, VS Code, Windsurf, Zed

  • Cline, Continue.dev, JetBrains AI Assistant

  • Codex CLI, Gemini CLI, Warp, Raycast

  • Any other MCP-compliant client via the mcp-remote shim

That’s it.

Available Tools

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

How Do I Check My Ad Accounts?

Start here when you first connect:

Try This What You’ll Get ”What ad accounts do I have?” All your connected Google and Meta accounts ”Show me my Google Ads accounts” Just your Google accounts ”Show me my Meta accounts” Just your Facebook/Instagram accounts ”What campaigns are running?” All active campaigns across your accounts

How Do I Check Ad Performance?

Ask about how your ads are doing:

Try This What You’ll Get ”How are my ads doing?” A summary of your campaign performance ”What’s my click-through rate?” Your CTR across campaigns ”Which campaign gets the most clicks?” Your top performer by clicks ”Show me my conversions” How many leads or sales your ads got ”What’s my cost per conversion?” How much you pay for each lead/sale

How Do I Check Ad Spend?

Ask about where your money goes:

Try This What You’ll Get ”How much did I spend this month?” Your total ad spend ”Which campaign costs the most?” Where most of your budget goes ”What’s my cost per click?” Average CPC across campaigns ”Show me spend by campaign” Breakdown of spend per campaign ”Am I over budget?” Budget vs actual spend

How Do I Compare Campaigns?

Ask your AI to compare:

Try This What You’ll Get ”Compare my Google and Meta performance” Side-by-side comparison ”Which campaign has the best CTR?” Ranking by click-through rate ”Which campaign has the lowest cost per conversion?” Your most efficient campaign ”How does this month compare to last month?” Month-over-month changes

How Do I Check Specific Time Periods?

You can ask about any date range:

Try This What You’ll Get ”Show me last week’s performance” Data from the past 7 days ”How did January go?” Data for a specific month ”Show me the last 30 days” Default view of recent performance ”What happened yesterday?” Single-day snapshot

How Do I Find Problems?

Ask your AI to spot issues:

Try This What You’ll Get ”Which campaigns are paused?” Campaigns that aren’t running ”Any campaigns with zero conversions?” Underperformers to check ”Which campaign has the highest CPC?” Where you might be overpaying ”What’s not working?” AI analysis of weak spots

How Do I Manage My Data?

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

Try This What You’ll Get ”Sync my Google Ads data” Triggers a fresh data pull from Google ”Sync my Meta data” Triggers a fresh data pull from Meta ”Is my data syncing?” Current sync status and progress ”Which accounts am I analyzing?” List of selected accounts ”Stop analyzing [account name]“ Removes an account from your queries ”Add [account name] to my analysis” Includes an account in your queries

How Do I Get Better Answers?

Be Specific

Instead of: “How are my ads?”

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

Name Your Account

If you have multiple accounts, say which one:

Instead of: “Show me my campaigns”

Try: “Show me campaigns in my Main Google Ads account”

Ask Follow-Up Questions

Start broad, then dig in:

  • “Which campaign has the most conversions?”

  • “What’s the cost per conversion for that one?”

  • “How does that compare to last month?”

Ask for Comparisons

Your AI is good at comparing things:

  • “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?”

Ask for Recommendations

Your AI can help you think:

  • “Based on this data, which campaign should I scale?”

  • “Which campaign should I pause?”

  • “Where am I wasting money?”

What Data Can I See?

Metric What It Means Clicks How many times people clicked your ad Impressions How many times your ad was shown CTR Click-through rate. Clicks ÷ impressions. Conversions Sign-ups, leads, or sales from your ads Cost How much you spent CPC Cost per click. Spend ÷ clicks. CPM Cost per 1,000 impressions CPA/CAC Cost per conversion. Spend ÷ conversions. Reach Unique people who saw your ad (Meta only) Budget How much you’ve set to spend Status Whether a campaign is on, paused, or removed

How Fresh Is My Data?

Your data syncs automatically from Google and Meta:

Platform Typical Delay Google Ads 4-6 hours behind real-time Meta Ads 1-3 hours behind real-time TikTok Ads 2-4 hours behind real-time

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

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

What Can’t Flyweel MCP Do?

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

It cannot:

  • Pause or start campaigns

  • Change budgets

  • Edit your ads

  • Delete anything

Your campaigns are safe.

Other limits:

  • 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)

How Do I Keep My Token Safe?

Your Token = Your Access

  • Don’t share your token

  • Don’t put it in emails or Slack

  • Don’t commit it to Git

One Token Per Device

Make a new token for each device. Name them clearly:

  • “Work Laptop - Claude”

  • “Home Mac - Cursor”

If you lose a device, just delete that token. The others keep working.

Delete Tokens You Don’t Use

Go to Settings → API Tokens. Click the trash icon on any token you don’t need.

Frequently Asked Questions

What is MCP?

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.

What is Flyweel MCP used for?

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.

Which AI tools work with Flyweel MCP?

Flyweel MCP works with Claude Desktop, Cursor, VS Code (with the Continue extension), and Windsurf. Any AI tool that supports MCP will work.

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.

Can Flyweel MCP change my campaigns?

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.

How do I get my Flyweel API token?

Log in to app.flyweel.co, go to Settings → API Tokens, and click Create New Token. Give it a name and click Generate. Copy the token immediately; you won’t see it again.

What does a Flyweel token look like?

Your token starts with fwl_ followed by 64 characters. It’s a long string of letters and numbers. Keep it private like a password.

How long does setup take?

Most people finish setup in under 5 minutes. You just need to create a token in Flyweel and add one config file to your AI tool.

Is my data stored on Flyweel servers?

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.

Can I use multiple ad accounts?

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?

Yes. If you have multiple accounts, you can tell your AI which ones to include or exclude from your queries. Ask “Stop analyzing [account name]” to remove one, or “Add [account name] to my analysis” to include it again.

What if I have multiple devices?

Create a separate token for each device. Name them clearly (like “Work Laptop” or “Home Mac”). If you lose a device, delete just that token. The others keep working.

How do I revoke access?

Go to Settings → API Tokens in your Flyweel dashboard. Click the trash icon next to any token to delete it. That device loses access immediately.

Why isn’t my AI seeing Flyweel?

Check three things:

  • The config file is in the right folder

  • The file is named exactly right (e.g., claude_desktop_config.json)

  • Your JSON has no typos. Validate it at jsonlint.com.

Then restart your AI tool completely.

Why do I see “Authentication Error”?

Your token is wrong or has been deleted. Go to Flyweel → Settings → API Tokens and check if your token exists. If not, create a new one and update your config file.

Why do I see “No accounts found”?

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.

How do I get help?

Email ** [email protected] ** for anything. We reply within 24 hours.

Quick Reference

Connection Details

Item Value Server URL https://api.flyweel.co/functions/v1/mcp-server/mcp Auth Header X-API-Key Token Format fwl_ + 64 characters

Supported Platforms

Platform What’s Included Google Ads Search, Display, Shopping, PMAX, YouTube Meta Ads Facebook, Instagram (Feed, Reels, Stories) TikTok Ads In-Feed, Spark Ads (public release end of April 2026) Pipedrive Deals, pipeline, velocity, win rate

Config File Locations

Tool Location Claude (Mac) ~/Library/Application Support/Claude/claude_desktop_config.json Claude (Windows) %APPDATA%\Claude\claude_desktop_config.json Claude (Linux) ~/.config/Claude/claude_desktop_config.json VS Code ~/.continue/config.json

Glossary

Word What It Means MCP Model Context Protocol. How AI tools talk to other apps. Token Your password for Flyweel. Starts with fwl_. CTR Click-through rate. Clicks ÷ impressions. CPC Cost per click. CPM Cost per 1,000 impressions. CPA/CAC Cost per acquisition/conversion.

Request a Feature

Have an idea for a tool or feature? Let us know.

0/2000

Submit Request

Get Help

Email ** [email protected] ** for anything.

We reply within 24 hours.

Last updated: January 2026