How to Use the Hyperswitch MCP in Windsurf

Q: Can Windsurf Cascade trigger Hyperswitch refunds?

Yes, Cascade uses getrefund or listrefunds to audit transaction histories. You instruct Cascade to locate a charge, and it will fetch the refund status automatically.

Control your entire payment stack autonomously using the Hyperswitch MCP Server inside Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Hyperswitch MCP to Windsurf

Create your Vinkius account to connect Hyperswitch to Windsurf 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 Hyperswitch with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Auto-resolve disputes in Windsurf

`list_disputes` pulls your active Hyperswitch chargeback list directly into Windsurf so Cascade can match disputes to customer profiles. This custom integration retrieves raw records without forcing you to click around external payment dashboards. Cascade then pulls up individual files using `get_dispute` to verify the exact Hyperswitch reason codes inside your active editor. The autonomous agent chains these checks to flag high-risk accounts before they drain your processor balance.

Chain payments via Windsurf MCP Server

`list_payments` feeds your Hyperswitch transaction logs straight into the active Windsurf IDE window. This means Cascade handles the tedious work of digging up failing charges while you focus on fixing your checkout code. You tell the Windsurf agent to find why a payment failed, and it runs `get_payment` to verify the Hyperswitch gateway response. This cuts out manual Postman runs from your Windsurf setup.

Instantly audit customer accounts

`get_customer` exposes core Hyperswitch billing profiles directly to your Windsurf workspace. Your autonomous agent pulls these customer details to verify who is hitting processing rate limits. If you need a wider view, `list_customers` dumps the latest Hyperswitch sign-ups into the Windsurf context window. This setup lets you identify payment anomalies without leaving your active file.

Setup guide

Set up Hyperswitch MCP in Windsurf

Prerequisites

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

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Hyperswitch MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Hyperswitch payment history." If connected, Cascade will call the Hyperswitch tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "hyperswitch-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 Hyperswitch. 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 Hyperswitch 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 Hyperswitch MCP in Windsurf

You add the server credentials to your Windsurf MCP configuration file. Cascade immediately discovers the payment tools and executes them based on your text prompts.

Yes, Cascade uses `get_refund` or `list_refunds` to audit transaction histories. You instruct Cascade to locate a charge, and it will fetch the refund status automatically.

Cascade handles read actions autonomously once you grant initial permission. You watch the tools run in real-time within your chat panel.

It's simple: the server passes the exact API error code back to your agent. Windsurf reads the failure reason directly and suggests a fix for your payload.

Your customer profiles and transaction histories never pass through external LLM servers. All API requests route directly through an isolated V8 sandbox to the Hyperswitch endpoint.

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