How to Use the Razorpay MCP in Mastra AI

Q: Can Mastra AI handle conditional branching for Razorpay payments?

Yes. You can build workflows that check getpayment and branch based on whether the transaction is captured, authorized, or failed.

Q: How do retries work for Razorpay order failures in Mastra AI?

Mastra AI uses its built-in workflow engine to retry createorder calls with exponential backoff if Razorpay endpoints experience transient downtime.

Q: Can I require human approval before creating customers?

Yes. You can use the requireToolApproval option in Mastra to intercept createcustomer calls before they run.

Q: Does Mastra AI store my Razorpay API keys or invoice data?

No. All API keys and invoice details retrieved via listinvoices pass through memory-only execution. The Vinkius MCP sandbox destroys the container immediately after the tool runs.

Build resilient payment workflows that auto-retry Razorpay settlements and orders using Mastra AI and MCP.

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 Mastra AI

Create your Vinkius account to connect Razorpay to Mastra AI 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 Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated recovery of failed settlements

The `list_settlements` tool monitors your incoming merchant payouts automatically. Mastra AI uses this tool to check for failed settlement cycles and triggers backoff retries without human intervention. If a settlement delay occurs, your workflow branches immediately. The agent runs `list_transfers` to verify if funds were routed to sub-accounts, then alerts your finance team.

Multi-step refund workflows in Mastra AI

The `list_refunds` tool retrieves historical refund data to verify customer claims. Mastra AI coordinates this tool with your internal database to prevent double-refund issues. When a customer requests money back, the agent checks `get_payment` first. If the transaction is captured, the workflow automatically initiates the refund process and logs it.

Human-in-the-loop validation for Razorpay MCP Server

The `create_order` tool creates payment records but requires strict validation for high-value transactions. Mastra AI pauses the workflow and requests admin approval before executing the tool. This safeguard protects your merchant account from unauthorized charges. Once approved, the agent executes `create_customer` and finishes the checkout pipeline safely.

Setup guide

Set up Razorpay MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Razorpay tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "razorpay-mcp-client",
  servers: {
    "razorpay-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Razorpay Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Razorpay tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Razorpay transactions"
);
console.log(result.text);

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 Mastra AI

Install the Mastra MCP package and register the server URL. Your Mastra AI agent will auto-detect the tools and expose them to your workflows.

Yes. You can build workflows that check `get_payment` and branch based on whether the transaction is captured, authorized, or failed.

Mastra AI uses its built-in workflow engine to retry `create_order` calls with exponential backoff if Razorpay endpoints experience transient downtime.

Yes. You can use the `requireToolApproval` option in Mastra to intercept `create_customer` calls before they run.

No. All API keys and invoice details retrieved via `list_invoices` pass through memory-only execution. The Vinkius MCP sandbox destroys the container immediately after the tool runs.

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