Interswitch MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DEBUG | No | Enables debug logging. Avoid using this in production. | |
| INTERSWITCH_ENV | No | API environment: sandbox or production | sandbox |
| CARD360_CLIENT_ID | No | Separate Card 360 client ID | |
| CARD360_CLIENT_SECRET | No | Separate Card 360 client secret | |
| INTERSWITCH_CLIENT_ID | Yes | Core OAuth2 client ID for payments, transfers, VAS, cardless, lending, transfer service, and payouts | |
| INTERSWITCH_READ_ONLY | No | Set true to block write tools before any API call | false |
| CARD360_RSA_PUBLIC_KEY | No | RSA public key used to encrypt Card 360 PIN payloads locally | |
| INTERSWITCH_TERMINAL_ID | No | Terminal ID for operations that require terminal identification | |
| INTERSWITCH_PAYABLE_CODE | No | Payable code for payment operations that require it | |
| INTERSWITCH_CLIENT_SECRET | Yes | Core OAuth2 client secret | |
| INTERSWITCH_MERCHANT_CODE | No | Merchant code for payment operations that require it | |
| TRANSACTION_SEARCH_CLIENT_ID | No | Separate Transaction Search client ID | |
| INTERSWITCH_AGENCY_MERCHANT_ID | No | Agency Banking merchant identifier | |
| INTERSWITCH_AGENCY_TERMINAL_ID | No | Agency Banking terminal identifier | |
| INTERSWITCH_LEGACY_AUTH_ENABLED | No | Enables legacy InterswitchAuth-backed flows where supported | |
| INTERSWITCH_REQUIRE_CONFIRMATION | No | Compatibility setting. Tool confirmation is enforced by tool mode and risk. | |
| TRANSACTION_SEARCH_CLIENT_SECRET | No | Separate Transaction Search client secret | |
| INTERSWITCH_INITIATING_ENTITY_CODE | No | Initiating entity code for transfer operations |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| isw_initialize_paymentC | Initialize a Quickteller payment. Provide amountNaira or amountKobo explicitly; endpoint receives kobo. Requires confirm: true. |
| isw_get_transaction_statusC | Get Quickteller transaction status by transactionRef. |
| isw_get_transaction_by_referenceC | Get Quickteller transaction by transactionRef query. |
| isw_create_payment_linkA | Create a shareable payment link. Provide amountNaira or amountKobo explicitly; endpoint receives kobo. Requires confirm: true. |
| isw_initiate_refundA | Initiate a refund for a settled transaction. High-risk write operation; requires confirm: true. |
| isw_get_refund_statusC | Get refund status by refundRef. |
| isw_pay_billB | Pay a bill through the payment route. Provide amountNaira or amountKobo explicitly; endpoint receives kobo. Requires confirm: true. |
| isw_get_billersC | List Quickteller billers, optionally filtered by categoryId. |
| isw_get_biller_packagesC | List packages for a biller. |
| isw_get_billers_by_categoryC | List VAS billers by category. |
| isw_get_biller_detailsB | Get VAS biller details by billerId. |
| isw_validate_customerC | Validate a customer account, meter, or phone number for a biller. |
| isw_pay_vas_billB | Pay a VAS bill. Provide amountNaira or amountKobo explicitly. Requires confirm: true. |
| isw_airtime_rechargeC | Top up a phone number through VAS airtime. Requires confirm: true. |
| isw_get_airtime_epinsC | Purchase airtime e-pins. Requires confirm: true. |
| isw_single_transferB | Send money to a bank account. High-risk financial operation; requires confirm: true. Provide amountNaira or amountKobo explicitly. |
| isw_bulk_transferA | Send money to multiple bank accounts. High-risk financial operation; requires confirm: true. Max 100 transactions. |
| isw_resolve_bank_accountC | Resolve account name before transfer. |
| isw_get_bank_codesB | List supported bank codes for transfers. |
| isw_agency_banking_cashoutC | Perform agency banking cashout. High-risk financial operation; requires confirm: true. |
| isw_create_paycodeC | Create a cardless withdrawal paycode. Requires confirm: true. |
| isw_create_bulk_paycodesA | Create multiple cardless withdrawal paycodes. High-risk batch operation; requires confirm: true. Max 100. |
| isw_get_paycode_statusC | Get status of a generated paycode. |
| isw_deactivate_paycodeA | Deactivate an unused paycode. Requires confirm: true. |
| isw_transaction_search_quick_searchC | Search transactions by amountKobo, terminal, and date range. Dates use YYYY-MM-DD HH:mm:ss. |
| isw_transaction_search_reference_searchC | Search transactions by transaction reference and date range. |
| isw_transaction_search_bulk_searchC | Search multiple transaction references at once. |
| isw_get_transaction_detailsB | Get Transaction Search details by transactionId. |
| isw_create_cardC | Provision a new Verve card through Card 360. Requires confirm: true. |
| isw_retry_card_creationC | Retry a Card 360 card creation request. Requires confirm: true. |
| isw_initiate_card_data_prepC | Initiate Card 360 card data prep. Requires confirm: true. |
| isw_fetch_data_prep_requestC | Fetch Card 360 data prep request by requestRef. |
| isw_fetch_prepared_cardsC | Fetch prepared cards for a data prep request. |
| isw_bulk_card_productionC | Submit Card 360 bulk card production. Requires confirm: true. |
| isw_reissue_card_pinB | Reissue a Card 360 card PIN. The plaintext pin is encrypted locally and never sent. Requires confirm: true. |
| isw_change_card_pinB | Change a Card 360 card PIN. Plaintext PINs are encrypted locally and never sent. Requires confirm: true. |
| isw_get_pinC | Get a card PIN. Sensitive operation; requires confirm: true and redacts sensitive fields. |
| isw_block_cardC | Block a card immediately. Requires confirm: true. |
| isw_unblock_cardC | Unblock a card. Requires confirm: true. |
| isw_block_prepaid_cardB | Block a prepaid card. Requires confirm: true. |
| isw_unblock_prepaid_cardC | Unblock a prepaid card. Requires confirm: true. |
| isw_link_card_to_accountB | Link a Card 360 card to an account. Requires confirm: true. |
| isw_check_prepaid_balanceC | Check prepaid card balance. |
| isw_check_debit_balanceD | Check debit card balance. |
| isw_confirm_prepaid_sufficientC | Confirm prepaid card sufficient balance. Requires confirm: true. |
| isw_confirm_debit_sufficientC | Confirm debit card sufficient balance. Requires confirm: true. |
| isw_fetch_cards_by_issuerC | Fetch cards by issuer number. |
| isw_fetch_single_card_by_panB | Fetch card details by PAN. Sensitive fields are redacted. |
| isw_fetch_cards_by_accountC | Fetch cards linked to an account. |
| isw_fetch_customer_card_detailsC | Fetch customer card details by account. |
| isw_fetch_request_logsC | Fetch Card 360 request logs. |
| isw_validate_cardA | Validate card CVV and expiry. Requires confirm: true. |
| isw_request_nano_loanB | Request a nano loan. High-risk operation creating debt; requires confirm: true. |
| isw_salary_lendingB | Request a salary loan. High-risk operation creating debt; requires confirm: true. |
| isw_value_financingB | Request value financing. High-risk operation creating debt; requires confirm: true. |
| isw_get_customer_demographicsC | Get customer demographic profile. |
| isw_get_financial_historyC | Get customer financial history. |
| isw_get_financial_history_averageC | Get customer average financial history. |
| isw_get_financial_habitsD | Get customer financial habits. |
| isw_credit_inquiryC | Run Transfer Service credit inquiry before bank credit. |
| isw_complete_creditA | Complete bank credit using inquiryRef and OTP. High-risk financial operation; requires confirm: true. |
| isw_requery_transferC | Requery Transfer Service transaction status. |
| isw_get_receiving_institutionsC | List payout receiving institutions. |
| isw_get_payout_channelsB | List available payout channels. |
| isw_fintech_validate_debit_payloadC | Validate incoming Fintech Card Processing debit payload shape. |
| isw_fintech_validate_reversal_payloadC | Validate incoming Fintech Card Processing reversal payload shape. |
| isw_fintech_validate_enquiry_payloadC | Validate incoming Fintech Card Processing enquiry payload shape. |
| isw_fintech_validate_place_lien_payloadC | Validate incoming Fintech Card Processing place-lien payload shape. |
| isw_fintech_validate_debit_lien_payloadC | Validate incoming Fintech Card Processing debit-lien payload shape. |
| isw_fintech_compute_macC | Compute Fintech Card Processing HMAC over ordered fields. |
| isw_fintech_build_responseC | Build a Fintech Card Processing response payload and optional MAC. |
| isw_agency_get_tokenA | Fetch an Agency Banking SOAP token using configured merchant and terminal IDs. Token is redacted in output. |
| isw_agency_cashout_xmlB | Submit raw Agency Banking cashout XML. High-risk financial operation; requires confirm: true. |
| isw_agency_requery_xmlC | Submit raw Agency Banking requery XML. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Interswitch response codes | Global response code reference from INTERSWITCH_MCP_SKILL.md |
| Interswitch MCP config summary | Safe summary of loaded configuration without secrets |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Dairus01/Interswitch-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server