MCP Cursor

Enhance your development workflow with AI-powered MCP tools and extensions for Cursor IDE.

Product

  • MCP Servers
  • Getting Started
  • Documentation
  • Open Source

Resources

  • MCP Specification
  • Cursor IDE
  • MCP GitHub
  • Contributing

Legal

  • Privacy Policy
  • Terms of Service
  • Cookie Policy
Made withfor the developer community
© 2026 MCP Cursor. All rights reserved.
MCP Logo
MCP Cursor
IntroductionMCPs
IntroductionMCPs
3D MCP Cursor Visualization
  1. Home
  2. Servers
  3. razorpay-mcp-server MCP
razorpay-mcp-server MCP Logo

razorpay-mcp-server MCP

Model Context Protocol Integration

Overview

Workflow Automation: Automate your day to day workflow using Razorpay MCP Server.

razorpay-mcp-server

Workflow Automation: Automate your day to day workflow using Razorpay MCP Server. Agentic Applications: Building AI powered tools that interact with Razorpay's payment ecosystem using this Razorpay MCP server.

Installation Instructions


README: https://github.com/razorpay/razorpay-mcp-server

Razorpay MCP Server (Official)

The Razorpay MCP Server is a Model Context Protocol (MCP) server that provides seamless integration with Razorpay APIs, enabling advanced payment processing capabilities for developers and AI tools.

Quick Start

Choose your preferred setup method:

  • Remote MCP Server - Hosted by Razorpay, no setup required
  • Local MCP Server - Run on your own infrastructure

Available Tools

Currently, the Razorpay MCP Server provides the following tools:

ToolDescriptionAPIRemote Server Support
capture_paymentChange the payment status from authorized to captured.Payment✅
fetch_paymentFetch payment details with IDPayment✅
fetch_payment_card_detailsFetch card details used for a paymentPayment✅
fetch_all_paymentsFetch all payments with filtering and paginationPayment✅
update_paymentUpdate the notes field of a paymentPayment✅
create_payment_linkCreates a new payment link (standard)Payment Link✅
create_payment_link_upiCreates a new UPI payment linkPayment Link✅
fetch_all_payment_linksFetch all the payment linksPayment Link✅
fetch_payment_linkFetch details of a payment linkPayment Link✅
send_payment_linkSend a payment link via SMS or email.Payment Link✅
update_payment_linkUpdates a new standard payment linkPayment Link✅
create_orderCreates an orderOrder✅
fetch_orderFetch order with IDOrder✅
fetch_all_ordersFetch all ordersOrder✅
update_orderUpdate an orderOrder✅
fetch_order_paymentsFetch all payments for an orderOrder✅
create_refundCreates a refundRefund❌
fetch_refundFetch refund details with IDRefund✅
fetch_all_refundsFetch all refundsRefund✅
update_refundUpdate refund notes with IDRefund✅
fetch_multiple_refunds_for_paymentFetch multiple refunds for a paymentRefund✅
fetch_specific_refund_for_paymentFetch a specific refund for a paymentRefund✅
create_qr_codeCreates a QR CodeQR Code✅
fetch_qr_codeFetch QR Code with IDQR Code✅
fetch_all_qr_codesFetch all QR CodesQR Code✅
fetch_qr_codes_by_customer_idFetch QR Codes with Customer IDQR Code✅
fetch_qr_codes_by_payment_idFetch QR Codes with Payment IDQR Code✅
fetch_payments_for_qr_codeFetch Payments for a QR CodeQR Code✅
close_qr_codeCloses a QR CodeQR Code❌
fetch_all_settlementsFetch all settlementsSettlement✅
fetch_settlement_with_idFetch settlement detailsSettlement✅
fetch_settlement_recon_detailsFetch settlement reconciliation reportSettlement✅
create_instant_settlementCreate an instant settlementSettlement❌
fetch_all_instant_settlementsFetch all instant settlementsSettlement✅
fetch_instant_settlement_with_idFetch instant settlement with IDSettlement✅
fetch_all_payoutsFetch all payout details with A/c numberPayout✅
fetch_payout_by_idFetch the payout details with payout IDPayout✅

Use Cases

  • Workflow Automation: Automate your day to day workflow using Razorpay MCP Server.
  • Agentic Applications: Building AI powered tools that interact with Razorpay's payment ecosystem using this Razorpay MCP server.

Remote MCP Server (Recommended)

The Remote MCP Server is hosted by Razorpay and provides instant access to Razorpay APIs without any local setup. This is the recommended approach for most users.

Benefits of Remote MCP Server

  • Zero Setup: No need to install Docker, Go, or manage local infrastructure
  • Always Updated: Automatically stays updated with the latest features and security patches
  • High Availability: Backed by Razorpay's robust infrastructure with 99.9% uptime
  • Reduced Latency: Optimized routing and caching for faster API responses
  • Enhanced Security: Secure token-based authentication with automatic token rotation
  • No Maintenance: No need to worry about updates, patches, or server maintenance

Prerequisites

npx is needed to use mcp server. You need to have Node.js installed on your system, which includes both npm (Node Package Manager) and npx (Node Package Execute) by default:

macOS

# Install Node.js (which includes npm and npx) using Homebrew
brew install node

# Alternatively, download from https://nodejs.org/

Windows

# Install Node.js (which includes npm and npx) using Chocolatey
choco install nodejs

# Alternatively, download from https://nodejs.org/

Verify Installation

npx --version

Usage with Cursor

Inside your cursor settings in MCP, add this config.

{
  "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 key & secret with your Razorpay API KEY & API SECRET

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "rzp-sse-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.razorpay.com/sse",
        "--header",
        "Authorization: Bearer <Merchant Token>"
      ]
    }
  }
}

Replace <Merchant Token> with your Razorpay merchant token. Check Authentication section for steps to generate token.

  • Learn about how to configure MCP servers in Claude desktop: Link
  • How to install Claude Desktop: Link

Usage with VS Code

Add the following to your VS Code settings (JSON):

{
  "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 more about MCP servers in VS Code's agent mode documentation.

Authentication

The Remote MCP Server uses merchant token-based authentication. To generate your merchant token:

  1. Go to the Razorpay Dashboard and navigate to Settings > API Keys

  2. Locate your API Key and API Secret:

    • API Key is visible on the dashboard
    • API Secret is generated only once when you first create it. Important: Do not generate a new secret if you already have one
  3. Generate your merchant token by running this command in your terminal:

    echo <RAZORPAY_API_KEY>:<RAZORPAY_API_SECRET> | base64
    

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

  4. Copy the base64-encoded output - this is your merchant token for the Remote MCP Server

Note: For local MCP Server deployment, you can use the API Key and Secret directly without generating a merchant token.

Local MCP Server

For users who prefer to run the MCP server on their own infrastructure or need access to all tools (including those restricted in the remote server), you can deploy the server locally.

Prerequisites

  • Docker
  • Golang (Go)
  • Git

To run the Razorpay MCP server, use one of the following methods:

Using Public Docker Image (Recommended)

You can use the public Razorpay image directly. No need to build anything yourself - just copy-paste the configurations below and make sure Docker is already installed.

Note: To use a specific version instead of the latest, replace razorpay/mcp with razorpay/mcp:v1.0.0 (or your desired version tag) in the configurations below. Available tags can be found on Docker Hub.

Usage with Claude Desktop

This will use the public razorpay image

Add the following to your claude_desktop_config.json:

{
    "mcpServers": {
        "razorpay-mcp-server": {
            "command": "docker",
            "args": [
                "run",
                "--rm",
                "-i",
                "-e",
                "RAZORPAY_KEY_ID",
                "-e",
                "RAZORPAY_KEY_SECRET",
                "razorpay/mcp"
            ],
            "env": {
                "RAZORPAY_KEY_ID": "your_razorpay_key_id",
                "RAZORPAY_KEY_SECRET": "your_razorpay_key_secret"
            }
        }
    }
}

Please replace the your_razorpay_key_id and your_razorpay_key_secret with your keys.

  • Learn about how to configure MCP servers in Claude desktop: Link
  • How to install Claude Desktop: Link

Usage with VS Code

Add the following to your VS Code settings (JSON):

{
    "mcpServers": {
        "razorpay-mcp-server": {
            "command": "docker",
            "args": [
                "run",
                "--rm",
                "-i",
                "-e",
                "RAZORPAY_KEY_ID",
                "-e",
                "RAZORPAY_KEY_SECRET",
                "razorpay/mcp"
            ],
            "env": {
                "RAZORPAY_KEY_ID": "your_razorpay_key_id",
                "RAZORPAY_KEY_SECRET": "your_razorpay_key_secret"
            }
        }
    }
}

Please replace the your_razorpay_key_id and your_razorpay_key_secret with your keys.

  • Learn about how to configure MCP servers in Claude desktop: Link
  • How to install Claude Desktop: Link

Usage with VS Code

Add the following to your VS Code settings (JSON):

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "razorpay_key_id",
        "description": "Razorpay Key ID",
        "password": false
      },
      {
        "type": "promptString",
        "id": "razorpay_key_secret",
        "description": "Razorpay Key Secret",
        "password": true
      }
    ],
    "servers": {
      "razorpay": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "RAZORPAY_KEY_ID",
          "-e",
          "RAZORPAY_KEY_SECRET",
          "razorpay/mcp"
        ],
        "env": {
          "RAZORPAY_KEY_ID": "${input:razorpay_key_id}",
          "RAZORPAY_KEY_SECRET": "${input:razorpay_key_secret}"
        }
      }
    }
  }
}

Learn more about MCP servers in VS Code's agent mode documentation.

Build from Docker (Alternative)

You need to clone the Github repo and build the image for Razorpay MCP Server using docker. Do make sure docker is installed and running in your system.

# Run the server
git clone https://github.com/razorpay/razorpay-mcp-server.git
cd razorpay-mcp-server
docker build -t razorpay-mcp-server:latest .

Once the razorpay-mcp-server:latest docker image is built, you can replace the public image(razorpay/mcp) with it in the above configurations.

Build from source

You can directly build from the source instead of using docker by following these steps:

# Clone the repository
git clone https://github.com/razorpay/razorpay-mcp-server.git
cd razorpay-mcp-server

# Build the binary
go build -o razorpay-mcp-server ./cmd/razorpay-mcp-server

Once the build is ready, you need to specify the path to the binary executable in the command option. Here's an example for VS Code settings:

{
  "razorpay": {
    "command": "/path/to/razorpay-mcp-server",
    "args": ["stdio","--log-file=/path/to/rzp-mcp.log"],
    "env": {
      "RAZORPAY_KEY_ID": "<YOUR_ID>",
      "RAZORPAY_KEY_SECRET" : "<YOUR_SECRET>"
    }
  }
}

Configuration

The server requires the following configuration:

  • RAZORPAY_KEY_ID: Your Razorpay API key ID
  • RAZORPAY_KEY_SECRET: Your Razorpay API key secret
  • LOG_FILE (optional): Path to log file for server logs
  • TOOLSETS (optional): Comma-separated list of toolsets to enable (default: "all")
  • READ_ONLY (optional): Run server in read-only mode (default: false)

Command Line Flags

The server supports the following command line flags:

  • --key or -k: Your Razorpay API key ID
  • --secret or -s: Your Razorpay API key secret
  • --log-file or -l: Path to log file
  • --toolsets or -t: Comma-separated list of toolsets to enable
  • --read-only: Run server in read-only mode

Debugging the Server

You can use the standard Go debugging tools to troubleshoot issues with the server. Log files can be specified using the --log-file flag (defaults to ./logs)

License

This project is licensed under the terms of the MIT open source license. Please refer to LICENSE for the full terms.

Featured MCPs

Github MCP - Model Context Protocol for Cursor IDE

Github

This server provides integration with Github's issue tracking system through MCP, allowing LLMs to interact with Github issues.

Sequential Thinking MCP - Model Context Protocol for Cursor IDE

Sequential Thinking

An MCP server implementation that provides a tool for dynamic and reflective problem-solving through a structured thinking process. Break down complex problems into manageable steps, revise and refine thoughts as understanding deepens, and branch into alternative paths of reasoning.

Puppeteer MCP - Model Context Protocol for Cursor IDE

Puppeteer

A Model Context Protocol server that provides browser automation capabilities using Puppeteer. This server enables LLMs to interact with web pages, take screenshots, execute JavaScript, and perform various browser-based operations in a real browser environment.