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.
• Authentication: Generate Razorpay API keys from the Dashboard. Alternatively, you can use OAuth.

Step 1: Install Node.js

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

For Mac

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

Run the following command on terminal:

Install Node.js

brew install node

For Windows

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

Run the following command:

Install Node.js

choco install nodejs

Run the following command:

Install Node.js

winget install OpenJS.NodeJS

Step 2: Verify Installation

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

Verify 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:

1. Log in to your [Razorpay Dashboard](https://dashboard.razorpay.com/).

   Log in to your Razorpay Dashboard.

2. Navigate to **Account & Settings** → **API Keys**.

   Navigate to Account & Settings → API Keys.

3. Generate your API keys (Key ID and Key Secret).

   Generate your API keys (Key ID and Key Secret).

4. Copy both the 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:

Encode Merchant Token

echo : | base64
# Output: cnpwX3Rlc3RfYWJjMTIzOnNlY3JldF9kZWY0NTY=

Watch Out!

Replace and 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.

Deprecation Notice

Effective August 13, 2025, the endpoint https://mcp.razorpay.com/sse is deprecated and replaced by https://mcp.razorpay.com/mcp, which supports streamable HTTP responses for improved performance. Update your integrations immediately to avoid service disruptions. Refer to the changelog.

Claude Desktop Configuration

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

Claude Desktop Configuration

{
  "mcpServers": {
    "rzp-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.razorpay.com/mcp",
        "--header",
        "Authorization: Basic "
      ]
    }
  }
}

Replace “ with the base64 token generated in Step 3.

Cursor Configuration

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

Cursor Configuration

{
  "mcpServers": {
    "rzp-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.razorpay.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Basic "
      }
    }
  }
}

Replace “ with your base64-encoded token.

Visual Studio Code Configuration

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

Visual Studio Code 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/mcp",
          "--header",
          "Authorization: Basic ${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:

1. **Explore Use Cases**: Review [practical examples](/mcp-server/use-...

   Explore Use Cases: Review practical examples of AI-powered payment operations.

2. **Learn Available Tools**: Check the [Tools Reference](/mcp-server/...

   Learn Available Tools: Check the Tools Reference for complete capabilities.

3. **Advanced Configuration**: See [Configuration Guide](/mcp-server/c...

   Advanced Configuration: See Configuration Guide for additional options.

4. **Start Building**: Begin using natural language commands to intera...

   Start Building: Begin using natural language commands to interact with Razorpay APIs