Skip to content

Windsurf 402MCP.org — HTTP 402 & Agent Payment Registry Prompt/handle_402_response

How to: Windsurf 402MCP.org — HTTP 402 & Agent Payment Registry handle_402_response

client:Windsurf transport:streamable-http prompt:handle_402_response

Add 402MCP.org — HTTP 402 & Agent Payment Registry to Windsurf

  1. 01

    Open ~/.codeium/windsurf/mcp_config.json and merge this in. Keep any servers already there.

{
  "mcpServers": {
    "registry": {
      "serverUrl": "https://402mcp.org/api/v1/mcp"
    }
  }
}
  1. 02

    Save the file and restart Windsurf.

  2. 03

    handle_402_response is surfaced in the client's prompt or command menu. Unlike a tool, you invoke it deliberately — Windsurf will not call it for you.

  3. 04

    If it does not appear, check that 402MCP.org — HTTP 402 & Agent Payment Registry is connected and that you are looking at its prompts rather than its tools.

Global only — Windsurf has no per-project MCP config. Refresh Cascade after saving. Windsurf docs

Set these first

402MCP.org — HTTP 402 & Agent Payment Registry will not start until these are set, so it never reaches Windsurf.

  • MCP_402_OFFLINE

Same prompt, other clients

Read from the server itself, by connecting to it and calling prompts/list on 16 October 2026. A listing does not declare its prompts, so asking is the only way to know them, and this is what the server actually offers rather than what its listing claims. Names only are stored; connect the server for each prompt's arguments.