Quickstart: Claude Code

This wires Pipeworx into Claude Code. 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.

① Connect

Easiest — one line, no plugin. Native HTTP transport, anonymous, no auth:

claude mcp add --transport http pipeworx https://pipeworx.io/mcp

Then restart Claude Code. That’s it.

You don’t even need to remember the command — just tell Claude Code in plain English: “Add the Pipeworx MCP server at https://pipeworx.io/mcp to your MCP servers, then I’ll restart.” It will run the claude mcp add for you.

Or install the plugin — same tools, plus a routing skill so Claude reaches for ask_pipeworx without being told, and it keeps itself current:

/plugin marketplace add pipeworx-io/claude-code-plugin
/plugin install pipeworx

Verify either way:

claude mcp list

You should see pipeworx connected.

② Teach it to use Pipeworx

Automatic — the plugin ships a routing skill that tells Claude to prefer ask_pipeworx; no manual rule needed.

(If you used claude mcp add instead of the plugin, the tools are available but the routing skill isn’t installed — install the plugin to get automatic routing.)

③ Test

In a session, ask:

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

Claude should call ask_pipeworx and answer with FRED data plus a pipeworx:// citation.

Higher limits

Anonymous is 50 calls/day per IP. To raise it:

  • Sign in (200/day): connect to https://gateway.pipeworx.io/oauth/mcp — the client shows a Connect button; authorize with GitHub.
  • API key (200/day): sign up free at pipeworx.io/signup, get your key at pipeworx.io/account, and add it to the URL:
claude mcp add --transport http pipeworx 'https://pipeworx.io/mcp?apikey=YOUR_KEY'

Tiers: anonymous 50/day · free account 200/day · Paid unlimited.

Troubleshooting

claude mcp list doesn’t show pipeworx. Re-run the claude mcp add command (and restart Claude Code), or reinstall the plugin with /plugin install pipeworx.

Claude won’t reach for the tools. Either prefix your ask with “Using Pipeworx, …”, or install the plugin — it ships a routing skill so Claude auto-routes without the prefix. The bare claude mcp add path exposes the tools but won’t auto-route.

Connection failed. Confirm the URL is exactly https://pipeworx.io/mcp and you used --transport http. (No npx / mcp-remote is needed — Claude Code speaks HTTP MCP natively.)

Last reviewed June 8, 2026