To connect Flyweel MCP to Raycast AI (Pro), open Extensions, then MCP Servers, then Add, and configure a remote HTTP server pointing at https://api.flyweel.co/functions/v1/mcp-server/mcp with an X-API-Key header. Raycast AI then calls Flyweel tools inline as part of any AI command.
RequirementsLink to this section
- Raycast Pro (free tier does not support MCP)
- macOS 12 or later
Step 1: Get your API tokenLink to this section
- Go to app.flyweel.co
- Open Settings → API & MCP
- Under Advanced: use an API key instead, click Generate API key (or Create Token to name your own)
- Copy the
fwl_…key once — it won’t be shown again
Step 2: Open Raycast MCP settingsLink to this section
- Open Raycast (
opt+spaceby default) - Type Extensions, then press enter
- Select the MCP Servers tab
- Click Add
Step 3: Configure FlyweelLink to this section
| Field | Value |
|---|---|
| Name | Flyweel |
| Transport | HTTP (streamable) |
| URL | https://api.flyweel.co/functions/v1/mcp-server/mcp |
| Header name | X-API-Key |
| Header value | fwl_YOUR_TOKEN_HERE |
Click Save.
Raycast stores MCP configuration in its user data (~/Library/Application Support/com.raycast.macos). You normally do not need to edit these files by hand.
Step 4: Test itLink to this section
Open Raycast’s AI Chat, enable the Flyweel tool if prompted, and ask:
What Google Ads accounts do I have connected to Flyweel?TroubleshootingLink to this section
MCP Servers tab is missingLink to this section
Raycast is out of date or not on Pro.
Fix: Update Raycast and confirm your Pro subscription at raycast.com/account.
”Authentication error”Link to this section
Token is invalid or revoked.
Fix: Regenerate at app.flyweel.co, then Settings → API & MCP.
Tools do not appear in AI ChatLink to this section
Raycast caches tool lists.
Fix: Disable and re-enable the Flyweel server in Extensions, then MCP Servers.
