Connect Razorpay MCP Server to Windsurf

The Windsurf Cascade agent reads MCP servers from a single configuration file. Add the Razorpay Remote MCP Server using the raw configuration editor.

Handy Tips

Windsurf requires Node.js and npm for the mcp-remote bridge. Refer to the

Remote MCP Server setup

to install Node.js and generate your Base64-encoded merchant token.

Windsurf Configuration

Open Windsurf and navigate to Windsurf Settings → Cascade → MCP Servers. You can also click the MCP icon at the top-right of the Cascade panel.
Click Manage MCPs, then click View raw config to open the mcp_config.json file.

Add the following Razorpay server entry to the file and save it:

{
  "mcpServers": {
    "rzp-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.razorpay.com/mcp",
        "--header",
        "Authorization: Basic <your-base64-encoded-key-secret>"
      ]
    }
  }
}

Return to the Manage MCPs page and click Refresh to connect to the server and fetch the Razorpay tools.

Handy Tips

The configuration file is located at ~/.codeium/windsurf/mcp_config.json on macOS and %USERPROFILE%\.codeium\windsurf\mcp_config.json on Windows. Windsurf supports global configuration only and does not interpolate environment variables, so enter the token value directly.

Need Help?

If you need any assistance with the integration, reach out to us at

agentic-payments@razorpay.com