Quickstart: Cursor

Wire Pipeworx into Cursor so the agent reaches for 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,802 tools across 912 sources at runtime, so you never load thousands of schemas into context.

① Connect

Easiest — one-click deeplink. Paste this in your browser (or click it from the install page) and Cursor installs the server:

cursor://anysphere.cursor-deeplink/mcp/install?name=pipeworx&config=eyJ1cmwiOiJodHRwczovL3BpcGV3b3J4LmlvL21jcCJ9

The config= blob is just base64 of {"url":"https://pipeworx.io/mcp"} — the anonymous endpoint, no auth.

Or add it to .cursor/mcp.json at your project root (native HTTP, no bridge):

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

Reload Cursor. The pipeworx entry should show a green dot in Settings → MCP.

② Teach it to use Pipeworx

If you installed via the official Pipeworx plugin, it ships a .mdc rule for you — Automatic, nothing to do.

For a manual mcp.json install, Cursor won’t route to the connector on its own. Add a .cursor/rules/pipeworx.mdc 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 the chat sidebar and ask:

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

Cursor 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 Cursor at https://gateway.pipeworx.io/oauth/mcp instead. Tiers: anonymous 50 · free account 200 · Paid unlimited.

Troubleshooting

No green dot. Check the URL for trailing commas or smart quotes. Reload Cursor after editing mcp.json.

Agent answers from memory. The rule isn’t loading. Confirm .cursor/rules/pipeworx.mdc exists and is committed, or install the official plugin.

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