io.github.HeyZod/mansa-african-markets — Mansa African Markets MCP Server

Provides live African stock market data for AI assistants, covering multiple exchanges and delivering prices, indices, and market movers. The server is powered by NGX Pulse (ngxpulse.ng) and Mansa Markets (mansamarkets.com), and exposes 21 tools for data access.

🛠️ Key Features

Live African stock market data
Market prices, indices, and movers
Data coverage across 13 African exchanges
Implements MCP tooling (21 tools total)
Topics: africa, fintech, investing, market-data, mcp, mcp-server, nigeria, stock-market

🚀 Use Cases

Retrieve real-time stock prices and index information
Monitor top market movers across African exchanges
Build investing or market-data assistants focused on African markets

⚡ Developer Benefits

Remote MCP support (no installation needed, per excerpt)
Uses NGX Pulse and Mansa Markets as data sources
Tool count and exchange coverage are available in the server metadata

⚠️ Limitations

Limited to the exchanges described as “13 African exchanges” (no additional exchange list provided)

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:

json

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

Self-hosted

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

exchange	string	required	Exchange ID. Options: nigeria, ghana, kenya, south-africa, ivory-coast, tanzania, zambia, egypt, morocco, botswana, mauritius, zimbabwe, uganda
limit	number	optional	Number of stocks to return. Defaults to 50.
sector	string	optional	Filter by sector (optional).
sort_by	string	optional	Sort by: price, change_pct, volume, market_cap (optional).
order	string	optional	Sort order. Defaults to desc.

exchange	string	required	Exchange ID. Options: nigeria, ghana, kenya, south-africa, ivory-coast, tanzania, zambia, egypt, morocco, botswana, mauritius, zimbabwe, uganda
limit	number	optional	Number of movers per category. Defaults to 10.
type	string	optional	Which movers to return. Defaults to both.

country	string	required	ISO-2 country code, e.g. NG.
indicator	string	required	e.g. policy_rate or inflation.
from	string	optional	Optional start period, YYYY-MM.
to	string	optional	Optional end period, YYYY-MM.

country	string	optional	Optional ISO-2 country filter.
code	string	optional	Optional single bank code, e.g. 058.

io.github.HeyZod/mansa-african-markets — Mansa African Markets MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

get_ngx_market_overview

get_ngx_stock_price

get_ngx_all_stocks

get_ngx_top_gainers

get_ngx_top_losers

get_ngx_market_status

get_ngx_disclosures

get_nasd_stocks

get_african_exchanges

get_african_exchange

get_african_exchange_stocks

get_african_exchange_movers

get_pan_african_movers

get_african_indices

get_african_policy_rates

get_country_macro_indicators

get_macro_history

get_market_open_status

get_african_yield_curve

get_african_fx_rates

get_african_banks