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.

Quickstart (30 seconds)

Remote MCP, no installation needed:

text

https://mcp.mansamarkets.com/mcp

Add to Claude.ai, Cursor, or any MCP-compatible client and start querying African markets immediately.

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

Example Prompts

Once connected, ask your AI assistant:

"What is the NGX All-Share Index today?"
"Show me the top 5 gainers on the Ghana Stock Exchange"
"What is the current price of DANGCEM?"
"Compare today’s performance across all African exchanges"
"What corporate disclosures has GTCo filed this week?"
"Which African stock has the biggest gain today across all 13 exchanges?"

Supported Exchanges

Exchange	Country	Coverage
NGX	🇳🇬 Nigeria	Full quote feed
GSE	🇬🇭 Ghana	Full quote feed
NSE	🇰🇪 Kenya	Full quote feed
JSE	🇿🇦 South Africa	Full quote feed
BRVM	🇨🇮 West Africa (8 countries)	Full quote feed
LuSE	🇿🇲 Zambia	Full quote feed
EGX	🇪🇬 Egypt	Benchmark index
CSE	🇲🇦 Morocco	Benchmark index
BSE	🇧🇼 Botswana	Benchmark index
SEM	🇲🇺 Mauritius	Benchmark index
ZSE	🇿🇼 Zimbabwe	Benchmark index
DSE	🇹🇿 Tanzania	Benchmark index
USE	🇺🇬 Uganda	Benchmark index

Installation

Option 1 — Remote (recommended)

No installation. Add the remote URL to your MCP client:

text

https://mcp.mansamarkets.com/mcp

Option 2 — Self-hosted

bash

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

Client Configuration

Claude Desktop

Add to claude_desktop_config.json:

config.json

{
  "mcpServers": {
    "mansa-african-markets": {
      "type": "http",
      "url": "https://mcp.mansamarkets.com/mcp"
    }
  }
}

Self-hosted

config.json

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

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

Rate Limiting

60 requests per minute per IP.

Data Sources

NGX Pulse — ngxpulse.ng — Nigerian Exchange market intelligence
Mansa Markets — mansamarkets.com — Pan-African capital markets terminal

License

MIT