Mansa African Markets MCP Server

Real-time African stock market data for AI assistants — powered by NGX Pulse and Mansa Markets.

14 tools. 13 African exchanges. Live data.

Tools

NGX Pulse — Nigerian Market Data

Tool	Description
`get_ngx_market_overview`	All Share Index, market cap, volume, advancers/decliners
`get_ngx_stock_price`	Price history for any NGX ticker (DANGCEM, GTCO, MTNN…)
`get_ngx_all_stocks`	Full 148-stock NGX equities list with live prices
`get_ngx_top_gainers`	Top N NGX stocks by % gain today
`get_ngx_top_losers`	Top N NGX stocks by % loss today
`get_ngx_market_status`	NGX session status (OPEN / CLOSED / ENDOFDAY)
`get_ngx_disclosures`	Latest 200 corporate announcements
`get_nasd_stocks`	NASD OTC market equities (45 stocks)

Mansa Markets — Pan-African Data

Tool	Description
`get_african_exchanges`	All 13 African exchanges with index levels and status
`get_african_exchange`	Detailed data for one exchange by ID
`get_african_exchange_stocks`	Stocks on any exchange with filtering and sorting
`get_african_exchange_movers`	Top gainers/losers on a specific exchange
`get_pan_african_movers`	Biggest movers across ALL African exchanges combined
`get_african_indices`	All African market indices with YTD performance

Supported Exchanges

NGX (Nigeria), GSE (Ghana), NSE (Kenya), JSE (South Africa), BRVM (West Africa), DSE (Tanzania), LuSE (Zambia), EGX (Egypt), CSE (Morocco), BSE (Botswana), SEM (Mauritius), ZSE (Zimbabwe), USE (Uganda)

Installation

git clone https://github.com/heyzod/mansa-african-markets-mcp.git
cd mansa-african-markets-mcp
npm install
npm start

Environment Variables

Variable	Default	Description
`PORT`	`3000`	HTTP port
`NGX_API_KEY`	(built-in)	NGX Pulse API key
`MANSA_API_KEY`	(built-in)	Mansa API key

Claude Desktop Integration

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "mansa-african-markets": {
      "command": "node",
      "args": ["/absolute/path/to/mansa-african-markets-mcp/server.js"]
    }
  }
}

Remote MCP (Claude.ai, API)

Use as a remote MCP server:

https://mcp.mansamarkets.com/mcp

Rate Limiting

60 requests per minute per IP.

License

MIT

Mansa African Markets