razorpay-mcp
Unofficial Razorpay MCP server
Documentation

Razorpay MCP Server
> Connect your Razorpay payment gateway to AI assistants using the Model Context Protocol
A Model Context Protocol (MCP) server for interacting with the Razorpay payment gateway API. This package enables AI assistants like Cursor, Claude, and Copilot to directly access your Razorpay account data through a standardized interface.
Quick Start
The most reliable way to use this package:
# Install globally first
npm install -g razorpay-mcp@0.1.4
# Then use the binary directly
razorpay-mcp-stdio --key-id rzp_test_yourkeyid --key-secret yoursecretkeyCursor Configuration
After installing globally, add this configuration to your `.cursor/mcp.json` file:
{
"mcpServers": {
"razorpay": {
"command": "razorpay-mcp-stdio",
"args": [
"--key-id",
"rzp_test_yourkeyid",
"--key-secret",
"yoursecretkey"
]
}
}
}For Windows Users
{
"mcpServers": {
"razorpay": {
"command": "cmd",
"args": [
"/c",
"razorpay-mcp-stdio",
"--key-id",
"rzp_test_yourkeyid",
"--key-secret",
"yoursecretkey"
]
}
}
}For Web Applications (Using SSE)
1. Start the SSE server:
# Install globally first
npm install -g razorpay-mcp@0.1.4
# Then use the binary directly
razorpay-mcp-sse --key-id rzp_test_yourkeyid --key-secret yoursecretkey --port 30012. Connect from your web app:
// Create SSE connection
const eventSource = new EventSource('http://localhost:3001/sse');
// Handle connection event
eventSource.onmessage = (event) => {
const data = JSON.parse(event.data);
// If this is a hello message, store the sessionId
if (data.type === 'hello') {
const sessionId = data.sessionId;
console.log(`Connected with session ID: ${sessionId}`);
// Now you can make API calls
callRazorpayAPI(sessionId, 'getAllPayments', {count: 10});
}
};
// Send API requests
async function callRazorpayAPI(sessionId, toolName, params) {
const response = await fetch(`http://localhost:3001/messages?sessionId=${sessionId}`, {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
type: 'toolCall',
id: Date.now().toString(),
name: toolName,
params
})
});
return response.json();
}Docker Usage
You can also run this MCP server using Docker:
Build the Docker Image
# Clone the repository
git clone https://github.com/yourusername/razorpay-mcp.git
cd razorpay-mcp
# Build the Docker image
docker build -t razorpay-mcp .Run the Container
For the stdio transport (for direct use with Cursor):
docker run --rm -it razorpay-mcp node dist/transports/stdio.cjs \
--key-id rzp_test_yourkeyid --key-secret yoursecretkeyFor the SSE server (for web applications):
docker run --rm -p 3001:3001 razorpay-mcp node dist/transports/sse.cjs \
--key-id rzp_test_yourkeyid --key-secret yoursecretkey --port 3001Available Razorpay Tools
| Tool Name | Description | Parameters |
|---|---|---|
| `getAllPayments` | Fetch payments with pagination | `count`, `skip`, `from`, `to` |
| `getAllOrders` | Fetch orders with pagination | `count`, `skip`, `from`, `to` |
| `getAllSettlements` | Fetch settlements with pagination | `count`, `skip`, `from`, `to` |
| `getAllRefunds` | Fetch refunds with pagination | `count`, `skip`, `from`, `to` |
| `getAllDisputes` | Fetch disputes with pagination | `count`, `skip`, `from`, `to` |
| `getAllInvoices` | Fetch invoices with pagination | `count`, `skip`, `from`, `to` |
| `getAllContacts` | Fetch contacts with pagination | `count`, `skip`, `from`, `to` |
| `getAllTransactions` | Fetch transactions with pagination | `count`, `skip`, `from`, `to` |
| `getAllVPAs` | Fetch Virtual Payment Addresses | `count`, `skip`, `from`, `to` |
| `getAllCustomers` | Fetch customers with pagination | `count`, `skip`, `from`, `to` |
| `getAccountBalance` | Fetch account balance | `accountId` |
All pagination parameters are optional:
- `count`: Number of items to fetch (default: 10, max: 100)
- `skip`: Number of items to skip
- `from`: Start timestamp
- `to`: End timestamp
Resources
License
Apache-2.0
Frequently asked questions
What is razorpay-mcp?
razorpay-mcp is Unofficial Razorpay MCP server
How do I install razorpay-mcp?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is razorpay-mcp open source?
Yes — it is hosted on GitHub at https://github.com/LightHeads/razorpay-mcp and has 2 stars.
Related MCP tools
🧩 MCP Gateway - A lightweight gateway service that instantly transforms existing MCP Servers and APIs into MCP servers with zero code changes.
MCP Aggregator, Orchestrator, Middleware, Gateway in one docker TypeScript-based implementation. Trusted by 1400+ developers.
A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you
Playwright MCP server TypeScript-based implementation. Trusted by 22000+ developers. Trusted by 22000+ developers. Trusted by 22000+ developers.
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Ag...
🤖 A visualization mcp contains 25+ visual charts using @antvis. Using for chart generation and data analysis. TypeScript-based implementation.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP