- Category: model context protocol
- Auth: DCR_OAUTH
- Composio-managed OAuth available? No
- Tools: 38
- Triggers: 0
- Slug:
CASHFREE_PAYMENTS_MCP - Version: 20261030_00
Tools
Cancel payment link
Cancel payment link
CASHFREE_PAYMENTS_MCP_CANCEL_PAYMENT_LINKUSE WHEN: The user wants to cancel/deactivate an existing payment link so no further payments can be made. Cancel a payment link. Only links in ACTIVE status can be cancelled.Input Parameters
Create order
Create order
CASHFREE_PAYMENTS_MCP_CREATE_ORDERUSE WHEN: The user wants to create a payment order to accept a payment. Requires amount, currency, and customer details. Create a new payment order. Returns order_id and payment_session_id needed to collect payment. NEXT: Call get_order(order_id) to verify the order was created and retrieve the payment session.Input Parameters
Create payment link
Create payment link
CASHFREE_PAYMENTS_MCP_CREATE_PAYMENT_LINKUSE WHEN: The user wants to create a shareable payment link to collect money from customers. Create a new payment link with an amount, purpose, and customer details. Returns the link URL. NEXT: Call fetch_payment_link_details(link_id) to verify the link was created and check its status.Input Parameters
Create refund
Create refund
CASHFREE_PAYMENTS_MCP_CREATE_REFUNDUSE WHEN: The user wants to initiate a refund for a payment. Create a refund against an order. Requires order_id and refund details in the body. NEXT: Call get_refund(order_id, refund_id) to track the refund status.Input Parameters
Download report
Download report
Fetch payment link details
Fetch payment link details
CASHFREE_PAYMENTS_MCP_FETCH_PAYMENT_LINK_DETAILSUSE WHEN: The user wants to check the status or details of an existing payment link. Fetch all details and status of a payment link by its link_id.Input Parameters
Fetch simulation
Fetch simulation
CASHFREE_PAYMENTS_MCP_FETCH_SIMULATIONUSE WHEN: The user wants to check the result of a simulated payment. Fetch simulated payment details by simulation_id.Input Parameters
Generate recon report
Generate recon report
CASHFREE_PAYMENTS_MCP_GENERATE_RECON_REPORTUSE WHEN: The user wants to generate a settlement reconciliation report. Generate a settlement reconciliation report asynchronously. NEXT: Call get_report_status(reportId) to poll until the report is DONE, then download_report(reportId).DATE RANGE LIMIT: startDate and endDate must be supplied together and be either a custom range of 31 days or less, or exactly one full financial year — April 1 to March 31 of any financial year that has already begun (the current one may also be requested as April 1 to today). There is no limit on how far back the range starts, but a custom range must not extend into the future. Anything else is rejected with HTTP 400 — split wider custom periods into 31-day chunks.Input Parameters
Generate summary report
Generate summary report
CASHFREE_PAYMENTS_MCP_GENERATE_SUMMARY_REPORTUSE WHEN: The user wants to generate a transaction summary, settlement, refund, or ledger report. Generate a summary/download report asynchronously. NEXT: Call get_report_status(reportId) to poll until the report is DONE, then download_report(reportId).DATE RANGE LIMIT: every date pair (startDate/endDate, bbpsStartDate/bbpsEndDate, subscriptionStartDate/subscriptionEndDate) must be either a custom range of 31 days or less, or exactly one full financial year — April 1 to March 31 of any financial year that has already begun (the current one may also be requested as April 1 to today). There is no limit on how far back a range starts, but a custom range must not extend into the future. Anything else is rejected with HTTP 400 — split wider custom periods into 31-day chunks.Input Parameters
Get instant settlement rates
Get instant settlement rates
Get merchant free trial credits
Get merchant free trial credits
Get next settlement date
Get next settlement date
Get on demand charges
Get on demand charges
Get on demand daily limit
Get on demand daily limit
Get on demand eligible funds
Get on demand eligible funds
CASHFREE_PAYMENTS_MCP_GET_ON_DEMAND_ELIGIBLE_FUNDSUSE WHEN: The user wants to know how much money can be withdrawn via on-demand settlement. Get eligible funds for on-demand settlement withdrawal. NEXT: Call get_on_demand_charges(requestedAmount, freeTrialRequest=false) to preview fees before withdrawal.Input Parameters
Get on demand settlement activation status
Get on demand settlement activation status
Get order
Get order
CASHFREE_PAYMENTS_MCP_GET_ORDERUSE WHEN: The user wants to check the status of an order or retrieve its payment session details. Fetch order details using the order_id. NEXT: Call get_payments_for_an_order(order_id) to see all payment attempts against this order.Input Parameters
Get order extended
Get order extended
CASHFREE_PAYMENTS_MCP_GET_ORDER_EXTENDEDUSE WHEN: The user needs extended order information including address, cart items, offers, and customer details. Fetch extended order data using the Cashfree order_id.Input Parameters
Get orders for a payment link
Get orders for a payment link
CASHFREE_PAYMENTS_MCP_GET_ORDERS_FOR_A_PAYMENT_LINKUSE WHEN: The user wants to see all orders created against a specific payment link. View all order details for a payment link. NEXT: Call get_order(order_id) or get_payments_for_an_order(order_id) for specific order details.Input Parameters
Get payment by id
Get payment by id
CASHFREE_PAYMENTS_MCP_GET_PAYMENT_BY_IDUSE WHEN: The user wants to view details of a specific payment attempt on an order. Get payment details by order_id and cf_payment_id. NEXT: To refund this payment, call create_refund(order_id, body={refund_amount, refund_id}).Input Parameters
Get payment modes
Get payment modes
CASHFREE_PAYMENTS_MCP_GET_PAYMENT_MODESUSE WHEN: The user wants to filter transactions by payment method but you need the numeric code. Also useful to show what payment methods are available. Retrieve the merchant’s available payment method codes. NEXT: Use the returned code in search_transactions(paymentCode=<code>) to filter by payment method.Returns: Mapping of payment method display names to numeric codesGet payments for an order
Get payments for an order
CASHFREE_PAYMENTS_MCP_GET_PAYMENTS_FOR_AN_ORDERUSE WHEN: The user wants to see all payment attempts made against a specific order. View all payment details for an order. NEXT: Call get_payment_by_id(order_id, cf_payment_id) to view details of a specific payment.Input Parameters
Get refund
Get refund
Get report status
Get report status
CASHFREE_PAYMENTS_MCP_GET_REPORT_STATUSUSE WHEN: You need to check if a report is ready for download. Poll this after generate_recon_report or generate_summary_report. Get report status and details (polling endpoint). NEXT: If status is DONE, call download_report(reportId). If REQUESTED or IN_PROGRESS, poll again.Input Parameters
Get settlement recon routes
Get settlement recon routes
CASHFREE_PAYMENTS_MCP_GET_SETTLEMENT_RECON_ROUTESUSE WHEN: The user wants to generate a Flowwise Recon report and you need the gateway route names. Get settlement recon gateway routes. NEXT: Use route names in generate_recon_report(reportType=‘flow_wise_recon_report’, pg=<route_name>).Returns: Array of gateway route objectsGet standard settlement details
Get standard settlement details
Get tool guide
Get tool guide
CASHFREE_PAYMENTS_MCP_GET_TOOL_GUIDEUSE WHEN: You are about to perform a multi-step task and need to know which tools to call and in what order. CALL THIS FIRST before starting any complex task. Returns the recommended tool chain for a user’s intent.Describe the user’s goal in natural language. Examples:- “search for failed transactions in the last 7 days”
- “generate a settlement reconciliation report”
- “create a payment order for 500 INR”
- “check the status of a refund”
- “verify a PAN number” NEXT: Follow the returned step-by-step tool chain to complete the task.
Input Parameters
Get transaction details
Get transaction details
CASHFREE_PAYMENTS_MCP_GET_TRANSACTION_DETAILSUSE WHEN: The user wants to see the full details of a specific transaction including timeline, settlement, and gateway response. View the complete lifecycle of a single transaction.Returns timeline events, order details, customer details, settlement info, gateway response, and optionally EMI and OCC charge breakdowns.Input Parameters
Get unsettled amount
Get unsettled amount
CASHFREE_PAYMENTS_MCP_GET_UNSETTLED_AMOUNTUSE WHEN: The user asks about unsettled balance, money held by Cashfree, or pending settlements. Get the total unsettled amount held by Cashfree. NEXT: Call get_on_demand_eligible_funds() to check how much can be withdrawn immediately, or search_standard_settlements() for history.Input Parameters
Get vendor settlement details
Get vendor settlement details
List reports
List reports
CASHFREE_PAYMENTS_MCP_LIST_REPORTSUSE WHEN: The user wants to see previously generated reports or check if a report exists. List all previously generated reports for this merchant. NEXT: Call download_report(reportId) to get the download URL for a completed report.DATE RANGE LIMIT: startDate and endDate must be supplied together, span 31 days or less, fall within the last 2 years, and not extend into the future. Wider requests are rejected with HTTP 400 — split them into 31-day chunks. Unlike the generate_* tools, there is no financial-year option here.Input Parameters
Search on demand settlements
Search on demand settlements
CASHFREE_PAYMENTS_MCP_SEARCH_ON_DEMAND_SETTLEMENTSUSE WHEN: The user wants to search past on-demand/instant withdrawal settlements. Search on-demand (instant withdrawal) settlements.DATE RANGE LIMIT: startDate and endDate must be supplied together, span 31 days or less, fall within the last 2 years, and not extend into the future. Wider requests are rejected with HTTP 400 — split them into 31-day chunks.Input Parameters
Search orders
Search orders
Search product docs
Search product docs
CASHFREE_PAYMENTS_MCP_SEARCH_PRODUCT_DOCSUSE WHEN: The user asks about Cashfree Developer Documentation product features, API usage, integration guides, or how something works. Searches Cashfree Developer Documentation product documentation and returns matching help articles with titles, content, and links. NEXT: Use the returned content to answer the user’s question directly.Input Parameters
Search standard settlements
Search standard settlements
CASHFREE_PAYMENTS_MCP_SEARCH_STANDARD_SETTLEMENTSUSE WHEN: The user wants to search settlement history, check settlement status, or find a specific settlement by UTR. Search standard (scheduled) settlements with filtering and pagination. NEXT: Call get_standard_settlement_details(settlementIds=<id>) to track a specific settlement through the banking pipeline.DATE RANGE LIMIT: startDate and endDate must be supplied together, span 31 days or less, fall within the last 2 years, and not extend into the future. Wider requests are rejected with HTTP 400 — split them into 31-day chunks.Input Parameters
Search transactions
Search transactions
CASHFREE_PAYMENTS_MCP_SEARCH_TRANSACTIONSUSE WHEN: The user wants to find, search, filter, or list payment transactions. Search for payment transactions matching the given filters. This is the primary discovery endpoint. NEXT: Call get_transaction_details(txId=<refId>, txTime=<txTime>) to view a specific transaction’s full lifecycle.DATE RANGE LIMIT: startDate and endDate must be supplied together, span 31 days or less, fall within the last 2 years, and not extend into the future. Wider requests are rejected with HTTP 400 — split them into 31-day chunks.Input Parameters
Search vendor settlements
Search vendor settlements
CASHFREE_PAYMENTS_MCP_SEARCH_VENDOR_SETTLEMENTSUSE WHEN: The user wants to search vendor split (Easy Split) settlement payouts. Search vendor split settlement payouts (Easy Split only). NEXT: Call get_vendor_settlement_details(settlementIds=<id>) to track vendor payouts.DATE RANGE LIMIT: startDate and endDate must be supplied together, span 31 days or less, fall within the last 2 years, and not extend into the future. Wider requests are rejected with HTTP 400 — split them into 31-day chunks.Input Parameters
Simulate payment
Simulate payment
CASHFREE_PAYMENTS_MCP_SIMULATE_PAYMENTUSE WHEN: The user wants to test/simulate a payment in sandbox mode. Simulate a payment for testing. Create an order first using create_order. NEXT: Call fetch_simulation(simulation_id) to check the simulation result.