Cashfree Payments

Cashfree MCP server

Connect AI assistants to a Cashfree merchant account over MCP: transactions, settlements, reports, payment links and refunds.

PaymentsGuided#mcp#payments#india#settlements#ai-agents#oauth

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

The Cashfree MCP server is Cashfree Payments' official, Cashfree-managed remote Model Context Protocol server. It connects AI clients such as Claude, ChatGPT, Cursor and Claude Code to your Cashfree merchant account, so you can ask in plain language about transactions, orders, settlements and reports, and call Payment Gateway actions such as creating payment links, orders and refunds. It is one of the few Indian payment companies with an official hosted MCP server today (others we checked on 2026-11-18: Razorpay has one with API-key auth, Upstox and Paytm run OAuth/onboarding-gated servers with little public documentation).

Endpoint: https://mcp.cashfree.com/mcp (Streamable HTTP). Docs: cashfree.com/docs/tools-ai/mcp-server.

How you sign in (OAuth only)

There is no API key for this server: you log in with your Cashfree merchant account (owner-level access is required) and the client receives an OAuth token.

  1. Make sure you have an active Cashfree merchant account with owner access.
  2. Add the endpoint to your client (snippets below). On the first call the server answers 401 ({"message": "authentication Failed", "code": "request_failed", "type": "authentication_error"}, checked live).
  3. The client reads https://mcp.cashfree.com/.well-known/oauth-protected-resource and /.well-known/oauth-authorization-server (both public; see folder 1). They list /oauth/authorize, /oauth/token, a dynamic client registration endpoint /oauth/register, PKCE S256, the authorization_code and refresh_token grants, and four scopes: mcp-pg-read, mcp-pg-write, mcp-workflows-read, mcp-workflows-write.
  4. A browser opens the Cashfree Merchant Dashboard; log in and approve. The tools are then available. Disconnecting a client revokes its refresh token straight away.

In this app: open any MCP request, use the MCP editor's OAuth sign-in, and the token is stored in the secret accessToken variable (collection auth is Bearer {{accessToken}}).

Add it to your AI client

  • Claude (web, Desktop, mobile): Customize > Connectors, search Cashfree, Connect, then log in to the Merchant Dashboard.
  • Claude Code: claude mcp add --transport http cashfree https://mcp.cashfree.com/mcp, then /mcp > cashfree > Login. Clear authentication from the same menu to revoke.
  • Cursor: Settings > Tools & Integrations > Add Custom MCP, add {"mcpServers": {"cashfree": {"url": "https://mcp.cashfree.com/mcp"}}} and click Needs login.
  • VS Code: add {"servers": {"cashfree": {"type": "http", "url": "https://mcp.cashfree.com/mcp"}}} to .vscode/mcp.json and start the server; VS Code runs the OAuth sign-in.
  • ChatGPT: Settings > Plugins (or Apps), search Cashfree, Connect.

What is in this collection and run order

Folder 1 is plain HTTP discovery (no token). After signing in, run folder 2 (tools/list as raw JSON-RPC, so you can see each tool's live argument schema), then folder 3 (transactions), folder 4 (settlements), folder 5 (reports) and folder 6 (Payment Gateway). Cashfree publishes the tool names but not their argument schemas, so requests for tools that need arguments are saved with an empty argument object: fill them from the schema the app shows after it connects (or from the tools/list result) before sending.

AreaTools
Transactionsget_transaction_details, search_transactions, search_orders, get_payment_modes, search_product_docs
Settlementsget_unsettled_amount, get_next_settlement_date, search_standard_settlements, get_on_demand_eligible_funds, get_on_demand_charges, get_instant_settlement_rates and more
Reportslist_reports, generate_recon_report, generate_summary_report, get_report_status, download_report
Payment Gatewaycreate_order, get_order, create_payment_link, cancel_payment_link, create_refund, get_refund, simulate_payment and more

Safety

create_payment_link, create_order, cancel_payment_link and especially create_refund act on a live merchant account and real money. Approve every write yourself, prefer read scopes for assistants that only need reporting, and use simulate_payment against test orders rather than real customers. Limits follow your Cashfree account's API limits (docs).

Common errors

ResponseMeaningFix
HTTP 401 authentication_errorNo or expired OAuth tokenSign in again
Login refusedAccount lacks owner-level accessAsk the account owner to connect
isError: true with a validation messageMissing or wrong tool argumentsCheck the tool's schema from tools/list
Tool missingScope not granted (read vs write)Reconnect and approve the write scope

Links: MCP server docs, Cashfree AI stack, MCP authorization spec.

Endpoints 24

1. Start here: OAuth discovery

  • POSTCall /mcp without a token (expect 401){{mcpUrl}}Sends an MCP initialize request with no Authorization header. Cashfree answers 401 with an authentication_error JSON body; an MCP client then reads the OAuth…
  • GETProtected resource metadata{{authBase}}/.well-known/oauth-protected-resourceReads the OAuth protected-resource document: the authorization server for the MCP server, header-only bearer tokens and the four scopes (Payment Gateway read…
  • GETAuthorization server metadata{{authBase}}/.well-known/oauth-authorization-serverReads the authorization server metadata with the /oauth/authorize, /oauth/token and /oauth/register endpoints, the JWKS URL, PKCE S256 and the…

2. Wire protocol (after sign-in)

  • POSTInitialize (raw JSON-RPC){{mcpUrl}}Runs the MCP initialize handshake with your bearer token and shows the server's protocol version, name and capabilities. If the response carries an…
  • POSTList tools (raw JSON-RPC){{mcpUrl}}Calls tools/list and returns every tool your granted scopes allow, each with its description and JSON input schema. Use this to fill the arguments of the tool…

3. Transactions and orders

  • MCPAvailable payment modes{{mcpUrl}}Calls get_payment_modes, which returns the payment method codes currently enabled on your merchant account (UPI, cards, net banking, wallets and so on).…
  • MCPTransaction lifecycle{{mcpUrl}}Calls get_transaction_details to show every state one transaction went through, which is the quickest way to answer 'why did this customer's payment fail'.…
  • MCPSearch transactions{{mcpUrl}}Calls search_transactions to find payment transactions that match filters such as a time window or status, for example all failed payments during an outage.…
  • MCPSearch orders{{mcpUrl}}Calls search_orders to find orders matching filters such as date range or status, so you can list unpaid or failed orders for follow-up. Arguments are not…
  • MCPSearch Cashfree docs{{mcpUrl}}Calls search_product_docs to search Cashfree's product documentation from inside the assistant, handy when a question is about how a feature works rather than…

4. Settlements

  • MCPUnsettled amount{{mcpUrl}}Calls get_unsettled_amount to return the total amount Cashfree currently holds for you that has not been settled to your bank yet. Expected to need no…
  • MCPNext settlement date{{mcpUrl}}Calls get_next_settlement_date, which returns when the next scheduled settlement reaches your bank, including bank-holiday shifts. Expected to need no…
  • MCPSearch standard settlements{{mcpUrl}}Calls search_standard_settlements to list scheduled settlements with filtering and pagination, for example everything settled last week, for reconciliation.…
  • MCPOn-demand eligible funds{{mcpUrl}}Calls get_on_demand_eligible_funds to see how much you could withdraw instantly right now, before the next scheduled settlement. Expected to need no arguments.
  • MCPInstant settlement rates{{mcpUrl}}Calls get_instant_settlement_rates to return the charge rates for instant and on-demand settlements on your account. Pair it with get_on_demand_charges for an…

5. Reports

  • MCPList reports{{mcpUrl}}Calls list_reports to show the reports already generated for your merchant account with their status and dates, so you can reuse one instead of generating it…
  • MCPGenerate a reconciliation report{{mcpUrl}}Calls generate_recon_report to start an asynchronous settlement reconciliation report for a period; poll get_report_status and then call download_report for…
  • MCPReport status{{mcpUrl}}Calls get_report_status with the report reference from generate_recon_report or generate_summary_report, and tells you whether it is still running or ready to…

6. Payment Gateway (writes need approval)

  • MCPCreate a payment link{{mcpUrl}}Calls create_payment_link to create a link you can send to a customer (amount, purpose, customer details, expiry). It creates a real collectible link on your…
  • MCPPayment link details{{mcpUrl}}Calls fetch_payment_link_details to see a link's status, expiry and whether it has been paid. Use it before resending or cancelling a link. Arguments are not…
  • MCPCancel a payment link{{mcpUrl}}Calls cancel_payment_link to deactivate an active link; no payments can be made on it afterwards. Useful when a link went out with the wrong amount. Arguments…
  • MCPCreate an order{{mcpUrl}}Calls create_order to create a Payment Gateway order and get a payment_session_id for checkout. Creates a real order on your account. Arguments are not…
  • MCPPayments for an order{{mcpUrl}}Calls get_payments_for_an_order to list every payment attempt on an order with status, mode and failure reason, the usual first step in a customer dispute.…
  • MCPCreate a refund{{mcpUrl}}Calls create_refund to start a refund on a payment. This sends money back to the customer and cannot be undone: confirm the payment, amount and reason with a…

API details

Base URL
https://mcp.cashfree.com/mcp
Authentication
OAuth 2.0 (authorization code flow) with 4 scopes
Operations
24 operations on 24 pathsPOST 22GET 2
Main resources
1. Start here: OAuth discovery 32. Wire protocol (after sign-in) 23. Transactions and orders 54. Settlements 55. Reports 36. Payment Gateway (writes need approval) 6
Description format
Swastik Codes guided collection, API version checked against the docs on 2026-11-18

How to test the Cashfree MCP server in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Cashfree MCP server collection, without the publisher's secrets.
  3. Add your credentialsThis API uses OAuth 2.0 (authorization code flow) with 4 scopes. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Call /mcp without a token (expect 401)” (POST {{mcpUrl}}), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Cashfree MCP server?

Connect AI assistants to a Cashfree merchant account over MCP: transactions, settlements, reports, payment links and refunds. It is listed under Payments and has 24 endpoints.

Who publishes the Cashfree MCP server?

It is listed from Cashfree Payments's public API description (an OpenAPI document), not published by Cashfree Payments on Swastik Codes. Anyone who controls cashfree.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Cashfree MCP server?

Requests go to https://mcp.cashfree.com/mcp. Endpoint paths are added to this base URL.

How do I authenticate with the Cashfree MCP server?

With OAuth 2.0 (authorization code flow) with 4 scopes.

How many endpoints does the Cashfree MCP server have?

24 operations on 24 paths (22 POST, 2 GET). The largest groups are 1. Start here: OAuth discovery, 2. Wire protocol (after sign-in), 3. Transactions and orders, 4. Settlements.

Is forking the Cashfree MCP server free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.