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:

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:

https://mcp.mansamarkets.com/mcp

Option 2 — Self-hosted

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:

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

Self-hosted

{
  "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