Interswitch Mcp Server
Connects Claude to Interswitch's payment infrastructure across Nigeria and beyond. You get tools for initiating payments, bank transfers, Verve card operations, airtime top-ups, and paycode generation. Supports both sandbox and production environments with a read-only mode for safe testing. The server handles OAuth2 token management internally and exposes separate authentication flows for Card 360, Transaction Search, and Agency Banking domains. Ships with confirmation gates on write operations and credential redaction for sensitive data. Useful if you're building payment workflows, reconciliation systems, or fintech automation where you need programmatic access to Interswitch's APIs without writing integration code yourself.
- GitHub stars
- 1
- tools
- 72
- auth
- Secret needed
- transport
- STDIO
- env vars
- 4
- last updated
- Apr 28, 2026
Tools
72 toolsPublic tool metadata for what this MCP can expose to an agent.
isw_initialize_paymentInitialize a payment request
Initialize a payment request
No parameter schema in public metadata yet.
isw_get_transaction_statusCheck transaction status
Check transaction status
No parameter schema in public metadata yet.
isw_get_transaction_by_referenceFetch transaction by reference
Fetch transaction by reference
No parameter schema in public metadata yet.
isw_create_payment_linkCreate a payment link
Create a payment link
No parameter schema in public metadata yet.
isw_initiate_refundInitiate a refund; high-risk write
Initiate a refund; high-risk write
No parameter schema in public metadata yet.
isw_get_refund_statusCheck refund status
Check refund status
No parameter schema in public metadata yet.
isw_pay_billPay a bill
Pay a bill
No parameter schema in public metadata yet.
isw_get_billersList billers
List billers
No parameter schema in public metadata yet.
isw_get_biller_packagesList packages for a biller
List packages for a biller
No parameter schema in public metadata yet.
isw_get_billers_by_categoryList billers by category
List billers by category
No parameter schema in public metadata yet.
isw_get_biller_detailsFetch biller details
Fetch biller details
No parameter schema in public metadata yet.
isw_validate_customerValidate a biller customer
Validate a biller customer
No parameter schema in public metadata yet.
isw_pay_vas_billPay a VAS bill
Pay a VAS bill
No parameter schema in public metadata yet.
isw_airtime_rechargeRecharge airtime
Recharge airtime
No parameter schema in public metadata yet.
isw_get_airtime_epinsRequest airtime ePINs
Request airtime ePINs
No parameter schema in public metadata yet.
isw_single_transferSend a single bank transfer; high-risk write
Send a single bank transfer; high-risk write
No parameter schema in public metadata yet.
isw_bulk_transferSend bulk transfers; high-risk write; max 100 transactions
Send bulk transfers; high-risk write; max 100 transactions
No parameter schema in public metadata yet.
isw_resolve_bank_accountResolve bank account details
Resolve bank account details
No parameter schema in public metadata yet.
isw_get_bank_codesList supported bank codes
List supported bank codes
No parameter schema in public metadata yet.
isw_agency_banking_cashoutInitiate agency cashout; high-risk write
Initiate agency cashout; high-risk write
No parameter schema in public metadata yet.
isw_create_paycodeCreate a cardless paycode
Create a cardless paycode
No parameter schema in public metadata yet.
isw_create_bulk_paycodesCreate bulk paycodes; high-risk write; max 100 paycodes
Create bulk paycodes; high-risk write; max 100 paycodes
No parameter schema in public metadata yet.
isw_get_paycode_statusCheck paycode status
Check paycode status
No parameter schema in public metadata yet.
isw_deactivate_paycodeDeactivate a paycode
Deactivate a paycode
No parameter schema in public metadata yet.
isw_transaction_search_quick_searchSearch transactions by quick-search fields
Search transactions by quick-search fields
No parameter schema in public metadata yet.
isw_transaction_search_reference_searchSearch by transaction reference
Search by transaction reference
No parameter schema in public metadata yet.
isw_transaction_search_bulk_searchSearch multiple transactions
Search multiple transactions
No parameter schema in public metadata yet.
isw_get_transaction_detailsFetch detailed transaction information
Fetch detailed transaction information
No parameter schema in public metadata yet.
isw_create_cardCreate a card; high-risk write
Create a card; high-risk write
No parameter schema in public metadata yet.
isw_retry_card_creationRetry card creation
Retry card creation
No parameter schema in public metadata yet.
isw_initiate_card_data_prepInitiate card data preparation
Initiate card data preparation
No parameter schema in public metadata yet.
isw_fetch_data_prep_requestFetch a data-prep request
Fetch a data-prep request
No parameter schema in public metadata yet.
isw_fetch_prepared_cardsFetch prepared cards
Fetch prepared cards
No parameter schema in public metadata yet.
isw_bulk_card_productionStart bulk card production; high-risk write
Start bulk card production; high-risk write
No parameter schema in public metadata yet.
isw_reissue_card_pinReissue a card PIN; high-risk write
Reissue a card PIN; high-risk write
No parameter schema in public metadata yet.
isw_change_card_pinChange a card PIN; high-risk write
Change a card PIN; high-risk write
No parameter schema in public metadata yet.
isw_get_pinRetrieve PIN-related response where supported; high-risk read
Retrieve PIN-related response where supported; high-risk read
No parameter schema in public metadata yet.
isw_block_cardBlock a card; high-risk write
Block a card; high-risk write
No parameter schema in public metadata yet.
isw_unblock_cardUnblock a card; high-risk write
Unblock a card; high-risk write
No parameter schema in public metadata yet.
isw_block_prepaid_cardBlock a prepaid card; high-risk write
Block a prepaid card; high-risk write
No parameter schema in public metadata yet.
isw_unblock_prepaid_cardUnblock a prepaid card; high-risk write
Unblock a prepaid card; high-risk write
No parameter schema in public metadata yet.
isw_link_card_to_accountLink a card to an account; high-risk write
Link a card to an account; high-risk write
No parameter schema in public metadata yet.
isw_check_prepaid_balanceCheck prepaid card balance
Check prepaid card balance
No parameter schema in public metadata yet.
isw_check_debit_balanceCheck debit card balance
Check debit card balance
No parameter schema in public metadata yet.
isw_confirm_prepaid_sufficientConfirm prepaid sufficient balance
Confirm prepaid sufficient balance
No parameter schema in public metadata yet.
isw_confirm_debit_sufficientConfirm debit sufficient balance
Confirm debit sufficient balance
No parameter schema in public metadata yet.
isw_fetch_cards_by_issuerFetch cards by issuer
Fetch cards by issuer
No parameter schema in public metadata yet.
isw_fetch_single_card_by_panFetch a single card by PAN with redaction
Fetch a single card by PAN with redaction
No parameter schema in public metadata yet.
isw_fetch_cards_by_accountFetch cards by account
Fetch cards by account
No parameter schema in public metadata yet.
isw_fetch_customer_card_detailsFetch customer card details
Fetch customer card details
No parameter schema in public metadata yet.
isw_fetch_request_logsFetch Card 360 request logs
Fetch Card 360 request logs
No parameter schema in public metadata yet.
isw_validate_cardValidate card data
Validate card data
No parameter schema in public metadata yet.
isw_request_nano_loanRequest a nano loan; high-risk write
Request a nano loan; high-risk write
No parameter schema in public metadata yet.
isw_salary_lendingStart salary lending flow; high-risk write
Start salary lending flow; high-risk write
No parameter schema in public metadata yet.
isw_value_financingStart value financing flow; high-risk write
Start value financing flow; high-risk write
No parameter schema in public metadata yet.
isw_get_customer_demographicsFetch customer demographics
Fetch customer demographics
No parameter schema in public metadata yet.
isw_get_financial_historyFetch customer financial history
Fetch customer financial history
No parameter schema in public metadata yet.
isw_get_financial_history_averageFetch financial-history averages
Fetch financial-history averages
No parameter schema in public metadata yet.
isw_get_financial_habitsFetch customer financial habits
Fetch customer financial habits
No parameter schema in public metadata yet.
isw_credit_inquiryRun credit inquiry
Run credit inquiry
No parameter schema in public metadata yet.
isw_complete_creditComplete credit using OTP; high-risk write
Complete credit using OTP; high-risk write
No parameter schema in public metadata yet.
isw_requery_transferRequery transfer status
Requery transfer status
No parameter schema in public metadata yet.
isw_get_receiving_institutionsList payout receiving institutions
List payout receiving institutions
No parameter schema in public metadata yet.
isw_get_payout_channelsList payout channels
List payout channels
No parameter schema in public metadata yet.
isw_agency_get_tokenFetch/cache Agency Banking token
Fetch/cache Agency Banking token
No parameter schema in public metadata yet.
isw_fintech_validate_debit_payloadValidate debit payload structure
Validate debit payload structure
No parameter schema in public metadata yet.
isw_fintech_validate_reversal_payloadValidate reversal payload structure
Validate reversal payload structure
No parameter schema in public metadata yet.
isw_fintech_validate_enquiry_payloadValidate enquiry payload structure
Validate enquiry payload structure
No parameter schema in public metadata yet.
isw_fintech_validate_place_lien_payloadValidate place-lien payload structure
Validate place-lien payload structure
No parameter schema in public metadata yet.
isw_fintech_validate_debit_lien_payloadValidate debit-lien payload structure
Validate debit-lien payload structure
No parameter schema in public metadata yet.
isw_fintech_compute_macCompute MAC; high-risk because it accepts secrets
Compute MAC; high-risk because it accepts secrets
No parameter schema in public metadata yet.
isw_fintech_build_responseBuild fintech response payload; high-risk when secrets are supplied
Build fintech response payload; high-risk when secrets are supplied
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
INTERSWITCH_CLIENT_ID*Interswitch OAuth2 client ID (from Interswitch Developer Console)
INTERSWITCH_CLIENT_SECRET*secretInterswitch OAuth2 client secret
INTERSWITCH_ENVTarget environment: sandbox (default) or production
INTERSWITCH_READ_ONLYSet to true to block all write/transfer operations
Readme
Interswitch MCP Server
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.
Quick Start
Install and run via npm (recommended):
npx interswitch-mcp-server
Or install globally:
npm install -g interswitch-mcp-server
interswitch-mcp-server
Or for local development, clone and build:
git clone https://github.com/Dairus01/Interswitch-mcp-server.git
cd Interswitch-mcp-server
npm install
npm run build
Then configure your MCP client to use the server (see Client Integration).
Requirements
Details
- Repository
- github.com/dairus01/interswitch-mcp-server
- Package
interswitch-mcp-server- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active