MCP-Server

Mansa African Markets

io.github.HeyZod/mansa-african-markets
Daten & Analytik Finanzen & Investieren Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

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).
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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).
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'number', 'description': 'Number of movers per category. Defaults to 10.'}}}
Hinzugefügt
get_african_banks
17. September 2026 12:42
Hinzugefügt
get_african_fx_rates
17. September 2026 12:42
Hinzugefügt
get_african_yield_curve
17. September 2026 12:42
Hinzugefügt
get_market_open_status
17. September 2026 12:42
Hinzugefügt
get_macro_history
17. September 2026 12:42
Hinzugefügt
get_country_macro_indicators
17. September 2026 12:42
Hinzugefügt
get_african_policy_rates
17. September 2026 12:42
Hinzugefügt
get_african_indices
17. September 2026 12:42
Hinzugefügt
get_pan_african_movers
17. September 2026 12:42
Hinzugefügt
get_african_exchange_movers
17. September 2026 12:42
Hinzugefügt
get_african_exchange_stocks
17. September 2026 12:42
Hinzugefügt
get_african_exchange
17. September 2026 12:42
Hinzugefügt
get_african_exchanges
17. September 2026 12:42
Hinzugefügt
get_nasd_stocks
17. September 2026 12:42
Hinzugefügt
get_ngx_disclosures
17. September 2026 12:42
Hinzugefügt
get_ngx_market_status
17. September 2026 12:42
Hinzugefügt
get_ngx_top_losers
17. September 2026 12:42
Hinzugefügt
get_ngx_top_gainers
17. September 2026 12:42
Hinzugefügt
get_ngx_all_stocks
17. September 2026 12:42
Hinzugefügt
get_ngx_stock_price
17. September 2026 12:42
Hinzugefügt
get_ngx_market_overview
17. September 2026 12:42