mansa-african-identity-mcp

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