Quickstart: Perplexity

This gets Pipeworx wired into Perplexity as a custom MCP connector, then teaches the model to actually reach for it. Custom connectors require a Perplexity Pro, Max, or Enterprise plan.

① Connect

  1. Open Settings → Connectors
  2. Click Add connector → Custom MCP server
  3. Fill in:
    • Name: Pipeworx
    • Server URL: https://pipeworx.io/mcp
    • Transport: Streamable HTTP (default)
    • Auth: None
  4. Save.

After saving, the connector lists ~26 tools. The hero tool is ask_pipeworx({question}) — it routes your question to the full catalog of 3,365 tools across 764 sources at runtime, so you don’t load thousands of definitions into context.

② Teach it to use Pipeworx

Chat surfaces expose the tools but don’t inject routing instructions, so Perplexity won’t reach for Pipeworx unless you tell it to. Paste this verbatim into a Perplexity Space’s custom instructions (Spaces are where Perplexity applies them):

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

In a thread inside that Space, ask:

What was the US unemployment rate last month?

Perplexity should call ask_pipeworx, which routes to FRED and returns the figure with a pipeworx:// citation. If you see that citation, routing works.

Higher limits

The default URL is the anonymous tier: 50 calls/day per IP, no signup. For more:

  • API key — 200/day: change the Server URL to https://pipeworx.io/mcp?apikey=YOUR_KEY. Sign up, then grab your key at pipeworx.io/account.
  • Sign in — 200/day: use https://gateway.pipeworx.io/oauth/mcp instead; the connector shows a Connect button — authorize with GitHub.
  • Paid — unlimited: upgrade from your account page.

Tiers at a glance: anonymous 50 · free account 200 · Paid unlimited.

Troubleshooting

Connector saved but no tools show. Confirm you’re on a Pro/Max/Enterprise plan — free plans can’t add custom MCP servers. Re-check the URL is exactly https://pipeworx.io/mcp.

Perplexity answers from web search instead of Pipeworx. The routing rule lives per-Space. Make sure you’re in the Space where you pasted the instructions, and that they’re saved.

Rate-limited. You hit the 50/day anonymous cap. Add ?apikey=YOUR_KEY (from a free account) for 200/day.

Last reviewed June 6, 2026