Mansa African Markets MCP Server

MCP serverDev tools

mansa-african-markets gives your AI live stock market data from African exchanges, including NGX, GSE, NSE, JSE and BRVM. Once added, your AI can answer questions about current prices, market indices and the biggest movers across these markets.

Use Mansa African Markets MCP Server in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add Mansa African Markets MCP Server and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use Mansa African Markets MCP Server to get ngx market overview

Details

Available today. Use it from your connected AI after setup.

Add mansa-african-markets, then ask your AI something like what the current price of a stock is or which shares are moving on a given exchange.

Mansa African Markets MCP ServerStart free

What your AI can do with it

  • Look up live prices for African stocks
  • Check market indices on exchanges like NGX, GSE, NSE, JSE and BRVM
  • See which stocks are moving the most today
  • Pull current market data from 13 African exchanges

Install Mansa African Markets MCP Server

The server’s own address, for the clients that take one directly. Or connect Ahel once and every client you use reads it from one address, with the account kept on Ahel rather than in each client’s config.

  • Claude Code

    claude mcp add --transport http --scope user mansa-african-markets-mcp-server 'https://mcp.mansamarkets.com/mcp'

    Run it once in your project, then open /mcp to approve any sign-in the server asks for.

  • Claude Desktop

    https://mcp.mansamarkets.com/mcp

    Add a custom connector in Settings, paste this address, and approve the sign-in.

  • Cursor

    cursor://anysphere.cursor-deeplink/mcp/install?name=mansa-african-markets-mcp-server&config=eyJ1cmwiOiJodHRwczovL21jcC5tYW5zYW1hcmtldHMuY29tL21jcCJ9

    Open the link and Cursor adds the server at that address.

  • ChatGPT

    https://mcp.mansamarkets.com/mcp

    In Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.

  • Codex

    codex mcp add mansa-african-markets-mcp-server --url 'https://mcp.mansamarkets.com/mcp'

    Run it once, then sign in with codex mcp login mansa-african-markets-mcp-server if the server asks for an account.

From the project's README

As published by heyzod/mansa-african-markets-mcp in README.md.

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

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:

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

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

Tools it offers (21)

What this server listed when Ahel dialed its public endpoint in Oct 2026, with no key and no account of yours. The names are the server’s own.

  • 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

Signals

Last commit
Jul 2026
Advanced
Delivery
mansa-african-markets MCP server → your Ahel connector (mcp.ahel.ai) → your AI.
Item type
mcp-server
Key
io-github-heyzod-mansa-african-markets
Source
github.com/heyzod/mansa-african-markets-mcp
Hosted endpoint
https://mcp.mansamarkets.com/mcp