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