Mansa African Markets

io.github.HeyZodPublished by GitHub account HeyZodv1.0.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

A remote MCP server giving assistants live African stock market data: NGX prices, indices, movers, disclosures, macro rates and FX.

What you can do
Read Nigerian market data: NGX overview, stock prices and history, full equities list, gainers and losers, session status, corporate disclosures, NASD OTC stocks. Browse pan-African markets: list exchanges, detail one exchange, list its stocks with filtering and sorting, and show its movers. Compare movers and indices across all covered African exchanges. Look up macro data: central bank policy rates and inflation, per-country indicators, monthly history, government yield curves. Check whether an exchange is open, with local time, holidays and next open or close. Convert with USD rates for around 40 African currencies and look up banks and mobile-money institutions by country or code.
When to use it
Useful when an assistant needs current or historical African market information — Nigerian equities, pan-African indices and movers, macro rates, yield curves or FX — for research, reporting or market questions. It is a read-only data source, so it suits analysis rather than trading.
Requirements
A remote streamable HTTP endpoint; no installation or account is declared. The README also describes a self-hosted option run with Node.js, using the PORT, NGX_API_KEY and MANSA_API_KEY environment variables, which default to built-in values. Rate limit is 60 requests per minute per IP.
Before you install
All tools are read-only lookups; none appear to write, send or delete data. Queries go to the third-party providers NGX Pulse and Mansa Markets, so market questions and lookups are visible to them. The self-hosted option accepts API keys through NGX_API_KEY and MANSA_API_KEY; keep those values private. Data is informational market data, not investment advice.

Installation

In SourceWeft

  1. Open Mansa African Markets in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.HeyZod%2Fmansa-african-markets/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

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.

[MCP Registry] [License: MIT] [Smithery]


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

ToolDescription
get_ngx_market_overviewAll Share Index, market cap, volume, advancers/decliners
get_ngx_stock_pricePrice history for any NGX ticker (DANGCEM, GTCO, MTNN…)
get_ngx_all_stocksFull 148-stock NGX equities list with live prices
get_ngx_top_gainersTop N NGX stocks by % gain today
get_ngx_top_losersTop N NGX stocks by % loss today
get_ngx_market_statusNGX session status (OPEN / CLOSED / ENDOFDAY)
get_ngx_disclosuresLatest 200 corporate announcements
get_nasd_stocksNASD OTC market equities (45 stocks)

Mansa Markets — Pan-African Data

ToolDescription
get_african_exchangesAll 13 African exchanges with index levels and status
get_african_exchangeDetailed data for one exchange by ID
get_african_exchange_stocksStocks on any exchange with filtering and sorting
get_african_exchange_moversTop gainers/losers on a specific exchange
get_pan_african_moversBiggest movers across all African exchanges combined
get_african_indicesAll 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

ExchangeCountryCoverage
NGX🇳🇬 NigeriaFull quote feed
GSE🇬🇭 GhanaFull quote feed
NSE🇰🇪 KenyaFull quote feed
JSE🇿🇦 South AfricaFull quote feed
BRVM🇨🇮 West Africa (8 countries)Full quote feed
LuSE🇿🇲 ZambiaFull quote feed
EGX🇪🇬 EgyptBenchmark index
CSE🇲🇦 MoroccoBenchmark index
BSE🇧🇼 BotswanaBenchmark index
SEM🇲🇺 MauritiusBenchmark index
ZSE🇿🇼 ZimbabweBenchmark index
DSE🇹🇿 TanzaniaBenchmark index
USE🇺🇬 UgandaBenchmark 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.gitcd mansa-african-markets-mcpnpm installnpm 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

VariableDefaultDescription
PORT3000HTTP 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

Source: README.md at commit 2bc9996

Tools

21

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.

Takes 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.

Parameterssymbolrequired

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.

Takes 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.

Parameterslimit

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.

Parameterslimit

get_ngx_market_status

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

Takes no parameters.

get_ngx_disclosures

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

Takes 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.

Takes 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.

Takes no parameters.

get_african_exchange

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

Parametersexchangerequired

get_african_exchange_stocks

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

Parameterslimitordersectorsort_byexchangerequired

get_african_exchange_movers

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

Parameterstypelimitexchangerequired

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.

Parameterslimit

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.

Takes 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.

Takes 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.

Parameterscountryrequired

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).

Parameterstofromcountryrequiredindicatorrequired

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.

Parametersexchangerequired

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.

Parameterscountryrequired

get_african_fx_rates

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

Takes 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).

Parameterscodecountry

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.