Razorpay Local MCP Server Setup

The Razorpay Local MCP Server is a self-hosted solution that provides complete control over your infrastructure and access to all available tools without restrictions. Choose this option if you need full functionality or have specific security requirements.

Setup Options

Refer to the

Prerequisites

section and then choose a setup method to proceed. You can use

Docker (recommended)

build from source

Prerequisites

Before setting up the Razorpay Local MCP Server, ensure you have:

Docker: Container platform for running the MCP server.
Git: Version control system for cloning repositories (if building from source).
Golang (Go): Programming language runtime (if building from source).
Razorpay API Keys: Generate
API keys
from your Dashboard.
AI-assisted Application: Claude Desktop, VS Code, or similar AI-assisted application.

Docker Setup Instructions (Recommended)

Clone the repository:

git clone https://github.com/razorpay/razorpay-mcp-server.git
cd razorpay-mcp-server

Build the Docker image:
docker build -t razorpay-mcp-server:latest

The resulting image razorpay-mcp-server:latest will be available in your local Docker registry.

Build From Source Instructions

Clone the repository:

git clone https://github.com/razorpay/razorpay-mcp-server.git
  cd razorpay-mcp-server

Build the Go binary:

go build -o razorpay-mcp-server ./cmd/razorpay-mcp-server

The resulting binary razorpay-mcp-server will be created in your current directory.

Integration Steps

Step 1: Configure Application

Follow the integration steps given below:

To use the Razorpay MCP Server with Claude Desktop:

Install
Claude Desktop
.
Go to Settings → Developer → Edit Config.
Add the following to your claude_desktop_config.json file:

{
  "mcpServers": {
      "razorpay-mcp-server": {
          "command": "docker",
          "args": [
              "run",
              "--rm",
              "-i",
              "-e",
              "RAZORPAY_KEY_ID",
              "-e",
              "RAZORPAY_KEY_SECRET",
              "razorpay-mcp-server:latest"
          ],
          "env": {
              "RAZORPAY_KEY_ID": "your_razorpay_key_id",
              "RAZORPAY_KEY_SECRET": "your_razorpay_key_secret"
          }
      }
    }
  }

Handy Tips

Replace your_razorpay_key_id and your_razorpay_key_secret with your actual Razorpay API credentials.
Configure MCP servers in Claude Desktop

Step 2: Restart Application

Restart your AI assistant application after configuration. You should see

Razorpay MCP tools

become available. Test the connection by asking: Show me available Razorpay tools.

If successful, you should see the complete list of Razorpay MCP tools, including tools that are restricted in the Remote MCP Server.

Next Steps

Once your Local MCP Server is running:

Explore Advanced Features: Access all tools including refunds and settlements.
Configure Advanced Options: See
Configuration Guide
for detailed settings.
Review Use Cases: Check
practical examples
that leverage local-only tools.