Mansa African Markets

io.github.HeyZod由 GitHub 账号 HeyZod 发布v1.0.0更新于 Oct 24, 2026

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

已验证Streamable HTTP可网页运行金融数据与分析

概览

AI 生成的概览

远程 MCP 服务器,为助手提供非洲股市实时数据:NGX 股价、指数、涨跌榜、公告、宏观利率与汇率。

可以做什么
读取尼日利亚市场数据:NGX 概览、个股价格与历史、全部股票列表、涨幅榜与跌幅榜、交易时段状态、公司公告、NASD 场外股票。浏览泛非市场:列出交易所、查看单个交易所详情、按筛选和排序列出其股票、查看该交易所涨跌榜。跨所有覆盖的非洲交易所比较涨跌榜与指数。查询宏观数据:央行政策利率与通胀、按国家的指标、月度历史、政府收益率曲线。查询交易所是否开市,含当地时间、节假日与下次开闭市时间。查询约 40 种非洲货币的美元汇率,并按国家或代码查找银行与移动支付机构。
适用场景
适合助手需要当前或历史非洲市场信息时使用,例如尼日利亚股票、泛非指数与涨跌榜、宏观利率、收益率曲线或汇率,用于研究、报告或市场问答。它是只读数据源,适合分析而非交易。
运行要求
远程 streamable HTTP 端点;未声明需要安装或账户。README 另提供自托管方式,需用 Node.js 运行,并使用 PORT、NGX_API_KEY 和 MANSA_API_KEY 环境变量,默认使用内置值。限流为每 IP 每分钟 60 次请求。
安装前请注意
所有工具均为只读查询,未见写入、发送或删除数据。查询会发往第三方数据提供方 NGX Pulse 和 Mansa Markets,因此市场问题与查询对其可见。自托管方式需通过 NGX_API_KEY 和 MANSA_API_KEY 提供 API 密钥,请妥善保密。数据仅供参考,不构成投资建议。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mansa African Markets,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.HeyZod%2Fmansa-african-markets/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

来源:README.md,提交 2bc9996

工具

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.

无需输入参数。

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.

输入参数symbol必填

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.

无需输入参数。

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.

输入参数limit

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.

输入参数limit

get_ngx_market_status

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

无需输入参数。

get_ngx_disclosures

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

无需输入参数。

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.

无需输入参数。

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.

无需输入参数。

get_african_exchange

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

输入参数exchange必填

get_african_exchange_stocks

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

输入参数limitordersectorsort_byexchange必填

get_african_exchange_movers

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

输入参数typelimitexchange必填

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.

输入参数limit

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.

无需输入参数。

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.

无需输入参数。

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.

输入参数country必填

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

输入参数tofromcountry必填indicator必填

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.

输入参数exchange必填

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.

输入参数country必填

get_african_fx_rates

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

无需输入参数。

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

输入参数codecountry

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。