Razorpay MCP. Manage Orders, Payments, and Refunds from Chat.
Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Razorpay manages your entire payment lifecycle within any AI agent. Use this server to create orders, manage customer records, track settlements, and process refunds—all from a single conversation.
It gives you direct control over payments, ensuring accurate financial data without switching between apps.
What your AI agents can do
Create customer
Adds a new customer record into your payment system's database.
Create order
Generates a new, active payment order for a specified amount.
Get order
Retrieves all specific details about an existing payment order.
Create new customer accounts or list all existing customers to maintain an accurate contact database.
Programmatically create payment orders for specific amounts, initiating the transaction flow.
Retrieve detailed metadata on any specific payment to confirm success or identify failure points.
List all processed refunds or fetch details for payments that failed, speeding up reconciliation.
Access and list settlements, invoices, subscriptions, and bank transfers to reconcile revenue streams.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 CompatibleWaiting for input…
Razorpay MCP Server: 12 Tools for Payment & Order Mgmt
These tools let you manage the entire payment lifecycle—from creating a new customer to settling funds—all through natural language commands.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Razorpay on Vinkius019dd147create customer
Adds a new customer record into your payment system's database.
019dd147create order
Generates a new, active payment order for a specified amount.
019dd147get order
Retrieves all specific details about an existing payment order.
019dd147get payment
Fetches the full status and metadata for a single, completed payment transaction.
019dd147list customers
Retrieves a list of all customer accounts associated with your Razorpay dashboard.
019dd147list invoices
Gets a complete listing of generated invoices and their current status.
019dd147list orders
Retrieves a list of all payment orders that have been created on the platform.
019dd147list payments
Lists every recorded payment transaction, providing an overview of recent activity.
019dd147list refunds
Shows a record of all processed refunds and their associated amounts.
019dd147list settlements
Retrieves records showing funds that have been successfully transferred to your bank account.
019dd147list subscriptions
Lists all active and paused recurring billing plans set up in the system.
019dd147list transfers
Shows a record of internal or external fund transfers initiated through Razorpay.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Razorpay, then connect any of our 4,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Razorpay. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 12 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Tracking payments means logging into five different portals today.
Right now, tracking an order’s status requires a painful dance: you check the e-commerce platform for the initial payment. Then, you switch to the gateway dashboard to see if the money was captured. If it failed, you open your CRM just to confirm the customer details, and finally, you jump into a separate reconciliation tool to track the settlement.
With this MCP server, those five clicks disappear. You simply tell your agent: 'Show me the full lifecycle for Order #123.' The agent runs `get_order`, checks `list_payments` status, and verifies customer details via `get_customer`. It gives you a single, comprehensive report.
Razorpay MCP Server: Manage Payments & Orders
The hardest parts of payments are refunds and recurring billing. Manually issuing a refund means logging in, finding the original transaction ID, calculating the new amount, and submitting the request. Tracking subscriptions requires checking multiple date fields and invoice statuses.
Now, you just say: 'Refund $50 for Invoice #INV-456.' The agent calls `list_refunds` to check limits and then executes the refund via the API. It’s instant, accurate, and never requires navigating a single dashboard.
What you can do with this MCP connector
Razorpay lets your AI client take full command of every payment operation. You'll use this server to create orders, manage customer records, track settlements, and process refunds—all from a single chat session. It gives you direct control over payments, so you never have to jump between apps just to check a balance.
Customer Profile Management
To keep your contact database clean, use the create_customer tool to add new customer records into your payment system's database. You can also run list_customers whenever you need a comprehensive list of all existing accounts associated with your Razorpay dashboard.
Executing Payments and Orders
When you're ready for money to move, start by running the create_order tool; this generates a new, active payment order for a specific amount. You can then use get_order to pull all details about that exact payment order. Once the transaction is done, get_payment fetches the full status and metadata for any single completed payment.
Tracking Transactions and Statuses
You need visibility into what happened with money? The server lets you run list_payments, which gives an overview of every recorded payment transaction. You can also use list_orders to get a simple list of all payment orders created on the platform, while get_payment confirms the status and metadata for any specific, single payment.
Financial Reconciliation Tools
Reconciling revenue streams is where this server shines. Use list_settlements to retrieve records showing funds successfully transferred into your bank account. For recurring income, you can run list_subscriptions to see all active and paused billing plans set up in the system, plus list_invoices gives a complete listing of generated invoices and their current status.
To track internal and external money movement, use list_transfers to show records of any fund transfers initiated through Razorpay. You can also check your overall financial picture by running list_payments, which details all recorded transactions.
Handling Refunds and Failures
If a payment needs reversing or correcting, you've got coverage. Run list_refunds to show a record of every processed refund and the amounts associated with them. You can also use general payment listing tools to identify failure points, speeding up your reconciliation process when things don't go as planned.
This server gives you direct access to everything: from building customer profiles and initiating payments to checking settlements, invoices, and refunds—it keeps all that financial data right where you need it.
019dd147-ff7a-739d-96a5-c6078713081e How Razorpay MCP Works
- 1 Subscribe to the server on Vinkius. Input your Razorpay Key ID and Key Secret from your payment dashboard.
- 2 Direct your AI client (Claude, Cursor, etc.) to execute a task: 'List all payments for Q3.'
- 3 The agent calls the necessary tools (e.g.,
list_payments), processes the data, and returns a summarized report or structured JSON output.
The bottom line is you treat your payment dashboard like a chat conversation; your AI client runs the background API calls for you.
Who Is Razorpay MCP For?
This is built for anyone whose job involves money moving, but who hates context switching. Think e-commerce operators stuck toggling between Stripe/PayPal and their CRM, or finance analysts manually reconciling settlements across spreadsheets at the end of the month.
Needs to check if a payment went through after an order is placed. They use get_order and list_payments instantly, without opening the storefront admin panel.
Responsible for reconciling accounts. They run list_settlements, list_invoices, and track refunds to ensure the books match the bank statements.
Needs to integrate payment logic or test failure paths. They use tools like create_order and get_payment directly within their coding environment for real-time data validation.
What Changes When You Connect
- Eliminate dashboard hopping. Instead of switching between your CRM, payment portal, and accounting software to track a refund, you use
list_refundsdirectly via chat. - Automate reconciliation checks. You can ask the agent to combine data from
list_settlements,list_invoices, andlist_payments—getting one comprehensive financial summary instantly. - Speed up checkout processes. Use
create_orderto build payments programmatically, skipping manual form entry and reducing customer friction. - Improve account oversight. The ability to run
list_subscriptionsmeans you always know which recurring revenue streams are active or need attention. - Deep payment visibility. When a transaction fails, instead of guessing, the agent can call
get_paymentto give you the exact technical reason for the failure.
Real-World Use Cases
Handling a High-Value Refund
A customer claims they were overcharged. Instead of manually searching through multiple transaction logs, the ops manager asks their agent to run list_payments and then use get_payment on the specific ID. The agent confirms the exact amount charged and initiates the refund process via the API.
Monthly Financial Audit
The finance team needs to confirm total revenue for the month, broken down by payment type. They ask the agent to cross-reference list_settlements (what hit the bank) against list_payments (what was actually paid), ensuring no discrepancies exist before closing books.
Onboarding a New Client
A sales rep needs to set up billing for a new client. Instead of creating accounts in two different systems, they ask the agent to run create_customer first, and then immediately use that ID to create_order, completing the payment flow in minutes.
Investigating Failed Payments
A customer reports a failed purchase. The developer asks their AI client to check the status using get_payment. The agent returns not just 'failed,' but the specific error code and reason, allowing the developer to fix the front-end payment logic immediately.
The Tradeoffs
Manual Status Checking
Waiting for a spreadsheet update or manually logging into three different dashboards (payments, orders, settlements) just to figure out where the money went.
→
Don't check dashboards. Use list_settlements and list_payments. Ask your agent: 'Show me all funds settled between X date and Y date.' It consolidates the data for you.
Over-relying on Customer IDs
Trying to manually match a customer name from an email with a payment ID, risking human error when dealing with hundreds of records.
→
Use list_customers first to verify the account exists. Then use the resulting unique ID in combination with get_payment for reliable data retrieval.
Assuming Transactions are Finalized
Thinking a payment is complete just because it appears on one screen, without checking if the funds have actually been settled to the bank account.
→
Always confirm settlement status. Run list_settlements to see exactly when and how much money hit your actual bank account.
When It Fits, When It Doesn't
Use this server if your payment workflow involves multiple, dependent steps: creating a customer, generating an order, tracking its payment, and then potentially issuing a refund or checking settlement. You need transactional integrity across different stages.
Don't use it if you only need to check one simple piece of data (e.g., 'What is the price of product X?'). For single-read operations that don't involve transaction states, a dedicated database read API will be faster and simpler. Use this when state management—the journey of money—is key.
Common Questions About Razorpay MCP
How do I list all payments using the Razorpay MCP Server? +
Run list_payments. This tool gives you an overview of every payment transaction. You can then use get_payment with a specific ID to get deep details on any single transaction.
What is the best way to handle refunds with list_refunds? +
Use list_refunds first to see all past actions. If you need to process one, your agent can guide you through the steps using the necessary IDs.
Can I check my recurring billing plans with list_subscriptions? +
Yes, list_subscriptions pulls a report of all active and paused subscription plans. This helps you monitor where your stable, predictable revenue comes from.
How do I create an order using the Razorpay MCP Server? +
Use create_order. You must provide the exact amount in the smallest currency unit (e.g., cents). This tool kicks off the payment process.
How do I use the list_settlements tool to track my actual payouts? +
The list_settlements tool tracks when Razorpay sends money to your bank. It provides critical details like settlement dates, total amounts received, and any associated transaction fees for reconciliation.
What specific information does the get_payment tool return about a single order? +
It returns granular data on one payment ID. You get the real-time status (authorized, captured, failed), total amount, and which payment method was used, confirming if an order succeeded or needs manual follow-up.
If I need to check existing user records, how do I use the list_customers tool? +
You run list_customers to pull your full database of contacts. Your agent can search by name or ID, allowing you to maintain accurate customer records without switching apps.
How does the list_transfers tool help me track money movement? +
The list_transfers tool shows funds moving between accounts outside of core payments. This is key for tracking payouts or internal credits, giving you a complete picture of your financial flow.
Can my AI automatically find the details for a specific payment just by providing its ID? +
Yes! Use the get_payment tool with the Payment ID. Your agent will respond with complete metadata, including capture status, refund history, and customer notes in seconds.
How do I find my Razorpay Key ID and Key Secret? +
Log in to your Razorpay dashboard, navigate to Settings > API Keys, and generate a new key pair. You will see the Key ID immediately and must download the Key Secret.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.