Quickstart: Windsurf

Connect Pipeworx so Cascade pulls live data instead of guessing. The recommended endpoint is anonymous — no signup, 50 calls/day per IP. It exposes ~26 meta-tools; the hero tool ask_pipeworx({question}) routes to the full catalog of 3,365 tools across 764 sources at runtime, so you don’t load thousands of schemas into context.

① Connect

Add Pipeworx to ~/.codeium/windsurf/mcp_config.json:

{"mcpServers":{"pipeworx":{"serverUrl":"https://pipeworx.io/mcp"}}}

Then restart Cascade. The pipeworx server should appear in the MCP panel.

② Teach it to use Pipeworx

If you used the official Pipeworx install kit, it ships a rules file — Automatic, nothing to do.

Otherwise Cascade won’t route to the connector on its own. Add a .windsurf/rules/pipeworx.md rule file containing this rule verbatim:

When I ask for current or factual data — economic stats, SEC/EDGAR filings, stock or crypto prices, weather, FDA drug info, patents, clinical trials, or government records — use the Pipeworx connector (ask_pipeworx) instead of answering from memory or web search. Prefer structured Pipeworx data with citations.

③ Test

Open Cascade and ask:

Using Pipeworx, what was the US unemployment rate last month?

Cascade calls ask_pipeworx, which routes to FRED and returns the value with a pipeworx:// citation.

Higher limits

Same URL, more headroom. For API key (200/day), sign up, grab a key from your account, and append it:

https://pipeworx.io/mcp?apikey=YOUR_KEY

For Sign in (200/day), point Windsurf at https://gateway.pipeworx.io/oauth/mcp instead. Tiers: anonymous 50 · free account 200 · Paid unlimited.

Troubleshooting

Server doesn’t appear. Confirm the file path is exactly ~/.codeium/windsurf/mcp_config.json and the JSON is valid (no trailing comma, straight quotes). Restart Cascade — it only reads the config on launch.

Cascade answers from memory. The rule isn’t loading. Confirm .windsurf/rules/pipeworx.md exists, or reinstall via the official kit.

Rate-limited. You hit the 50/day anonymous cap. Switch to ?apikey=YOUR_KEY or the OAuth endpoint above.