Mansa African Financial Reference Data
RemoteAbout Mansa African Financial Reference Data
Mansa African Financial Reference Data is a hosted MCP server for agents that need African financial reference data. It covers bank and SWIFT/BIC lookups, Nigerian NUBAN checksum resolution, phone networks, holidays, and currencies, without requiring an API key.
Key features
- 01Look up banks by name or code
- 02List banks by country
- 03Check NUBAN checksum compatibility
- 04Identify mobile network operators
- 05Retrieve public holidays by country and year
- 06Fetch ISO 4217 currency records
Use cases
- 01Identify a bank from a SWIFT/BIC code
- 02Narrow down banks compatible with a NUBAN number
- 03Determine a phone number's mobile network
- 04Retrieve country holidays or currency details
MCP support
The hosted MCP server exposes six financial reference-data tools to MCP clients over stateless Streamable HTTP at https://mansaapi.com/api/mcp. No API key is required.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mansaapi.com/api/mcpclaude mcp add --transport http heyzod-mansa-african-identity https://mansaapi.com/api/mcp{"mcpServers":{"heyzod-mansa-african-identity":{"type":"http","url":"https://mansaapi.com/api/mcp"}}}Open in Cursor{"servers":{"heyzod-mansa-african-identity":{"type":"http","url":"https://mansaapi.com/api/mcp"}}}Open in VS Code{"mcpServers":{"heyzod-mansa-african-identity":{"type":"http","url":"https://mansaapi.com/api/mcp"}}}{"mcpServers":{"heyzod-mansa-african-identity":{"serverUrl":"https://mansaapi.com/api/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
6| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | number | No | Max results (default 10, max 50). |
| query | string | Yes | Bank name, bank/sort code, SWIFT/BIC code, or USSD shortcode. |
| country | string | No | Optional ISO-2 country code to scope the search (e.g. NG, GH, KE, ZA, TZ). |
Details
From the project READMEMansa African Financial Reference Data — MCP Server
A Model Context Protocol server giving any MCP-capable agent live access to African financial reference data: bank and SWIFT/BIC codes, NUBAN account resolution, mobile network lookup, public holidays, and ISO 4217 currencies.
Hosted and maintained by Mansa API. No API key required.
Connect
Streamable HTTP endpoint:
https://mansaapi.com/api/mcp
Claude Desktop
{
"mcpServers": {
"mansa-african-identity": {
"type": "http",
"url": "https://mansaapi.com/api/mcp"
}
}
}
Anything else
Point your MCP client at the URL above. The server speaks JSON-RPC 2.0 over Streamable HTTP and is
stateless, so no session handling is required. A plain GET returns the server descriptor.
Tools
| Tool | What it does |
|---|---|
lookup_bank | Identify an African bank from a name, bank/sort code, SWIFT/BIC or USSD shortcode. Works as a reverse lookup — pass a bare code like NLCBTZTX and get the institution back. |
list_banks | Every bank held for a country, with codes and mobile-money flag. |
resolve_nuban | Which Nigerian banks a 10-digit NUBAN account number is checksum-valid for. Typically narrows ~30 banks to ~3. |
lookup_phone_network | Resolve an African phone number to its mobile network operator. |
get_public_holidays | Public holidays for a country and year. English by default, with lang for local languages. |
get_currency | ISO 4217 record: code, name, symbol, decimal places, and every country using it. |
Coverage
Nigeria, Ghana, Kenya, South Africa, Egypt, Morocco, Zambia and Tanzania for banks and mobile networks; holidays and currencies span the wider continent.
Worth knowing
resolve_nuban confirms checksum validity only. The CBN NUBAN check digit is derived from the
bank code plus the first nine digits of the account number, so testing a number against every bank
code narrows down where it could be held — without contacting any bank.
It does not confirm that an account exists, and it never returns an account holder's name. That requires a licensed NIBSS account-name enquiry.
Related
Mansa API also publishes io.github.HeyZod/mansa-african-markets
for live African stock market data — a separate server with a different audience.
- API documentation: https://mansaapi.com/docs
- OpenAPI spec: https://mansaapi.com/openapi.json
- Postman collection: https://mansaapi.com/docs/postman
License
MIT for this manifest. The hosted service is governed by the Mansa API terms.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.