# Razorpay

> Razorpay is an open-source MCP server for finance and payments. MCP server giving AI assistants read-only access to a Razorpay account's payments. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Repository:** https://github.com/indiamcp/razorpay-mcp
- **MCP Registry name:** io.github.indiamcp/razorpay
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

The Razorpay MCP server lets an AI assistant such as Claude query a Razorpay account through the Model Context Protocol. Instead of opening the dashboard, a user can ask in plain language for payment lists, revenue figures, failed transaction breakdowns, or subscription status, and the assistant calls the server's tools to fetch the answers.

The README describes it as a Node.js package run over stdio. Credentials are supplied as the RAZORPAY_KEY_ID and RAZORPAY_KEY_SECRET environment variables, and the README recommends test keys during development. The server is read-only in its first version, so it cannot create payments, issue refunds, or change records, and it says it does not store or cache payment data.

The project is aimed at founders, finance staff, and developers on Razorpay who want quick business summaries through an AI client. It is one of the open-source servers in the IndiaMCP collection.

## Features

- **Payment and order lookup:** Fetch individual payments, orders, customers, and refunds by ID or list them with filters.
- **Revenue and success analytics:** Summaries of revenue, success rate, and payment method breakdown over a date range.
- **Failed payment analysis:** Groups failed payments by reason, method, and bank for a chosen period.
- **Subscription monitoring:** Lists subscriptions and reports active counts, churn rate, and upcoming renewals.
- **Business dashboard summary:** Returns a snapshot of revenue for today, the week, and the month.
- **Read-only access:** The first version only fetches data and cannot create payments, issue refunds, or modify records.

## Good for

- Checking failed payments and their causes without opening the Razorpay dashboard
- Asking an AI assistant for monthly revenue and payment method trends
- Monitoring subscription churn and upcoming renewals in plain language
- Looking up a specific payment, refund, or customer by ID during support work

## Install

### Claude Code (Terminal)

```sh
claude mcp add razorpay --env RAZORPAY_KEY_ID='<RAZORPAY_KEY_ID>' --env RAZORPAY_KEY_SECRET='<RAZORPAY_KEY_SECRET>' -- npx -y @indiamcp/razorpay-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "razorpay": {
      "command": "npx",
      "args": [
        "-y",
        "@indiamcp/razorpay-mcp"
      ],
      "env": {
        "RAZORPAY_KEY_ID": "<RAZORPAY_KEY_ID>",
        "RAZORPAY_KEY_SECRET": "<RAZORPAY_KEY_SECRET>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "razorpay": {
      "command": "npx",
      "args": [
        "-y",
        "@indiamcp/razorpay-mcp"
      ],
      "env": {
        "RAZORPAY_KEY_ID": "<RAZORPAY_KEY_ID>",
        "RAZORPAY_KEY_SECRET": "<RAZORPAY_KEY_SECRET>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "razorpay": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@indiamcp/razorpay-mcp"
      ],
      "env": {
        "RAZORPAY_KEY_ID": "<RAZORPAY_KEY_ID>",
        "RAZORPAY_KEY_SECRET": "<RAZORPAY_KEY_SECRET>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "razorpay": {
      "command": "npx",
      "args": [
        "-y",
        "@indiamcp/razorpay-mcp"
      ],
      "env": {
        "RAZORPAY_KEY_ID": "<RAZORPAY_KEY_ID>",
        "RAZORPAY_KEY_SECRET": "<RAZORPAY_KEY_SECRET>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "razorpay": {
      "command": "npx",
      "args": [
        "-y",
        "@indiamcp/razorpay-mcp"
      ],
      "env": {
        "RAZORPAY_KEY_ID": "<RAZORPAY_KEY_ID>",
        "RAZORPAY_KEY_SECRET": "<RAZORPAY_KEY_SECRET>"
      }
    }
  }
}
```

## Tools

- `get_payment`: Fetch a specific payment by ID
- `list_payments`: List payments with filters
- `get_payment_analytics`: Revenue, success rate, and method breakdown
- `get_order`: Fetch a specific order by ID
- `list_orders`: List orders with filters
- `get_customer`: Fetch a specific customer by ID
- `list_customers`: List customers
- `get_subscription`: Fetch a specific subscription by ID
- `list_subscriptions`: List subscriptions with filters
- `get_subscription_analytics`: Active count, churn rate, and upcoming renewals
- `get_refund`: Fetch a specific refund
- `list_refunds`: List refunds for a payment
- `get_dashboard_summary`: Business health check with revenue today, week, and month
- `get_failed_payment_analysis`: Failure reasons by method and bank

## FAQ

### Can this server create payments or issue refunds?

No. The README says the first version is read-only and only fetches data.

### Where are the API keys stored?

The README says keys are read from environment variables and are not hardcoded or logged.

### Does the server store payment data?

The README states that payment data is never persisted or cached by this server.

### How do I install it?

Clone the repository and run npm install and npm run build, or use npx with the @indiamcp/razorpay-mcp package as shown in the README.

### Is Razorpay free?

Yes. Razorpay is open source, so you can use and self-host it for free.

### How do I add Razorpay to Claude Code?

Run this command in your terminal: claude mcp add razorpay --env RAZORPAY_KEY_ID='<RAZORPAY_KEY_ID>' --env RAZORPAY_KEY_SECRET='<RAZORPAY_KEY_SECRET>' -- npx -y @indiamcp/razorpay-mcp

### What are the best alternatives to Razorpay?

The closest alternatives to Razorpay are BTCPay Server MCP, Money Magician, Klap and Chartsy.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [BTCPay Server MCP](https://ai-powered.com/mcp/btcpay-server-mcp): BTCPay Server MCP is an open-source MCP server for finance and payments.
- [Money Magician](https://ai-powered.com/mcp/money-magician): Money Magician is an MCP server for finance and payments.
- [Klap](https://ai-powered.com/mcp/klap-2): Klap is an open-source MCP server for finance and payments.
- [Chartsy](https://ai-powered.com/mcp/chartsy): Chartsy is an MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/razorpay
