# cashfree-mcp

Connects AI agents to Cashfree APIs for payments, payouts, and SecureID. Use it to work with orders, payment links, payment details, and refunds.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 15
- Author: cashfree
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cashfree/cashfree-mcp
- Updated: 2026-04-03
- HTML: https://affpapa.org/en/nevibecode/mcp/cashfree-mcp

## What it does

cashfree-mcp exposes Cashfree services to AI clients through MCP. Its documented scope covers Payment Gateway, Payouts, and SecureID, with tools for searching developer documentation, creating payment links and orders, reading payment data, and starting refunds.

Choose enabled modules with `TOOLS`: `pg`, `payouts`, or `secureid`. Set `ENV` to `sandbox` or `production`; `ELICITATION_ENABLED` can make the server ask for required values that were left out of a request. The `npx` setup uses Cashfree credentials and requires Node.js v14.x or later.

A public-key path in `TWO_FA_PUBLIC_KEY_PEM_PATH` is required for Payouts and SecureID when 2FA is enabled. Node.js `>=18` can lead to dependency conflicts, and the setup notes recommend moving to `>=20.18.1` or changing the package version.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `PAYMENTS_APP_ID`, `PAYMENTS_APP_SECRET`, `PAYOUTS_APP_ID`, `PAYOUTS_APP_SECRET`, `TWO_FA_PUBLIC_KEY_PEM_PATH`, `SECUREID_APP_ID`, `SECUREID_APP_SECRET`, `TOOLS`, `ENV` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add cashfree-mcp -e PAYMENTS_APP_ID=<PAYMENTS_APP_ID> -e PAYMENTS_APP_SECRET=<PAYMENTS_APP_SECRET> -e PAYOUTS_APP_ID=<PAYOUTS_APP_ID> -e PAYOUTS_APP_SECRET=<PAYOUTS_APP_SECRET> -e SECUREID_APP_ID=<SECUREID_APP_ID> -e SECUREID_APP_SECRET=<SECUREID_APP_SECRET> -e TOOLS=<TOOLS> -e ENV=<ENV> -- npx -y @cashfreepayments/cashfree-mcp
```
Replace <…> with your own values. 4 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
codex mcp add cashfree-mcp --env PAYMENTS_APP_ID=<PAYMENTS_APP_ID> --env PAYMENTS_APP_SECRET=<PAYMENTS_APP_SECRET> --env PAYOUTS_APP_ID=<PAYOUTS_APP_ID> --env PAYOUTS_APP_SECRET=<PAYOUTS_APP_SECRET> --env TWO_FA_PUBLIC_KEY_PEM_PATH=<TWO_FA_PUBLIC_KEY_PEM_PATH> -- npx -y @cashfreepayments/cashfree-mcp
```
Replace <…> with your own values. 4 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cashfree-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@cashfreepayments/cashfree-mcp"
            ],
            "env": {
                "PAYMENTS_APP_ID": "<PAYMENTS_APP_ID>",
                "PAYMENTS_APP_SECRET": "<PAYMENTS_APP_SECRET>",
                "PAYOUTS_APP_ID": "<PAYOUTS_APP_ID>",
                "PAYOUTS_APP_SECRET": "<PAYOUTS_APP_SECRET>",
                "TWO_FA_PUBLIC_KEY_PEM_PATH": "<TWO_FA_PUBLIC_KEY_PEM_PATH>"
            }
        }
    }
}
```
Replace <…> with your own values. 4 more environment variables are in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cashfree-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@cashfreepayments/cashfree-mcp"
            ],
            "env": {
                "PAYMENTS_APP_ID": "<PAYMENTS_APP_ID>",
                "PAYMENTS_APP_SECRET": "<PAYMENTS_APP_SECRET>",
                "PAYOUTS_APP_ID": "<PAYOUTS_APP_ID>",
                "PAYOUTS_APP_SECRET": "<PAYOUTS_APP_SECRET>",
                "TWO_FA_PUBLIC_KEY_PEM_PATH": "<TWO_FA_PUBLIC_KEY_PEM_PATH>"
            }
        }
    }
}
```
Replace <…> with your own values. 4 more environment variables are in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e PAYMENTS_APP_ID=<PAYMENTS_APP_ID> -e PAYMENTS_APP_SECRET=<PAYMENTS_APP_SECRET> -e PAYOUTS_APP_ID=<PAYOUTS_APP_ID> -e PAYOUTS_APP_SECRET=<PAYOUTS_APP_SECRET> -e TWO_FA_PUBLIC_KEY_PEM_PATH=<TWO_FA_PUBLIC_KEY_PEM_PATH> cashfree-mcp npx -y @cashfreepayments/cashfree-mcp
```
Replace <…> with your own values. 4 more environment variables are in the server README

## When to use it
- search Cashfree developer documentation
- create payment links
- place orders through Payment Gateway
- inspect payment and order details
- start a refund

## Example prompts
- Search Cashfree documentation for the required fields to create a payment link.
- Create a Cashfree order for this amount and return its payment session identifier.
- Fetch the payment details for this ID and prepare a refund.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md