Connect Razorpay MCP Server to Cursor

Cursor connects to the Razorpay Remote MCP Server through the mcp-remote bridge. You can add it from Cursor Settings, or by editing the MCP configuration file directly.

Handy Tips

Cursor 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.

Cursor Configuration

Open Cursor and navigate to Settings → Cursor Settings.
Go to MCP Tools and click Add Custom MCP. This opens your mcp.json file.

Paste the following configuration and save the file:

{
  "mcpServers": {
    "rzp-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.razorpay.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Basic <Base64(key:secret)>"
      }
    }
  }
}

Replace <Base64(key:secret)> with your Base64-encoded token.
Cursor starts the server and lists the available Razorpay tools, which confirms a successful connection.

Handy Tips

The .cursor/mcp.json file in a repository root applies to that project only, while ~/.cursor/mcp.json applies globally. If both files define the server, the project configuration takes precedence.

Video Walkthrough

Watch this video to see how to set up the Razorpay MCP Server in the Cursor agent.

Watch this video to see how to configure the Razorpay MCP Server in the Cursor CLI.

Need Help?

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

agentic-payments@razorpay.com