A Model Context Protocol (MCP) server that connects AI assistants directly to a Razorpay account. It enables natural language queries to fetch payments, analyze revenue trends, inspect failed transactions, monitor subscriptions, and provide a real-time business dashboard without coding.

🛠️ Key Features

Connects AI assistants to Razorpay accounts
Natural language access to payments, revenue trends, failures, and subscriptions
Real-time business dashboard via MCP
Quick start with clone, install, configure, build, and run steps

🚀 Use Cases

Retrieve recent payments and transaction details
Analyze revenue trends over time
Inspect failed transactions and error reasons
Monitor active subscriptions and churn indicators
Interactive, code-free data exploration for business teams

⚡ Developer Benefits

Simple CLI-like setup: clone, install, configure, build, run
Clean integration point between AI assistants and Razorpay data
Lightweight MCP server tailored for Razorpay API access

⚠️ Limitations

Based on readme excerpt; specificity depends on external Razorpay API and keys
Requires proper environment configuration (.env) with API credentials
Operational details may vary with Razorpay API changes

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

bash

# 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):

json

{
  "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):

json

{
  "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

bash

# 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

io.github.indiamcp/razorpay