MCP server for Interswitch APIs: payments, transfers, Verve cards, airtime, and paycodes.
Copy the AI prompt to install this server into Claude Code, Cursor, or another agent β or use 1-click editor setup below.
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag β we're steadily working through the catalog.
π‘ Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Inspect callable tools, capabilities, and parameters exposed to AI agents by Interswitch MCP Server.
isw_initialize_paymentInitialize a payment request
isw_get_transaction_statusCheck transaction status
isw_get_transaction_by_referenceFetch transaction by reference
isw_create_payment_linkCreate a payment link
isw_initiate_refundInitiate a refund; high-risk write
isw_get_refund_statusCheck refund status
A Model Context Protocol (MCP) server that enables AI assistants to interact with Interswitch APIs for payments, transfers, VAS, cardless paycodes, Transaction Search, Card 360, lending, payouts, agency banking, and fintech card-processing utilities.
[!WARNING] Public Preview: This MCP server is currently in public preview. It supports both Interswitch sandbox and production environments, so use cautiously, start with read-only mode, and report any issues you encounter.
Install and run via npm (recommended):
Or install globally:
Or for local development, clone and build:
Then configure your MCP client to use the server (see Client Integration).
| Environment Variable | Purpose |
|---|---|
INTERSWITCH_CLIENT_ID | Core OAuth2 client ID for payments, transfers, VAS, cardless, lending, transfer service, and payouts |
INTERSWITCH_CLIENT_SECRET | Core OAuth2 client secret |
INTERSWITCH_ENV | API environment: sandbox or production; defaults to sandbox |
INTERSWITCH_READ_ONLY | Set true to block write tools before any API call; defaults to false |
INTERSWITCH_REQUIRE_CONFIRMATION | Compatibility setting. Tool confirmation is enforced by tool mode and risk. |
INTERSWITCH_MERCHANT_CODE | Merchant code for payment operations that require it |
INTERSWITCH_PAYABLE_CODE | Payable code for payment operations that require it |
INTERSWITCH_INITIATING_ENTITY_CODE | Initiating entity code for transfer operations |
INTERSWITCH_TERMINAL_ID | Terminal ID for operations that require terminal identification |
CARD360_CLIENT_ID | Separate Card 360 client ID |
CARD360_CLIENT_SECRET | Separate Card 360 client secret |
CARD360_RSA_PUBLIC_KEY | RSA public key used to encrypt Card 360 PIN payloads locally |
TRANSACTION_SEARCH_CLIENT_ID | Separate Transaction Search client ID |
TRANSACTION_SEARCH_CLIENT_SECRET | Separate Transaction Search client secret |
INTERSWITCH_AGENCY_MERCHANT_ID | Agency Banking merchant identifier |
INTERSWITCH_AGENCY_TERMINAL_ID | Agency Banking terminal identifier |
INTERSWITCH_LEGACY_AUTH_ENABLED | Enables legacy InterswitchAuth-backed flows where supported |
DEBUG | Enables debug logging. Avoid using this in production. |
You can select the API environment with INTERSWITCH_ENV:
INTERSWITCH_ENV=sandboxINTERSWITCH_ENV=productionSecurity note: Production mode uses real Interswitch production endpoints. If
INTERSWITCH_ENV=production, valid production credentials are configured,INTERSWITCH_READ_ONLY=false, and a write tool is called withconfirm: true, the server can make real production API calls.
For safer first-time setup, start in read-only mode:
When you are authorized and ready to allow live writes, set:
The Interswitch MCP Server works with any MCP-compatible client. Below is the standard configuration schema used by most clients (Claude Desktop, ChatGPT Desktop, Cursor, Windsurf, VS Code, Claude Code, etc.).
For npm-installed server:
For production, change the environment values intentionally:
If you've cloned and built the server locally:
[!IMPORTANT] When setting
command: "node", you should ensure you're using Node v18+. If you are using a package manager, you might need to get the path of your Node binary by running this command in your CLI:Linux and MacOS
Windows
Once you have the path, use it as the value of the MCP Server command in the JSON configuration. e.g.,
command: "path/to/installation/bin/node"
| Client | Config file location |
|---|---|
| VS Code | .vscode/mcp.json |
| Claude Desktop | claude_desktop_config.json |
| ChatGPT Desktop | MCP settings in app preferences |
| Cursor | .cursor/mcp.json or global MCP settings |
| Windsurf | MCP configuration in settings |
| Claude Code | ~/.claude/mcp.json or project-level .mcp.json |
The Interswitch MCP Server exposes Interswitch API domains to AI assistants through dedicated MCP tools. The server does not parse an OpenAPI file at runtime; instead, it provides curated, typed tools for the supported Interswitch domains.
Each tool:
| Auth system | Used for |
|---|---|
| OAuth2 Passport | Core payments, transfers, VAS, cardless, lending, transfer service, and payouts |
| Card 360 token manager | Card 360 operations |
| Transaction Search token manager | Transaction Search APIs |
| Legacy InterswitchAuth | Legacy signed request flows where enabled |
| Agency Banking token manager | Agency Banking SOAP/XML token flow |
Factual signals from GitHub, npm, and our automated checks β not a rating.
No reviews yet β be the first to share how this listing worked for you.
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
[](https://allmcps.com/mcp/interswitch-mcp-server)<a href="https://allmcps.com/mcp/interswitch-mcp-server"><img src="https://allmcps.com/api/badge/interswitch-mcp-server?style=directory" alt="Interswitch MCP Server on AllMCPs" /></a>