Skip to main content
Glama
HeyZod

Mansamarkets-mcp

by HeyZod

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:

https://mcp.mansamarkets.com/mcp

Add to Claude.ai, Cursor, or any MCP-compatible client and start querying African markets immediately.


Related MCP server: finstack-mcp

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

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 Pulsengxpulse.ng — Nigerian Exchange market intelligence

  • Mansa Marketsmansamarkets.com — Pan-African capital markets terminal


License

MIT

Related MCP Connectors

Related MCP Servers

  • -
    license
    Not graded
    quality
    Not graded
    maintenance
    Real-time financial market data MCP server. Stocks, crypto, technicals, sentiment, FDA calendar. No API keys required.
    -
  • A
    license
    B
    quality
    D
    maintenance
    India-first financial data engine for MCP clients. Live NSE/BSE quotes, Nifty/Sensex indices, mutual fund NAV, earnings calendar, FII/DII activity, and daily market brief. 39 tools, no API key needed, free.
    8
    95
    179 PyPI
    15
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Unified real-time & historical market data API for Forex, stocks (US/HK/A-share), crypto, indices & precious metals. Tick, order book depth & K-line via REST + WebSocket. AI-native: MCP server, Skill & CLI.
    796
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    A modular MCP server providing 64 tools across 13 modules for real-time stock and crypto market data, including scanning, technical analysis, options flow, insider trades, and personalized watchlists.
    39
    154 npm
    6
    MIT