Flyweel MCP

Installation

OAuth / supported clients

Paste the server URL into a supported MCP client and approve access: https://api.flyweel.co/functions/v1/mcp-server/mcp

Supported clients documented by Flyweel include Claude (web and desktop), ChatGPT, Cursor, VS Code, Windsurf, Zed, Cline, Continue.dev, JetBrains AI, Codex CLI, Gemini CLI, Warp, Raycast, and other MCP-compliant clients.

Claude Code CLI

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

API-key fallback for headless or CLI clients

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

Configuration

• OAuth is the recommended path for Claude, ChatGPT, Cursor, and VS Code.
• API keys are for headless or CLI clients that cannot use OAuth.
• Flyweel API keys start with fwl_ and are managed in Flyweel Settings -> API & MCP.
• ChatGPT connectors require Developer Mode.

Capabilities

• 8 tools: get_setup_status, list_ad_accounts, connect_ad_platform, get_connection_status, select_ad_accounts, trigger_sync, get_sync_status, query_metrics
• 222 extended metrics across Google, Meta, and TikTok Ads
• Pipedrive CRM support for deals, pipeline, velocity, and win-rate questions
• Read-only access to ad data and organization-aware permissions
• Supports sync status checks and manual sync triggers

Limitations

• Read-only: it cannot pause campaigns, change budgets, edit ads, or delete anything.
• Daily numbers only; no hourly breakdown.
• One account per question.
• Campaign data only; no ad creative images or audience details.
• LinkedIn and X are not supported yet.
• Data freshness varies by platform: Google Ads 4-6 hours, Meta Ads 1-3 hours, TikTok Ads 2-4 hours behind real time.
• Rate limit documented at 20 requests per second per token.
• OAuth clients can connect without an API key; API keys are only needed for headless or CLI use.