Flyweel MCP Quickstart Guide

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

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?

1. A Flyweel account with your ad accounts connected
2. An AI tool that speaks MCP:
   • Claude Desktop
   • Cursor
   • VS Code (with Continue)
   • Windsurf

That’s it.

How Do I Set Up Flyweel MCP?

Three steps. Under 5 minutes.

Step 1: Get Your API Token

Your token is like a password. It lets your AI talk to Flyweel.

1. Go to app.flyweel.co
2. Click Settings
3. Click API Tokens
4. Click Create New Token
5. Give it a name (like “My Laptop”)
6. Click Generate
7. Copy it now. You won’t see it again.

Your token starts with fwl_ followed by 64 characters. Keep it safe. Don’t share it.

Step 2: Add Flyweel to Your AI Tool

Add a config file to tell your AI where Flyweel lives.

{
  "mcpServers": {
    "flyweel": {
      "url": "https://api.flyweel.co/mcp-server/mcp",
      "headers": {
        "X-API-Key": "YOUR_TOKEN_HERE"
      }
    }
  }
}

{
  "mcpServers": [
    {
      "name": "flyweel",
      "url": "https://api.flyweel.co/mcp-server/mcp",
      "headers": {
        "X-API-Key": "YOUR_TOKEN_HERE"
      }
    }
  ]
}

Step 3: Test Your Connection

Ask your AI:

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

If you see your accounts listed, it works.

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:

How Do I Check Ad Performance?

Ask about how your ads are doing:

How Do I Check Ad Spend?

Ask about where your money goes:

How Do I Compare Campaigns?

Ask your AI to compare:

How Do I Check Specific Time Periods?

You can ask about any date range:

How Do I Find Problems?

Ask your AI to spot issues:

How Do I Manage My Data?

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

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:

1. “Which campaign has the most conversions?”
2. “What’s the cost per conversion for that one?”
3. “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?

How Fresh Is My Data?

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 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 and Meta Ads only (no TikTok, LinkedIn, etc.)
• 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 and Meta Ads (Facebook and Instagram). This includes Search, Display, Shopping, PMAX, and YouTube campaigns on Google.

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:

1. The config file is in the right folder
2. The file is named exactly right (e.g., claude_desktop_config.json)
3. 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 team@flyweel.co for anything. We reply within 24 hours.

Troubleshooting

”Authentication Error” or “Invalid Token”

Your token is wrong or deleted.

Fix: Go to app.flyweel.co → Settings → API Tokens. Check if your token is there. If not, make a new one and update your config file.

”No accounts found”

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.

AI doesn’t see Flyweel

The config file is in the wrong spot or has a typo.

Fix:

1. Check the file is named exactly right
2. Check it’s in the right folder:
   • Claude (Mac): ~/Library/Application Support/Claude/
   • Claude (Windows): %APPDATA%\Claude\
   • Claude (Linux): ~/.config/Claude/
   • VS Code: ~/.continue/
3. Check for typos at jsonlint.com
4. Restart your AI tool fully (quit and reopen)

Data looks old

Fix: Go to your Flyweel dashboard. Click Sync Now on the account.

Quick Reference

Connection Details

Supported Platforms

Config File Locations

Glossary

Request a Feature

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

Get Help

Email team@flyweel.co for anything.

We reply within 24 hours.

Last updated: January 2026