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

| Tool | Description | Key Parameters | |------|-------------|----------------| | get_payment | Fetch a specific payment by ID | payment_id | | list_payments | List payments with filters | from, to, count, status | | get_payment_analytics | Revenue, success rate, method breakdown | from, to | | get_order | Fetch a specific order by ID | order_id | | list_orders | List orders with filters | from, to, count, status, receipt | | get_customer | Fetch a specific customer by ID | customer_id | | list_customers | List customers | count, skip | | get_subscription | Fetch a specific subscription by ID | subscription_id | | list_subscriptions | List subscriptions with filters | from, to, count, status | | get_subscription_analytics | Active count, churn rate, upcoming renewals | from, to | | get_refund | Fetch a specific refund | payment_id, refund_id | | list_refunds | List refunds for a payment | payment_id, count | | get_dashboard_summary | Business health check — revenue today/week/month | (none) | | get_failed_payment_analysis | Failure reasons, by method and bank | from, 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