Mansa African Financial Reference Data
African bank & SWIFT codes, NUBAN resolution, mobile networks, holidays and ISO 4217 currencies.
Open source Repository Open in the app JSON README (API)
About
African bank & SWIFT codes, NUBAN resolution, mobile networks, holidays and ISO 4217 currencies.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- heyzod
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-08-01T03:35:03Z
- Repository state
- ativo
- Added
- 2026-08-29 03:01:57
- Updated
- 2026-08-29 03:01:57
- Origin id
io.github.HeyZod/mansa-african-identity
README
# Mansa African Financial Reference Data — MCP Server
A [Model Context Protocol](https://modelcontextprotocol.io) 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](https://mansaapi.com). **No API key required.**
## Connect
Streamable HTTP endpoint:
```
https://mansaapi.com/api/mcp
```
### Claude Desktop
```json
{
"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`](https://github.com/HeyZod/mansa-african-markets-mcp)
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](https://mansaapi.com/terms).