How to Use the Hyperswitch MCP in Cline

Q: Can Cline process refunds via Hyperswitch?

Yes, Cline uses getrefund or listrefunds to find transaction histories. The agent reads the refund details so you can verify the status of any customer return.

Let Cline build payment dashboards and audit transactions using the Hyperswitch MCP Server.

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 Cline

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build live payment dashboards in Cline

`list_payments` feeds live Hyperswitch transaction states directly into Cline so the agent can build real-time UI components inside VS Code. The extension writes the React code, imports the payment data, and displays your active volume. You avoid writing boilerplate fetch requests because Cline uses `get_payment` to populate individual Hyperswitch transaction detail pages.

Manage payouts directly with this MCP Server

`list_payouts` gives Cline direct access to your active Hyperswitch merchant disbursement history. The VS Code agent inspects payout schedules to alert you when transfers get delayed by upstream banks. By invoking `get_payout`, your Cline agent verifies the exact status of a stuck Hyperswitch transfer. This keeps you from opening separate dashboard tabs inside VS Code.

Track chargeback disputes instantly

`list_disputes` helps Cline identify which Hyperswitch processors are triggering high fraud rates. The VS Code agent parses these dispute records to spot patterns in buyer behavior. Using `get_dispute`, Cline pulls the specific evidence files needed to respond to a Hyperswitch chargeback. You get the raw gateway responses directly in the Cline sidebar.

Setup guide

Set up Hyperswitch MCP in Cline

Prerequisites

VS Code with Cline extension installed
Active Vinkius subscription with a valid endpoint token

1

Open Cline MCP settings

Click the Cline icon in the VS Code sidebar to open the Cline panel. Then click the MCP Servers icon (server stack) at the top-right corner of the panel.
2

Add a remote server

Click "Remote Servers" at the top, then click "Add Remote MCP". In the Name field, type hyperswitch-mcp. In the URL field, paste your Vinkius endpoint: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp. Get your token from cloud.vinkius.com.
3

Enable the server

After saving, the server appears in the Cline MCP panel. Toggle the switch to enable it. The status indicator turns green when the connection is live.
4

Start using tools

Return to the Cline chat and ask: "Check my latest Hyperswitch refund status." Cline will discover the available tools and request your approval before invoking each one — giving you full control over every action.

Cline MCP Settings

{
  "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 Cline

No, you'll need to configure the server first. Once added to your MCP settings, Cline calls the tools to pull payment records directly.

You supply your API token in the Cline MCP settings file. The client securely attaches this token to every payment query it makes.

Yes, Cline uses `get_refund` or `list_refunds` to find transaction histories. The agent reads the refund details so you can verify the status of any customer return.

No, you'll simply ask the agent to run a query. It executes the tool in the background and displays the raw JSON payload.

All transaction and dispute data remains encrypted during transit. The connection runs through Vinkius's zero-trust gateway, keeping your credentials hidden from the model.

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