How to Use the Razorpay MCP in Cursor

Q: How do I add the Razorpay MCP Server to my Cursor project?

Create a .cursor/mcp.json file in your repository root and define the MCP server under the mcpServers object. Cursor will automatically detect the configuration and load the tools into your active workspace.

Q: Can Cursor Composer use Razorpay tools in Cursor to write integration tests?

Yes, Cursor Composer calls listpayments and getorder to fetch real payloads. It uses these live structures to write accurate integration tests that match the actual API behavior.

Q: How does the agent handle order creation errors in Cursor?

If createorder returns an API error, Cursor captures the error payload in the terminal. The agent analyzes the response to fix your input parameters, such as correcting currency subunit formatting.

Generate functional code and manage Razorpay payment flows directly inside Cursor using live transaction data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Razorpay MCP to Cursor

Create your Vinkius account to connect Razorpay to Cursor and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Razorpay with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Write code using live Razorpay payment data

The `get_payment` tool pulls live Razorpay transaction details directly into your Cursor Composer session. You don't have to write stubs or guess the Razorpay JSON payload structure when building your checkout logic in Cursor. Your Cursor agent calls `list_payments` to inspect actual Razorpay API responses in real-time. This lets Cursor write accurate Razorpay integration code that matches your live database states.

Generate orders and customers inside Cursor

This MCP Server lets your Cursor editor generate test data using `create_customer` during active coding sessions. You can verify your Razorpay user signup flows in Cursor without leaving your editor. Use `create_order` inside Cursor to generate new Razorpay orders with the correct currency subunit values. Cursor reads the output schema of `get_order` to write precise validation logic for your Razorpay backend services.

Debug Razorpay settlements in the Cursor terminal

The `list_settlements` tool fetches your Razorpay payout history directly into the Cursor terminal interface. You can debug Razorpay reconciliation scripts in Cursor using real transaction data instead of mock objects. Your Cursor agent calls `list_transfers` and `list_subscriptions` to analyze how Razorpay funds move through your system. This helps you write better Razorpay ledger synchronization code directly inside Cursor.

Setup guide

Set up Razorpay MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Razorpay MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Razorpay transactions." If the MCP tools are loaded correctly, Cursor will call the Razorpay tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "razorpay-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Razorpay now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Razorpay MCP in Cursor

Create a `.cursor/mcp.json` file in your repository root and define the MCP server under the `mcpServers` object. Cursor will automatically detect the configuration and load the tools into your active workspace.

Yes, Cursor Composer calls `list_payments` and `get_order` to fetch real payloads. It uses these live structures to write accurate integration tests that match the actual API behavior.

Yes, you can run the server as a local process via standard I/O inside Cursor. This allows the AI agent to execute tools like `list_refunds` and `list_invoices` directly from your machine.

If `create_order` returns an API error, Cursor captures the error payload in the terminal. The agent analyzes the response to fix your input parameters, such as correcting currency subunit formatting.

Yes, all payment amounts, customer records, and refund logs are processed within Cursor's local environment. The MCP setup processes credential management using ephemeral sandboxes, ensuring your API keys are never exposed to external LLM training loops.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript