Mansa African Markets

Official21 tools

by HeyZod · JavaScript

Live African stock market data — NGX, GSE, NSE, JSE, BRVM and 8 more. Prices, indices and movers.

Live African stock market data across 13+ exchanges with prices, indices, and movers.

Captured live from the server via tools/list.

get_ngx_market_overview

Get a real-time overview of the Nigerian Stock Exchange (NGX). Returns the All Share Index (ASI), market capitalisation, trading volume, deals, advancers, and decliners. Use this when the user asks about the Nigerian stock market at a high level.

No parameters.

get_ngx_stock_price

Get the latest price and trading history for a specific NGX-listed stock by ticker symbol (e.g. DANGCEM, GTCO, MTNN, ZENITHBANK, ACCESSCORP). Use this when the user asks about the price of a particular Nigerian stock.

Parameters (1)

symbolstringrequired
NGX ticker symbol (e.g. DANGCEM, GTCO, MTNN). Case-insensitive.

get_ngx_all_stocks

Get the full list of all 148+ equities listed on the NGX with current prices, daily change percent, volume, market cap, and sector.

No parameters.

get_ngx_top_gainers

Get the top gaining stocks on the NGX today, ranked by percentage price increase. Use this when the user asks which Nigerian stocks are up the most today.

Parameters (1)

limitnumber
Number of top gainers to return. Defaults to 10.

get_ngx_top_losers

Get the top losing stocks on the NGX today, ranked by percentage price decline. Use this when the user asks which Nigerian stocks are down the most today.

Parameters (1)

limitnumber
Number of top losers to return. Defaults to 10.

get_ngx_market_status

Check whether the Nigerian Stock Exchange (NGX) is currently open or closed. Returns OPEN, CLOSED, or ENDOFDAY.

No parameters.

get_ngx_disclosures

Get the latest 200 corporate disclosures and regulatory announcements from NGX-listed companies — earnings, dividends, board changes, and filings.

No parameters.

get_nasd_stocks

Get all 45 equities on Nigeria's NASD OTC Securities Exchange — the over-the-counter market for unlisted and growth-stage companies.

No parameters.

get_african_exchanges

Get a list of all African stock exchanges — NGX, GSE, NSE, JSE, BRVM, DSE, LuSE, EGX, CSE, BSE, SEM, ZSE, USE — with index levels, daily change, stocks count, and status.

No parameters.

get_african_exchange

Get detailed data for one specific African exchange by ID — index value, change, trading hours, currency, and status.

Parameters (1)

exchangestringrequired
Exchange ID. Options: nigeria, ghana, kenya, south-africa, ivory-coast, tanzania, zambia, egypt, morocco, botswana, mauritius, zimbabwe, uganda

get_african_exchange_stocks

Get stocks on a specific African exchange with prices, change percent, volume, market cap, and sector. Supports filtering and sorting.

Parameters (5)

exchangestringrequired
Exchange ID. Options: nigeria, ghana, kenya, south-africa, ivory-coast, tanzania, zambia, egypt, morocco, botswana, mauritius, zimbabwe, uganda
limitnumber
Number of stocks to return. Defaults to 50.
sectorstring
Filter by sector (optional).
sort_bystring
Sort by: price, change_pct, volume, market_cap (optional).
orderstring
Sort order. Defaults to desc.

get_african_exchange_movers

Get the top gainers and/or losers on a specific African exchange today.

Parameters (3)

exchangestringrequired
Exchange ID. Options: nigeria, ghana, kenya, south-africa, ivory-coast, tanzania, zambia, egypt, morocco, botswana, mauritius, zimbabwe, uganda
limitnumber
Number of movers per category. Defaults to 10.
typestring
Which movers to return. Defaults to both.

get_pan_african_movers

Get the biggest stock movers across ALL African exchanges combined — top gainers and losers by % change from every covered market today.

Parameters (1)

limitnumber
Number of movers per category. Defaults to 10.

get_african_indices

Get all major African market indices in one call — NGX ASI, GSE-CI, NASI, J203, BRVM-CI, LASI and more. Includes index values, daily change, and YTD performance.

No parameters.

get_african_policy_rates

Get current central bank policy rates and latest inflation for 18 African economies — Nigeria live from CBN — with source institution and URL per value.

No parameters.

get_country_macro_indicators

Get all macro indicators for one African country (ISO-2 code). Nigeria returns the live CBN set: MPR, T-bill, interbank, lending rates, and headline/food/core inflation.

Parameters (1)

countrystringrequired
ISO-2 country code, e.g. NG, KE, ZA.

get_macro_history

Monthly history for an African macro indicator. Nigeria reaches back to January 2006 (policy_rate, inflation, inflation_food, inflation_core, treasury_bill_rate and more).

Parameters (4)

countrystringrequired
ISO-2 country code, e.g. NG.
indicatorstringrequired
e.g. policy_rate or inflation.
fromstring
Optional start period, YYYY-MM.
tostring
Optional end period, YYYY-MM.

get_market_open_status

Is an African exchange open right now? Returns reason (hours/weekend/public holiday with name), local time, session, and next open/close. Handles Sun–Thu markets and holidays.

Parameters (1)

exchangestringrequired
Exchange code, e.g. NGX, JSE, EGX.

get_african_yield_curve

Current government yield curve for an African country — latest T-bill/bond auction per tenor with stop rates and yields. 13 countries covered.

Parameters (1)

countrystringrequired
ISO-2 country code, e.g. NG, KE, GH.

get_african_fx_rates

Current USD rates for ~40 African currencies, each with as-of timestamp and source.

No parameters.

get_african_banks

Look up African banks and mobile-money institutions by country (NIBSS sort codes, SWIFT/BIC, USSD) or a single bank code (e.g. 058 = GTBank).

Parameters (2)

countrystring
Optional ISO-2 country filter.
codestring
Optional single bank code, e.g. 058.

README.md4 KBView on GitHub

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

Install

Tools (21)

get_ngx_market_overviewget_ngx_stock_priceget_ngx_all_stocksget_ngx_top_gainersget_ngx_top_losersget_ngx_market_statusget_ngx_disclosuresget_nasd_stocks

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.mansamarkets.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mansa-african-markets": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.mansamarkets.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.