Razorpay

HTTPv1.0.0Credential RequiredApr 6, 2026

Documentation

Guide

CL Razorpay MCP Server

Interact with Razorpay's payment infrastructure — orders, payments, refunds, and settlements — via API.

A Model Context Protocol (MCP) server that exposes Razorpay's REST API for managing orders, capturing payments, processing refunds, and querying settlements.

Overview

The CL Razorpay MCP Server provides stateless, multi-tenant access to the Razorpay API:

Order management — create, fetch, update, and list orders
Payment operations — fetch, capture, and update payments
Refund handling — issue full or partial refunds, query refund status
Settlement queries — list and inspect settlement records

Perfect for:

Automating payment operations from AI agents or internal tools
Querying transaction history and settlement data programmatically
Building Claude-powered finance dashboards or customer support bots

Authentication

This server is stateless and multi-tenant. Every tenant-facing tool accepts key_id and key_secret on each call. Credentials are never stored server-side.

Obtain your API keys from the Razorpay Dashboard:

Log in to your Razorpay Dashboard.
Navigate to Settings → API Keys.
Click Generate Test Key (for sandbox) or Generate Live Key.
Copy the Key ID and Key Secret — the secret is shown only once.

Use the test-mode keys against https://api.razorpay.com/v1 — Razorpay's sandbox is live mode with test credentials, no separate base URL needed.

Tools

Orders

Creates an order that is required before initiating a payment on the frontend SDK.

Inputs:

key_id (string, required) — Razorpay API key ID
key_secret (string, required) — Razorpay API key secret
amount (integer, required) — Amount in smallest currency unit (e.g. paise for INR; ₹500 = 50000)
currency (string, required) — ISO 4217 currency code, e.g. "INR"
receipt (string, optional) — Merchant receipt number (max 40 chars)
notes (object, optional) — Key-value metadata to attach
partial_payment (boolean, optional) — Whether partial payments are allowed (default: false)

Output:

Retrieves a paginated list of orders, optionally filtered by creation timestamp.

Inputs:

key_id (string, required)
key_secret (string, required)
count (integer, optional) — Number to return (default: 10, max: 100)
skip (integer, optional) — Offset for pagination (default: 0)
from_timestamp (integer, optional) — Unix epoch; fetch orders created after this
to_timestamp (integer, optional) — Unix epoch; fetch orders created before this

Payments

Refunds

Creates a refund for a captured payment. Omit amount for a full refund.

Inputs:

key_id (string, required)
key_secret (string, required)
payment_id (string, required) — e.g. "pay_XXXXXXXXXX"
amount (integer, optional) — Partial refund amount; omit for full refund
speed (string, optional) — "normal" (default) or "optimum"
notes (object, optional) — Key-value metadata
receipt (string, optional) — Merchant receipt for the refund

Settlements

Common Parameters

count — Number of records to return (integer, 1–100, default 10)
skip — Number of records to skip for pagination (integer, default 0)
from_timestamp — Unix epoch integer; lower bound on created_at
to_timestamp — Unix epoch integer; upper bound on created_at

Resource ID Formats

Order:

order_{alphanumeric}
Example: order_OE1jIbY9HrFaXw

Payment:

All tools require Razorpay API credentials. Here's how to obtain them:

Go to Razorpay Dashboard
Sign up or log into your account

Step 2: Generate API Keys

Navigate to Settings → API Keys
Click Generate Test Key for sandbox or Regenerate Live Key for production
Download or copy both Key ID and Key Secret immediately

Step 3: Use Credentials Per Request

Pass key_id and key_secret in every tool call. The server uses HTTP Basic Auth (key_id as username, key_secret as password) on each request.

Step 4: Required Permissions

Ensure your Razorpay account has:

payments:read — Read payment details
— Capture and update payments

Missing or Invalid API Key

Cause: key_id or key_secret is missing, incorrect, or belongs to a different mode (test vs live)
Solution:
1. Re-copy credentials from the Razorpay Dashboard
2. Ensure you are using test keys for sandbox and live keys for production
3. Regenerate keys if they have been rotated

Insufficient Credits / Rate Limiting

Cause: API calls have exceeded your account's rate limits
Solution:
1. Reduce request frequency
2. Check Razorpay API Best Practices for rate limit guidance

Malformed Request Payload

Cause: Required fields missing or wrong types
Solution:
1. Ensure amount is an integer in smallest currency unit (paise, not rupees)
2. Ensure all required tool parameters are provided
3. Verify currency is a valid ISO 4217 code

Setup

pip install -r requirements.txt

Running the Server

# stdio (default — for local Claude Desktop / MCP clients)
python server.py
 
# SSE transport
python server.py --transport sse --host 127.0.0.1 --port 8001
 
# Streamable HTTP transport
python server.py --transport streamable-http --host 127.0.0.1 --port 8001

Example Tool Call

{
  "tool": "create_order",
  "arguments": {
    "key_id": "rzp_test_XXXXXXXX",
    "key_secret": "XXXXXXXXXXXXXXXX",
    "amount": 50000,
    "currency": "INR",
    "receipt": "receipt_001"
  }
}

Project Structure

cl-mcp-razorpay/
|-- server.py
|-- requirements.txt
|-- README.md
|-- .gitignore
`-- razorpay_mcp/
    |-- __init__.py
    |-- cli.py
    |-- config.py
    |-- schemas.py
    |-- service.py
    `-- tools.py

Connect

Get connection URL

https://gateway.mewcp.com/razorpay/mcp

Request Builder

import asyncio
from fastmcp import Client

# Real MewCP gateway URL for this server
GATEWAY_URL = "https://gateway.mewcp.com/razorpay/mcp"
API_KEY = "YOUR_API_KEY"

headers={
    "Authorization": f"Bearer {API_KEY}"
}

async def main():
    
    client = Client(GATEWAY_URL, headers=headers)
    
    async with client:
        # Test the connection by pinging the server
        await client.ping()
        
        # List available operations
        tools = await client.list_tools()
        resources = await client.list_resources()
        prompts = await client.list_prompts()

        # Execute operations
        result = await client.call_tool("example_tool", {"param": "value"})
        print(result)

asyncio.run(main())

Documentation

CL Razorpay MCP Server

Overview

Authentication

Tools

Orders

Payments

Refunds

Settlements

Setup

Running the Server

Example Tool Call

Project Structure

CL Razorpay MCP Server

Overview

Authentication

Tools

Orders

Payments

Refunds

Settlements

Setup

Running the Server

Example Tool Call

Project Structure

Payment Cannot Be Captured

Refund Cannot Be Created