Quickstart: Cursor

Cursor 0.45+ supports remote MCP servers via the cursor.com install redirect.

One-click install

Click the Add to Cursor button on any pack page — for example, packs/fred. The button generates a URL like:

https://cursor.com/en-US/install-mcp?name=pipeworx-fred&config=<base64>

Cursor recognizes this URL, decodes the config, and prompts you to add the server. Confirm and you’re done.

For the full gateway (all 1,007 tools), use:

https://cursor.com/en-US/install-mcp?name=pipeworx&config=eyJ1cmwiOiJodHRwczovL2dhdGV3YXkucGlwZXdvcnguaW8vbWNwIn0=

(That base64 decodes to {"url":"https://gateway.pipeworx.io/mcp"}.)

Manual install

If the click-to-install flow doesn’t work for your Cursor version:

Cursor → Settings → Cursor Settings → MCP Servers → + Add new MCP server
Name: pipeworx
Type: HTTP / Streamable
URL: https://gateway.pipeworx.io/mcp
Save

Or edit ~/.cursor/mcp.json directly:

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

Verify

Open the chat sidebar in Cursor. Type:

Use Pipeworx to look up the latest 30-year mortgage rate.

Cursor invokes ask_pipeworx (or fred_get_series directly), and returns the live FRED value.

Scope to a domain

For tighter context, scope the connection by domain:

{
  "mcpServers": {
    "pipeworx-housing": {
      "url": "https://gateway.pipeworx.io/mcp?vertical=housing"
    }
  }
}

This loads only the housing-related tools — see context tax for why this matters in Cursor specifically (Cursor sends tool definitions on every turn).

Troubleshooting

“Unable to install extension ‘anysphere.cursor-deeplink’” — your Cursor is older than 0.45. Update via Cursor → Help → Check for Updates.

Tools not showing up. Cursor Settings → MCP Servers — the entry should show a green dot. Red = connection failed; check the URL.

Want to BYO keys? Add an _apiKey arg per call (FRED, ATTOM, etc.) or set up tier-based auth — see BYO keys (coming soon).