Razorpay Remote MCP Server Setup

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

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

Run the following command on terminal:

Install Node.js

brew install node

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.

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:

Navigate to **Account & Settings** â†’ **API Keys**.

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:

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 NoticeEffective 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

Open Claude Desktop.
Navigate to Settings â†’ Developer â†’ Edit Config.
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

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:

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

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:

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:

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

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

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

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

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

Advanced Configuration: See Configuration Guide for additional options.

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

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

Overview

Webhooks

Error Codes

MCP Server

n8n Node

App Store

Razorpay Remote MCP Server Setup

Prerequisites

Step 1: Install Node.js

For Mac

For Windows

Step 2: Verify Installation

Step 3: Authenticate Razorpay Account

Generate API Keys

Encode Merchant Token

Step 4: Configure Your AI-assisted Application

Claude Desktop Configuration

Cursor Configuration

Visual Studio Code Configuration

Step 5: Restart Application

Next Steps

​Prerequisites

​Step 1: Install Node.js

​For Mac

​For Windows

​Step 2: Verify Installation

​Step 3: Authenticate Razorpay Account

​Generate API Keys

​Encode Merchant Token

​Step 4: Configure Your AI-assisted Application

​Claude Desktop Configuration

​Cursor Configuration

​Visual Studio Code Configuration

​Step 5: Restart Application

​Next Steps

Prerequisites

Step 1: Install Node.js

For Mac

For Windows

Step 2: Verify Installation

Step 3: Authenticate Razorpay Account

Generate API Keys

Encode Merchant Token

Step 4: Configure Your AI-assisted Application

Claude Desktop Configuration

Cursor Configuration

Visual Studio Code Configuration

Step 5: Restart Application

Next Steps