Serveur MCP

Mansa African Markets

io.github.HeyZod/mansa-african-markets
Données et analytique Finance et investissement Public et accessible MCP 2025-11-25

Ce que fait ce MCP

Provides live African exchange, stock, index, currency, macroeconomic, policy-rate, yield-curve, disclosure, and market-status data.

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).
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {'code': {'type': 'string', 'description': 'Optional single bank code, e.g. 058.'}, 'country': {'type': 'string', 'description': 'Optional ISO-2 country filter.'}}}
get_african_exchange
Get detailed data for one specific African exchange by ID — index value, change, trading hours, currency, and status.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['exchange'], 'properties': {'exchange': {'enum': ['nigeria', 'ghana', 'kenya', 'south-africa', 'ivory-coast', 'tanzania', 'zambia', 'egypt', 'morocco', 'botswana', 'mauritius', 'zimbabwe', 'uganda'], 'type': 'string', 'description': 'Exchange ID. Options: nigeria, ghana, kenya, south-africa, ivory-coast, tanzania, zambia, egypt, morocco, botswana, mauritius, zimbabwe, uganda'}}}
get_african_exchange_movers
Get the top gainers and/or losers on a specific African exchange today.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['exchange'], 'properties': {'type': {'enum': ['gainers', 'losers', 'both'], 'type': 'string', 'description': 'Which movers to return. Defaults to both.'}, 'limit': {'type': 'number', 'description': 'Number of movers per category. Defaults to 10.'}, 'exchange': {'enum': ['nigeria', 'ghana', 'kenya', 'south-africa', 'ivory-coast', 'tanzania', 'zambia', 'egypt', 'morocco', 'botswana', 'mauritius', 'zimbabwe', 'uganda'], 'type': 'string', 'description': 'Exchange ID. Options: nigeria, ghana, kenya, south-africa, ivory-coast, tanzania, zambia, egypt, morocco, botswana, mauritius, zimbabwe, uganda'}}}
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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {}}
get_african_exchange_stocks
Get stocks on a specific African exchange with prices, change percent, volume, market cap, and sector. Supports filtering and sorting.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['exchange'], 'properties': {'limit': {'type': 'number', 'description': 'Number of stocks to return. Defaults to 50.'}, 'order': {'enum': ['asc', 'desc'], 'type': 'string', 'description': 'Sort order. Defaults to desc.'}, 'sector': {'type': 'string', 'description': 'Filter by sector (optional).'}, 'sort_by': {'type': 'string', 'description': 'Sort by: price, change_pct, volume, market_cap (optional).'}, 'exchange': {'enum': ['nigeria', 'ghana', 'kenya', 'south-africa', 'ivory-coast', 'tanzania', 'zambia', 'egypt', 'morocco', 'botswana', 'mauritius', 'zimbabwe', 'uganda'], 'type': 'string', 'description': 'Exchange ID. Options: nigeria, ghana, kenya, south-africa, ivory-coast, tanzania, zambia, egypt, morocco, botswana, mauritius, zimbabwe, uganda'}}}
get_african_fx_rates
Current USD rates for ~40 African currencies, each with as-of timestamp and source.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {}}
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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {}}
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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {}}
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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['country'], 'properties': {'country': {'type': 'string', 'description': 'ISO-2 country code, e.g. NG, KE, GH.'}}}
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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['country'], 'properties': {'country': {'type': 'string', 'description': '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).
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['country', 'indicator'], 'properties': {'to': {'type': 'string', 'description': 'Optional end period, YYYY-MM.'}, 'from': {'type': 'string', 'description': 'Optional start period, YYYY-MM.'}, 'country': {'type': 'string', 'description': 'ISO-2 country code, e.g. NG.'}, 'indicator': {'type': 'string', 'description': 'e.g. policy_rate or inflation.'}}}
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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['exchange'], 'properties': {'exchange': {'type': 'string', 'description': 'Exchange code, e.g. NGX, JSE, EGX.'}}}
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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {}}
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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {}}
get_ngx_disclosures
Get the latest 200 corporate disclosures and regulatory announcements from NGX-listed companies — earnings, dividends, board changes, and filings.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {}}
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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {}}
get_ngx_market_status
Check whether the Nigerian Stock Exchange (NGX) is currently open or closed. Returns OPEN, CLOSED, or ENDOFDAY.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {}}
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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['symbol'], 'properties': {'symbol': {'type': 'string', 'description': 'NGX ticker symbol (e.g. DANGCEM, GTCO, MTNN). Case-insensitive.'}}}
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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'number', 'description': '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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'number', 'description': 'Number of top losers to return. Defaults to 10.'}}}
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.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'number', 'description': 'Number of movers per category. Defaults to 10.'}}}
Ajouté
get_african_banks
17 September 2026 12:42
Ajouté
get_african_fx_rates
17 September 2026 12:42
Ajouté
get_african_yield_curve
17 September 2026 12:42
Ajouté
get_market_open_status
17 September 2026 12:42
Ajouté
get_macro_history
17 September 2026 12:42
Ajouté
get_country_macro_indicators
17 September 2026 12:42
Ajouté
get_african_policy_rates
17 September 2026 12:42
Ajouté
get_african_indices
17 September 2026 12:42
Ajouté
get_pan_african_movers
17 September 2026 12:42
Ajouté
get_african_exchange_movers
17 September 2026 12:42
Ajouté
get_african_exchange_stocks
17 September 2026 12:42
Ajouté
get_african_exchange
17 September 2026 12:42
Ajouté
get_african_exchanges
17 September 2026 12:42
Ajouté
get_nasd_stocks
17 September 2026 12:42
Ajouté
get_ngx_disclosures
17 September 2026 12:42
Ajouté
get_ngx_market_status
17 September 2026 12:42
Ajouté
get_ngx_top_losers
17 September 2026 12:42
Ajouté
get_ngx_top_gainers
17 September 2026 12:42
Ajouté
get_ngx_all_stocks
17 September 2026 12:42
Ajouté
get_ngx_stock_price
17 September 2026 12:42
Ajouté
get_ngx_market_overview
17 September 2026 12:42