The Razorpay MCP Server provides seamless integration with Razorpay APIs through the Model Context Protocol (MCP), allowing developers to build AI-powered applications that can interact with Razorpay's payment ecosystem.
The remote server is hosted by Razorpay and requires no local infrastructure setup, offering benefits like automatic updates, high availability, and enhanced security.
You need Node.js installed on your system, which includes npm and npx:
macOS:
brew install node
Windows:
choco install nodejs
Verify Installation:
npx --version
Add this configuration to your Cursor MCP settings:
{
"mcpServers": {
"rzp-mcp-server": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.razorpay.com/mcp",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer <Base64(key:secret)>"
}
}
}
}
Add this to your claude_desktop_config.json
:
{
"mcpServers": {
"rzp-mcp-server": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.razorpay.com/mcp",
"--header",
"Authorization: Bearer <Merchant Token>"
]
}
}
}
Add this to your VS Code settings (JSON):
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "merchant_token",
"description": "Razorpay Merchant Token",
"password": true
}
],
"servers": {
"razorpay-remote": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.razorpay.com/mcp",
"--header",
"Authorization: Bearer ${input:merchant_token}"
]
}
}
}
}
To generate your merchant token for remote server access:
echo <RAZORPAY_API_KEY>:<RAZORPAY_API_SECRET> | base64
For users who prefer to run the server on their own infrastructure.
Add this to your claude_desktop_config.json
:
{
"mcpServers": {
"razorpay-mcp-server": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"RAZORPAY_KEY_ID",
"-e",
"RAZORPAY_KEY_SECRET",
"razorpay/mcp"
],
"env": {
"RAZORPAY_KEY_ID": "your_razorpay_key_id",
"RAZORPAY_KEY_SECRET": "your_razorpay_key_secret"
}
}
}
}
Add this to your VS Code settings (JSON):
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "razorpay_key_id",
"description": "Razorpay Key ID",
"password": false
},
{
"type": "promptString",
"id": "razorpay_key_secret",
"description": "Razorpay Key Secret",
"password": true
}
],
"servers": {
"razorpay": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"RAZORPAY_KEY_ID",
"-e",
"RAZORPAY_KEY_SECRET",
"razorpay/mcp"
],
"env": {
"RAZORPAY_KEY_ID": "${input:razorpay_key_id}",
"RAZORPAY_KEY_SECRET": "${input:razorpay_key_secret}"
}
}
}
}
}
git clone https://github.com/razorpay/razorpay-mcp-server.git
cd razorpay-mcp-server
docker build -t razorpay-mcp-server:latest .
Once built, replace razorpay/mcp
with razorpay-mcp-server:latest
in your configurations.
git clone https://github.com/razorpay/razorpay-mcp-server.git
cd razorpay-mcp-server
go build -o razorpay-mcp-server ./cmd/razorpay-mcp-server
Then configure your MCP client to use the binary:
{
"razorpay": {
"command": "/path/to/razorpay-mcp-server",
"args": ["stdio","--log-file=/path/to/rzp-mcp.log"],
"env": {
"RAZORPAY_KEY_ID": "<YOUR_ID>",
"RAZORPAY_KEY_SECRET" : "<YOUR_SECRET>"
}
}
}
The server requires these configuration variables:
RAZORPAY_KEY_ID
: Your Razorpay API key IDRAZORPAY_KEY_SECRET
: Your Razorpay API key secretOptional settings:
LOG_FILE
: Path to log file for server logsTOOLSETS
: Comma-separated list of toolsets to enable (default: "all")READ_ONLY
: Run server in read-only mode (default: false)--key
or -k
: Your Razorpay API key ID--secret
or -s
: Your Razorpay API key secret--log-file
or -l
: Path to log file--toolsets
or -t
: Comma-separated list of toolsets to enable--read-only
: Run server in read-only modeTo add this MCP server to Claude Code, run this command in your terminal:
claude mcp add-json "rzp-sse-mcp-server" '{"command":"npx","args":["mcp-remote","https://mcp.razorpay.com/sse","--header","Authorization:${AUTH_HEADER}"],"env":{"AUTH_HEADER":"Bearer <Base64(key:secret)>"}}'
See the official Claude Code MCP documentation for more details.
There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json
file so that it is available in all of your projects.
If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json
file.
To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".
When you click that button the ~/.cursor/mcp.json
file will be opened and you can add your server like this:
{
"mcpServers": {
"rzp-sse-mcp-server": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.razorpay.com/sse",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer <Base64(key:secret)>"
}
}
}
}
To add an MCP server to a project you can create a new .cursor/mcp.json
file or add it to the existing one. This will look exactly the same as the global MCP server example above.
Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.
The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.
You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.
To add this MCP server to Claude Desktop:
1. Find your configuration file:
~/Library/Application Support/Claude/claude_desktop_config.json
%APPDATA%\Claude\claude_desktop_config.json
~/.config/Claude/claude_desktop_config.json
2. Add this to your configuration file:
{
"mcpServers": {
"rzp-sse-mcp-server": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.razorpay.com/sse",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer <Base64(key:secret)>"
}
}
}
}
3. Restart Claude Desktop for the changes to take effect