rzp-mcp

An MCP (Model Context Protocol) server that exposes the Razorpay API as tools for Claude and other LLM clients. Interact with your Razorpay account using natural language.

"Check if payment pay_xyz went through"
"List my last 10 orders from this month"
"Issue a ₹200 partial refund on payment pay_abc"
"What was settled to my account last week?"

Tools

Tool	Description
razorpay_fetch_payment	Fetch full payment details by ID
razorpay_payment_status	Quick status check — status, amount, captured, method
razorpay_capture_payment	Capture an authorized payment
razorpay_create_order	Create a new order
razorpay_fetch_order	Fetch an order by ID
razorpay_list_orders	List orders with date/status filters
razorpay_issue_refund	Issue a full or partial refund
razorpay_fetch_refund	Check refund status
razorpay_fetch_settlement	Fetch a settlement by ID
razorpay_list_settlements	List settlements with date filters

Setup

1. Get your Razorpay API keys

Go to Razorpay Dashboard → Settings → API Keys and generate a key pair.

Use test mode keys (rzp_test_...) while getting started.

2. Configure Claude Desktop

Add this to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Restart Claude Desktop. You should see the Razorpay tools available.

Running as HTTP server

For remote/web clients, run in HTTP mode:

RAZORPAY_KEY_ID=rzp_test_xxx RAZORPAY_KEY_SECRET=yyy npx rzp-mcp http

This starts:

• Streamable HTTP at http://localhost:3000/mcp (MCP spec 2025-11-25)
• Legacy SSE at http://localhost:3000/sse (backwards-compatible)

Set PORT env var to change the port (default: 3000).

Auth

Credentials are passed exclusively via environment variables — never as tool arguments.

RAZORPAY_KEY_ID=rzp_live_xxxxxxxxxxxx
RAZORPAY_KEY_SECRET=your_secret_here

The server validates credentials at startup and exits with a clear error message if they are missing.

Amount units

Razorpay uses the smallest currency unit for all amounts:

• INR: paise (₹500.00 = 50000)
• USD: cents ($10.00 = 1000)

All tool descriptions explicitly document this to prevent mistakes.

Development

git clone https://github.com/hahahamid/razorpay-mcp
cd razorpay-mcp
npm install
npm test        # run unit tests
npm run build   # build to dist/

License

MIT