Setup MCP Server

Set up the Hyperswitch MCP server to enable AI clients to search docs and explore Sandbox APIs safely

This MCP server is only meant for product exploration while using sandbox environment. DO NOT USE Juspay Hyperswitch API Key from the PRODUCTION ENVIRONMENT.

Prerequisites: Ensure you have an MCP client installed (Cursor, Claude Desktop, Cline, etc.)

MCP URL: https://api-reference.hyperswitch.io/mcp

Step 1: Configure the Hyperswitch-Mintlify MCP server

Hyperswitch's Mintlify MCP server lets your AI client search Hyperswitch docs and safely explore Sandbox APIs as tools (e.g., create a payment and get a 3DS/redirect URL).

Recommended: Claude Code

Add it via CLI:

claude mcp add --transport http mint-hyperswitch https://api-reference.hyperswitch.io/mcp

On successfully adding this, you should see this output in CLI:

Adding MCP server

Run claude and verify if MCP was configured properly using /mcp. You should see an output similar to:

Verifying the MCP server

For configuring other MCP clients (Cursor / Claude Desktop / etc.)

Follow Mintlify's client-specific setup guide using the same MCP: https://api-reference.hyperswitch.io/mcp

Step 2: Make your first payment

Paste below prompt in your AI client after replacing with your sandbox API_KEY:

Make a 100 EUR payment via Hyperswitch V1 in sandbox.
Sandbox API key: <YOUR_SANDBOX_API_KEY>

Output:

You can head on to payment section in Hyperswitch Control Center and verify the payment with the time stamp and status as REQUIRES_CUSTOMER_ACTION (depending on the flow you selected - 3DS vs No3DS).

Responses from AI tools can be incorrect, use with caution. and reach out to us on slack for any questions or further support.