How to Use the Razorpay MCP in Pydantic AI

Q: How do I configure the Razorpay MCP Server in Pydantic AI?

Install pydantic-ai-slimmcp and use the MCPToolset class pointing to your Vinkius HTTP endpoint. Pass the toolset instance directly into your Pydantic AI Agent definition to give it access to Razorpay tools like listpayments.

Q: How does Pydantic AI prevent malformed Razorpay order creation?

Pydantic AI validates the arguments for createorder against the MCP Server schema at runtime. If the model attempts to pass a float instead of an integer subunit amount, the Pydantic AI framework blocks the Razorpay call before it hits the API.

Q: Is the MCPServerHTTP class deprecated for Pydantic AI Razorpay MCP Server integrations?

Yes. You should use the unified MCPToolset approach instead of the deprecated MCPServerHTTP class to connect your Pydantic AI agent to the Razorpay MCP Server tools.

Build type-safe Pydantic AI agents that interact with Razorpay APIs with strict runtime validation.

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

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-safe ledger lookups with Pydantic AI

Pydantic AI enforces strict type safety at the agent boundary, validating every payload returned from Razorpay. When your Pydantic AI agent queries `list_payments` or `get_payment`, the framework validates the Razorpay response fields at runtime. If the Razorpay API returns an unexpected null value, the Pydantic AI agent fails immediately instead of executing downstream logic. This is crucial for Razorpay financial tasks where a single malformed field can break Pydantic AI accounting structures.

Validated order and customer creation

Creating Razorpay records requires exact inputs, which Pydantic AI handles by validating arguments before hitting the API. The Pydantic AI agent uses `create_customer` to register new Razorpay clients and `create_order` to set up payments. Because the MCP Server requires Razorpay amounts in subunits, Pydantic AI validates that these values are strictly integers. The Pydantic AI agent then verifies the created Razorpay order using `get_order` to ensure absolute alignment.

Strict subscription and refund auditing

Your Pydantic AI agent audits recurring Razorpay revenue streams without risking silent runtime errors. The Pydantic AI agent queries `list_subscriptions` to track active Razorpay plans and `list_invoices` to check balances. When handling Razorpay disputes, the Pydantic AI agent calls `list_refunds` and `list_settlements` to reconcile account balances. Every Razorpay step is validated against Pydantic models, ensuring your automated reports in Pydantic AI are correct.

Setup guide

Set up Razorpay MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "razorpay-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to Razorpay tools.",
)

result = await agent.run("List recent Razorpay transactions")
print(result.output)

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

Install `pydantic-ai-slim[mcp]` and use the `MCPToolset` class pointing to your Vinkius HTTP endpoint. Pass the toolset instance directly into your Pydantic AI `Agent` definition to give it access to Razorpay tools like `list_payments`.

Pydantic AI validates the arguments for `create_order` against the MCP Server schema at runtime. If the model attempts to pass a float instead of an integer subunit amount, the Pydantic AI framework blocks the Razorpay call before it hits the API.

Yes. By combining Pydantic AI's strict type validation with Razorpay tools like `list_refunds` and `list_settlements`, you ensure that your agent only processes structured, validated transaction payloads without risking silent data corruption.

Yes. You should use the unified `MCPToolset` approach instead of the deprecated `MCPServerHTTP` class to connect your Pydantic AI agent to the Razorpay MCP Server tools.

Vinkius manages your Razorpay credentials securely inside an isolated sandbox environment. The Pydantic AI agent only receives validated JSON schemas for subscription data, refunds, and transfer histories, ensuring raw credentials never leak.

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