Mansa African Financial Reference Data

Working · 2.2 s

io.github.HeyZod/mansa-african-identityv1.0.0

African bank & SWIFT codes, NUBAN resolution, mobile networks, holidays and ISO 4217 currencies.

Finance & Payments

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mansaapi.com/api/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

get_currency

Return the ISO 4217 record for a currency: its code, name, symbol, how many decimal places it uses, and every country that uses it.

codestring, required

ISO 4217 currency code, e.g. NGN, KES, XAF, ZAR.

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (6)

get_currency

Return the ISO 4217 record for a currency: its code, name, symbol, how many decimal places it uses, and every country that uses it.

Argument	Type	Description
code*	string	ISO 4217 currency code, e.g. NGN, KES, XAF, ZAR.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "description": "ISO 4217 currency code, e.g. NGN, KES, XAF, ZAR."
    }
  }
}

get_public_holidays

Return the public holidays for a country and calendar year, with each holiday's date, name and type. Names are returned in English wherever the country publishes it; pass a language code for others (Kenya also publishes Swahili).

Argument	Type	Description
lang	string	Optional language code for holiday names, e.g. 'sw' for Swahili.
year*	number	Four-digit calendar year, e.g. 2026.
country*	string	ISO-2 country code, e.g. NG, KE, GH, ZA.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "country",
    "year"
  ],
  "properties": {
    "lang": {
      "type": "string",
      "description": "Optional language code for holiday names, e.g. 'sw' for Swahili."
    },
    "year": {
      "type": "number",
      "description": "Four-digit calendar year, e.g. 2026."
    },
    "country": {
      "type": "string",
      "description": "ISO-2 country code, e.g. NG, KE, GH, ZA."
    }
  }
}

list_banks

List every bank and financial institution held for a country, with its bank code, SWIFT/BIC, USSD shortcode and mobile-money flag. Use this to build a bank picker or to reconcile a list of institutions.

Argument	Type	Description
country*	string	ISO-2 country code, e.g. NG, GH, KE, ZA, EG, MA, ZM, TZ.
mobile_money_only	boolean	Return only mobile-money providers (default false).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "country"
  ],
  "properties": {
    "country": {
      "type": "string",
      "description": "ISO-2 country code, e.g. NG, GH, KE, ZA, EG, MA, ZM, TZ."
    },
    "mobile_money_only": {
      "type": "boolean",
      "description": "Return only mobile-money providers (default false)."
    }
  }
}

lookup_bank

Identify an African bank from any identifier you hold: its name, domestic sort/bank code, SWIFT/BIC code, or USSD shortcode. Works as a reverse lookup, so pass a bare SWIFT code like 'NLCBTZTX' to find out which institution it belongs to. Returns the bank's name, country, type, bank code, SWIFT/BIC, USSD shortcode and whether it supports mobile money.

Argument	Type	Description
limit	number	Max results (default 10, max 50).
query*	string	Bank name, bank/sort code, SWIFT/BIC code, or USSD shortcode.
country	string	Optional ISO-2 country code to scope the search (e.g. NG, GH, KE, ZA, TZ).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max results (default 10, max 50)."
    },
    "query": {
      "type": "string",
      "description": "Bank name, bank/sort code, SWIFT/BIC code, or USSD shortcode."
    },
    "country": {
      "type": "string",
      "description": "Optional ISO-2 country code to scope the search (e.g. NG, GH, KE, ZA, TZ)."
    }
  }
}

lookup_phone_network

Resolve an African phone number to its mobile network operator from the number's prefix. Accepts local or international format. Useful for routing a mobile-money payout to the right provider or validating a number before sending an OTP.

Argument	Type	Description
phone*	string	Phone number, local (08031234567) or international (+2348031234567).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "phone"
  ],
  "properties": {
    "phone": {
      "type": "string",
      "description": "Phone number, local (08031234567) or international (+2348031234567)."
    }
  }
}

resolve_nuban

Work out which Nigerian banks a 10-digit NUBAN account number could belong to. The CBN check digit is computed from the bank code plus the first nine digits, so testing the number against every bank code narrows a shortlist without contacting any bank. Typically reduces ~30 banks to ~3. This confirms checksum validity only: it does NOT confirm the account exists, and it never returns the account holder's name, which requires a licensed NIBSS account-name enquiry.

Argument	Type	Description
account*	string	The 10-digit Nigerian account number.
bank_code	string	Optional. If given, validate against just this bank code instead of scanning all.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "account"
  ],
  "properties": {
    "account": {
      "type": "string",
      "description": "The 10-digit Nigerian account number."
    },
    "bank_code": {
      "type": "string",
      "description": "Optional. If given, validate against just this bank code instead of scanning all."
    }
  }
}