Razorpay Remote MCP Server Setup

The Razorpay Remote MCP Server is a hosted solution that provides zero infrastructure overhead with automatic updates and high availability. This is the recommended deployment option for most users.

Prerequisites

Before installing the Razorpay Remote MCP Server, ensure you have:

AI Assistant: Claude Desktop, Cursor, Visual Studio Code, or similar AI-assisted application.
Razorpay Account: Active Razorpay account with API access.
API Keys: Generate
Razorpay API keys
from the Dashboard.

Step 1: Install Node.js

The Remote MCP Server requires Node.js and npm. Choose the installation method for your operating system:

For Mac

Go to
nodejs.org
.
Download the LTS (Long Term Support) version.
Run the installer (.pkg file).
Follow the installation prompts.

For Windows

Go to
nodejs.org
.
Download the LTS version for Windows.
Run the installer (.msi file).
Follow the installation wizard.
Make sure to check Add to PATH during installation.

Step 2: Verify Installation

After installing Node.js, open your terminal/command prompt and verify the installation:

node --version
npm --version
npx --version

You should see version numbers for all three commands.

Step 3: Authenticate Razorpay Account

Generate API keys and create a merchant token.

Generate API Keys

Follow these steps to generate the API keys:

Log in to your
Razorpay Dashboard
.
Navigate to Account & Settings → API Keys.
Generate your API keys (Key ID and Key Secret).
Copy both the Key ID and Key Secret.

Encode Merchant Token

Encode your merchant token by running the following command in your terminal:

echo <RAZORPAY_API_KEY>:<RAZORPAY_API_SECRET> | base64
# Output: cnpwX3Rlc3RfYWJjMTIzOnNlY3JldF9kZWY0NTY=

Watch Out!

Replace <RAZORPAY_API_KEY> and <RAZORPAY_API_SECRET> with your actual credentials.

Save this base64-encoded token as you will need it for configuration.

Step 4: Configure Your AI-assisted Application

Choose your AI-assisted application and follow the corresponding configuration steps:

Claude Desktop Configuration

Open Claude Desktop.
Navigate to Settings → Developer → Edit Config.
Paste the following configuration and save the file:

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

Replace <your-base64-encoded-key-secret> with the base64 token generated in Step 3.

Cursor Configuration

Open Cursor.
Navigate to Settings → Cursor Settings.
Go to MCP tools and click Add Custom MCP (or edit existing MCP.json file).
Paste the following configuration:

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

Replace <Base64(key:secret)> with your base64-encoded token.

Visual Studio Code Configuration

Open Visual Studio Code
Open Command Palette and type Preferences: Open User Settings (JSON)
Select it from the dropdown to open the settings file
Paste the following configuration:

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "merchant_token",
        "description": "Razorpay Merchant Token",
        "password": true
      }
    ],
    "servers": {
      "razorpay-remote": {
        "command": "npx",
        "args": [
          "mcp-remote",
          "https://mcp.razorpay.com/sse",
          "--header",
          "Authorization: Bearer ${input:merchant_token}"
        ]
      }
    }
  }
}

Learn about MCP servers in VS Code's

agent mode documentation

Step 5: Restart Application

Restart your AI assistant application after adding the configuration. You should see Razorpay MCP tools become available. Test the connection by asking: Show me available Razorpay tools.

If successful, you should see a list of available Razorpay MCP tools.

Next Steps

Once your Remote MCP Server is set up:

Explore Use Cases: Review
practical examples
of AI-powered payment operations.
Learn Available Tools: Check the
Tools Reference
for complete capabilities.
Advanced Configuration: See
Configuration Guide
for additional options.
Start Building: Begin using natural language commands to interact with Razorpay APIs