Quickstart: Claude Code

Claude Code (the official CLI) talks to MCP servers natively. One command adds Pipeworx.

Install

claude mcp add pipeworx -- npx -y mcp-remote@latest https://gateway.pipeworx.io/mcp

That’s it. Open a Claude Code session in any directory, and Pipeworx tools are available.

Verify

claude mcp list
# pipeworx — connected, 1007 tools

In a session:

List my recent tools, then use Pipeworx to fetch FRED MORTGAGE30US.

Claude calls ask_pipeworx or fred_get_series and returns the live value.

Per-pack install (lighter context)

For tighter context, install one pack at a time instead of the full gateway:

claude mcp add pipeworx-fred -- npx -y mcp-remote@latest https://gateway.pipeworx.io/fred/mcp
claude mcp add pipeworx-edgar -- npx -y mcp-remote@latest https://gateway.pipeworx.io/edgar/mcp

Each pack-scoped connection only exposes that pack’s tools.

Per-task install

Or scope by task at the URL:

claude mcp add pipeworx-housing -- npx -y mcp-remote@latest "https://gateway.pipeworx.io/mcp?task=housing+market"

The gateway pre-filters to ~20 housing-relevant tools at connect time.

Update

claude mcp remove pipeworx
claude mcp add pipeworx -- npx -y mcp-remote@latest https://gateway.pipeworx.io/mcp

mcp-remote@latest re-resolves on each session start, so the underlying tool list always reflects the current gateway state.

Troubleshooting

mcp-remote not found. It’s an npx package, not a global install. The -y flag auto-confirms the download.

Connection error. Test directly:

curl -X POST https://gateway.pipeworx.io/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | head -c 500

If this fails, network/DNS — not Claude Code.

Power-user note

Claude Code reads the gateway’s serverInstructions on initialize and surfaces them to the model as a system-level briefing. So Claude already knows about ask_pipeworx, discover_tools, resolve_entity, compare_entities, and the prompt playbooks before you ask. Most agents call these without being told.