MCP.Market

Interswitch MCP server

by Dairus01·io.github.Dairus01/interswitch-mcp-server·v0.1.3·1 stars
No reviews yet

MCP server for Interswitch APIs: payments, transfers, Verve cards, airtime, and paycodes.

B72/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B72/100

full report

Adoption
New

1 stars79 downloads/wk

Reviews

Write one

Nobody has reviewed Interswitch yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Interswitch tools (74, 16 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • isw_agency_banking_cashout

    Perform agency banking cashout. High-risk financial operation; requires confirm: true.

  • isw_agency_cashout_xmlwrite action

    Submit raw Agency Banking cashout XML. High-risk financial operation; requires confirm: true.

  • isw_agency_get_token

    Fetch an Agency Banking SOAP token using configured merchant and terminal IDs. Token is redacted in output.

  • isw_agency_requery_xmlwrite action

    Submit raw Agency Banking requery XML.

  • isw_airtime_recharge

    Top up a phone number through VAS airtime. Requires confirm: true.

  • isw_block_card

    Block a card immediately. Requires confirm: true.

  • isw_block_prepaid_card

    Block a prepaid card. Requires confirm: true.

  • isw_bulk_card_productionwrite action

    Submit Card 360 bulk card production. Requires confirm: true.

  • isw_bulk_transferwrite action

    Send money to multiple bank accounts. High-risk financial operation; requires confirm: true. Max 100 transactions.

  • isw_change_card_pin

    Change a Card 360 card PIN. Plaintext PINs are encrypted locally and never sent. Requires confirm: true.

  • isw_check_debit_balance

    Check debit card balance.

  • isw_check_prepaid_balance

    Check prepaid card balance.

  • isw_complete_credit

    Complete bank credit using inquiryRef and OTP. High-risk financial operation; requires confirm: true.

  • isw_confirm_debit_sufficient

    Confirm debit card sufficient balance. Requires confirm: true.

  • isw_confirm_prepaid_sufficient

    Confirm prepaid card sufficient balance. Requires confirm: true.

  • isw_create_bulk_paycodeswrite action

    Create multiple cardless withdrawal paycodes. High-risk batch operation; requires confirm: true. Max 100.

  • isw_create_cardwrite action

    Provision a new Verve card through Card 360. Requires confirm: true.

  • isw_create_paycodewrite action

    Create a cardless withdrawal paycode. Requires confirm: true.

  • isw_create_payment_linkwrite action

    Create a shareable payment link. Provide amountNaira or amountKobo explicitly; endpoint receives kobo. Requires confirm: true.

  • isw_credit_inquirywrite action

    Run Transfer Service credit inquiry before bank credit.

  • isw_deactivate_paycode

    Deactivate an unused paycode. Requires confirm: true.

  • isw_fetch_cards_by_account

    Fetch cards linked to an account.

  • isw_fetch_cards_by_issuer

    Fetch cards by issuer number.

  • isw_fetch_customer_card_details

    Fetch customer card details by account.

  • isw_fetch_data_prep_request

    Fetch Card 360 data prep request by requestRef.

  • isw_fetch_prepared_cards

    Fetch prepared cards for a data prep request.

  • isw_fetch_request_logs

    Fetch Card 360 request logs.

  • isw_fetch_single_card_by_pan

    Fetch card details by PAN. Sensitive fields are redacted.

  • isw_fintech_build_response

    Build a Fintech Card Processing response payload and optional MAC.

  • isw_fintech_compute_mac

    Compute Fintech Card Processing HMAC over ordered fields.

  • isw_fintech_validate_debit_lien_payload

    Validate incoming Fintech Card Processing debit-lien payload shape.

  • isw_fintech_validate_debit_payload

    Validate incoming Fintech Card Processing debit payload shape.

  • isw_fintech_validate_enquiry_payload

    Validate incoming Fintech Card Processing enquiry payload shape.

  • isw_fintech_validate_place_lien_payload

    Validate incoming Fintech Card Processing place-lien payload shape.

  • isw_fintech_validate_reversal_payload

    Validate incoming Fintech Card Processing reversal payload shape.

  • isw_get_airtime_epinswrite action

    Purchase airtime e-pins. Requires confirm: true.

  • isw_get_bank_codes

    List supported bank codes for transfers.

  • isw_get_biller_details

    Get VAS biller details by billerId.

  • isw_get_biller_packages

    List packages for a biller.

  • isw_get_billers

    List Quickteller billers, optionally filtered by categoryId.

  • isw_get_billers_by_category

    List VAS billers by category.

  • isw_get_customer_demographics

    Get customer demographic profile.

  • isw_get_financial_habits

    Get customer financial habits.

  • isw_get_financial_history

    Get customer financial history.

  • isw_get_financial_history_average

    Get customer average financial history.

  • isw_get_paycode_status

    Get status of a generated paycode.

  • isw_get_payout_channels

    List available payout channels.

  • isw_get_pin

    Get a card PIN. Sensitive operation; requires confirm: true and redacts sensitive fields.

  • isw_get_receiving_institutions

    List payout receiving institutions.

  • isw_get_refund_statuswrite action

    Get refund status by refundRef.

  • isw_get_transaction_by_reference

    Get Quickteller transaction by transactionRef query.

  • isw_get_transaction_details

    Get Transaction Search details by transactionId.

  • isw_get_transaction_status

    Get Quickteller transaction status by transactionRef.

  • isw_initialize_payment

    Initialize a Quickteller payment. Provide amountNaira or amountKobo explicitly; endpoint receives kobo. Requires confirm: true.

  • isw_initiate_card_data_prep

    Initiate Card 360 card data prep. Requires confirm: true.

  • isw_initiate_refundwrite action

    Initiate a refund for a settled transaction. High-risk write operation; requires confirm: true.

  • isw_link_card_to_account

    Link a Card 360 card to an account. Requires confirm: true.

  • isw_pay_billwrite action

    Pay a bill through the payment route. Provide amountNaira or amountKobo explicitly; endpoint receives kobo. Requires confirm: true.

  • isw_pay_vas_billwrite action

    Pay a VAS bill. Provide amountNaira or amountKobo explicitly. Requires confirm: true.

  • isw_reissue_card_pin

    Reissue a Card 360 card PIN. The plaintext pin is encrypted locally and never sent. Requires confirm: true.

  • isw_requery_transferwrite action

    Requery Transfer Service transaction status.

  • isw_request_nano_loan

    Request a nano loan. High-risk operation creating debt; requires confirm: true.

  • isw_resolve_bank_account

    Resolve account name before transfer.

  • isw_retry_card_creation

    Retry a Card 360 card creation request. Requires confirm: true.

  • isw_salary_lending

    Request a salary loan. High-risk operation creating debt; requires confirm: true.

  • isw_single_transferwrite action

    Send money to a bank account. High-risk financial operation; requires confirm: true. Provide amountNaira or amountKobo explicitly.

  • isw_transaction_search_bulk_search

    Search multiple transaction references at once.

  • isw_transaction_search_quick_search

    Search transactions by amountKobo, terminal, and date range. Dates use YYYY-MM-DD HH:mm:ss.

  • isw_transaction_search_reference_search

    Search transactions by transaction reference and date range.

  • isw_unblock_card

    Unblock a card. Requires confirm: true.

  • isw_unblock_prepaid_card

    Unblock a prepaid card. Requires confirm: true.

  • isw_validate_card

    Validate card CVV and expiry. Requires confirm: true.

  • isw_validate_customer

    Validate a customer account, meter, or phone number for a biller.

  • isw_value_financing

    Request value financing. High-risk operation creating debt; requires confirm: true.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan103 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 144 days ago8/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 72/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Interswitch compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
72/100
higher than 38% of 48,255 servers
Tools
74
the typical server has 7
Tools that change things
22%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
1
more than 65% of 28,688 servers
Downloads a week
79
more than 57% of 12,191 servers with a package

What its tools let an agent do: 58 read · 16 change

Install Interswitch in Claude Code, Cursor or VS Code

Runs npx -y interswitch-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add interswitch-mcp-server -- npx -y interswitch-mcp-server
Add to Cursor

What the publisher says

From the Interswitch repository's README, as published. We do not edit it. Read it on GitHub

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

  • Node.js v18+
  • npm or yarn
  • Interswitch API credentials for the domains you want to use
  • Required Interswitch merchant, payable, initiating entity, terminal, or domain-specific identifiers for your use case

Configuration Options

You can select the API environment with INTERSWITCH_ENV:

  1. Sandbox (default): INTERSWITCH_ENV=sandbox
  2. Production: INTERSWITCH_ENV=production

Security note: Production mode uses real Interswitch production endpoints. If INTERSWITCHENV=production, valid production credentials are configured, INTERSWITCHREAD_ONLY=false, and a write tool is called with confirm: true, the server can make real production API calls.

For safer first-time setup, start in read-only mode:

INTERSWITCH_ENV=production \
INTERSWITCH_READ_ONLY=true \
INTERSWITCH_CLIENT_ID=your_production_client_id \
INTERSWITCH_CLIENT_SECRET=your_production_client_secret \
interswitch-mcp-server

When you are authorized and ready to allow live writes, set:

INTERSWITCH_READ_ONLY=false

Client Integration

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.).

Using npm (recommended)

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Interswitch: common questions

Is Interswitch MCP server safe?
Mostly: it is graded B (72/100). Read the Interswitch safety report
How do I install Interswitch?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Interswitch need an API key?
Yes. The registry entry asks for INTERSWITCH_CLIENT_SECRET.
Is Interswitch maintained?
The last commit was 181 days ago (2026-05-07). The latest release is v0.1.3.
How does Interswitch compare with other MCP servers?
safety score 72/100 (higher than 38% of 48,255 servers); tools 74 (the typical server has 7); tools that change things 22% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.