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/mcp-server/mcp with an X-API-Key header. Raycast AI then calls Flyweel tools inline as part of any AI command.
Requirements
- Raycast Pro (free tier does not support MCP)
- macOS 12 or later
Step 1: Get your API token
- Go to app.flyweel.co
- Click Settings, then API Tokens
- Click Create New Token, name it “Raycast”
- Click Generate and copy the
fwl_…token
Step 2: Open Raycast MCP settings
- Open Raycast (
opt+spaceby default) - Type Extensions, then press enter
- Select the MCP Servers tab
- Click Add
Step 3: Configure Flyweel
| Field | Value |
|---|---|
| Name | Flyweel |
| Transport | HTTP (streamable) |
| URL | https://api.flyweel.co/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 it
Open Raycast’s AI Chat, enable the Flyweel tool if prompted, and ask:
What Google Ads accounts do I have connected to Flyweel?Troubleshooting
MCP Servers tab is missing
Raycast is out of date or not on Pro.
Fix: Update Raycast and confirm your Pro subscription at raycast.com/account.
”Authentication error”
Token is invalid or revoked.
Fix: Regenerate at app.flyweel.co, then Settings, then API Tokens.
Tools do not appear in AI Chat
Raycast caches tool lists.
Fix: Disable and re-enable the Flyweel server in Extensions, then MCP Servers.
