Connect Razorpay MCP Server to Gemini CLI

Gemini CLI discovers MCP servers from the mcpServers block in its settings.json file. Add the Razorpay Remote MCP Server using HTTP transport.

Gemini CLI Configuration

Open your Gemini CLI settings file. Use ~/.gemini/settings.json for global configuration, or .gemini/settings.json within a project.

Add the following Razorpay server entry and save the file:

{
  "mcpServers": {
    "razorpay": {
      "httpUrl": "https://mcp.razorpay.com/mcp",
      "headers": {
        "Authorization": "Basic <your-base64-encoded-key-secret>"
      }
    }
  }
}

Replace <your-base64-encoded-key-secret> with your Base64 token. You can also reference an environment variable, such as $RAZORPAY_TOKEN, as Gemini CLI expands variables in the configuration. Refer to the
Remote MCP Server setup
to generate the token.
Restart Gemini CLI and run /mcp to check the server status. If required, run /mcp reload to fetch the tools again.

Need Help?

If you need any assistance with the integration, reach out to us at

agentic-payments@razorpay.com