English Français العربية

io.github.indiamcp/razorpay

Official registry Other

MCP server for Razorpay API.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @indiamcp/razorpay-mcp
Claude Code 
claude mcp add razorpay -e 'RAZORPAY_KEY_ID=<RAZORPAY_KEY_ID>' -e 'RAZORPAY_KEY_SECRET=<your razorpay_key_secret>' -- npx -y @indiamcp/razorpay-mcp@0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "razorpay": {
            "command": "npx",
            "args": [
                "-y",
                "@indiamcp/razorpay-mcp@0.1.0"
            ],
            "env": {
                "RAZORPAY_KEY_ID": "<RAZORPAY_KEY_ID>",
                "RAZORPAY_KEY_SECRET": "<your razorpay_key_secret>"
            }
        }
    }
}

Environment variables

  • RAZORPAY_KEY_ID required Your Razorpay Key ID from dashboard.razorpay.com/app/keys
  • RAZORPAY_KEY_SECRET required secret Your Razorpay Key Secret from dashboard.razorpay.com/app/keys

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. razorpay-mcp
  2. Quick Start
  3. Claude Desktop Setup
  4. Available Tools
  5. Example Prompts
  6. Security Note
  7. Development
  8. Part of IndiaMCP

razorpay-mcp

An MCP (Model Context Protocol) server that connects AI assistants like Claude directly to your Razorpay account. Once configured, you can ask your AI to fetch payments, analyze revenue trends, inspect failed transactions, monitor subscriptions, and get a real-time business dashboard — all in natural language, with no code required.

Quick Start

# Clone
git clone https://github.com/indiamcp/razorpay-mcp

# Install
cd razorpay-mcp
npm install

# Configure
cp .env.example .env
# Add your Razorpay API keys to .env

# Build
npm run build

# Run
npm start

Claude Desktop Setup

Add this to your claude_desktop_config.json (usually at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "razorpay": {
      "command": "node",
      "args": ["/path/to/razorpay-mcp/dist/index.js"],
      "env": {
        "RAZORPAY_KEY_ID": "rzp_test_xxxxxxxxxxxx",
        "RAZORPAY_KEY_SECRET": "your_secret_here"
      }
    }
  }
}

Or use npx (once published):

{
  "mcpServers": {
    "razorpay": {
      "command": "npx",
      "args": ["-y", "@indiamcp/razorpay-mcp"],
      "env": {
        "RAZORPAY_KEY_ID": "rzp_test_xxxxxxxxxxxx",
        "RAZORPAY_KEY_SECRET": "your_secret_here"
      }
    }
  }
}

Available Tools

ToolDescriptionKey Parameters
get_paymentFetch a specific payment by IDpayment_id
list_paymentsList payments with filtersfrom, to, count, status
get_payment_analyticsRevenue, success rate, method breakdownfrom, to
get_orderFetch a specific order by IDorder_id
list_ordersList orders with filtersfrom, to, count, status, receipt
get_customerFetch a specific customer by IDcustomer_id
list_customersList customerscount, skip
get_subscriptionFetch a specific subscription by IDsubscription_id
list_subscriptionsList subscriptions with filtersfrom, to, count, status
get_subscription_analyticsActive count, churn rate, upcoming renewalsfrom, to
get_refundFetch a specific refundpayment_id, refund_id
list_refundsList refunds for a paymentpayment_id, count
get_dashboard_summaryBusiness health check — revenue today/week/month(none)
get_failed_payment_analysisFailure reasons, by method and bankfrom, to

Example Prompts

Once connected, try asking Claude:

  • "Show me all failed payments in the last 7 days and why they failed"
  • "What's my total revenue this month?"
  • "List all active subscriptions"
  • "Which payment method do my customers prefer?"
  • "Show me customers who signed up this week"
  • "What's my subscription churn rate this month?"
  • "Find payment pay_xxxxx"
  • "How many refunds are pending?"
  • "Give me a dashboard summary of my business today"
  • "Analyze payment failures for the last 30 days"

Security Note

  • Environment variables only — API keys are read from env vars and never hardcoded or logged
  • Read-only in v1 — this server only fetches data; it cannot create payments, issue refunds, or modify any records
  • No data storage — payment data is never persisted or cached by this server
  • Use test keys during development — Razorpay test keys (rzp_test_*) are safe and make no real charges

Development

# Run in dev mode (no build needed)
npm run dev

# Type check
npm run lint

# Run tests
npm test

Part of IndiaMCP

This server is part of IndiaMCP — a suite of open-source MCP servers for the Indian API stack.

github.com/indiamcp

Frequently asked questions

What is io.github.indiamcp/razorpay?

MCP server for Razorpay API.

How do I install io.github.indiamcp/razorpay?

It runs on your machine. In Claude Code: claude mcp add razorpay -e 'RAZORPAY_KEY_ID=<RAZORPAY_KEY_ID>' -e 'RAZORPAY_KEY_SECRET=<your razorpay_key_secret>' -- npx -y @indiamcp/razorpay-mcp@0.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.indiamcp/razorpay need an API key?

Yes. It expects RAZORPAY_KEY_ID, RAZORPAY_KEY_SECRET, which you set in its configuration.

Is io.github.indiamcp/razorpay open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.indiamcp/razorpay?

It is published by indiamcp. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.