Windsurf

Windsurf reads MCP servers from:

~/.codeium/windsurf/mcp_config.json

1. Index a docs site

pinax add stripe

2. Add the server entry

{
  "mcpServers": {
    "pinax": {
      "command": "pinax",
      "args": ["serve"],
    },
  },
}

The unified entry covers every manifest. Per-docs entries work too - just add the catalog name as the second arg.

JS-rendered sites

If any manifest was indexed with renderer: jina (see Configuration → JS renderer), add JINA_API_KEY to the server’s env block:

{
  "mcpServers": {
    "pinax": {
      "command": "pinax",
      "args": ["serve"],
      "env": { "JINA_API_KEY": "jina_..." },
    },
  },
}

Without it, get_page calls to SPA-indexed manifests return a RENDERER_UNAVAILABLE error.

3. Reload Windsurf

Cmd-Shift-P → “Reload Window”.

4. Use it

Open the Cascade panel. Pinax tools appear under the MCP section once the server connects.

Troubleshooting

• Windsurf’s MCP support is still evolving; if the entry doesn’t take, double-check mcp_config.json is valid JSON (no trailing commas).
• Run pinax serve --http in a terminal alongside Windsurf to watch tool calls in real time.