Servidor MCP

Mansa African Markets

io.github.HeyZod/mansa-african-markets
Datos y analítica Finanzas e inversión Público y accesible MCP 2025-11-25

Qué hace este 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).
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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).
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'number', 'description': 'Number of movers per category. Defaults to 10.'}}}
Añadido
get_african_banks
17 de September de 2026 a las 12:42
Añadido
get_african_fx_rates
17 de September de 2026 a las 12:42
Añadido
get_african_yield_curve
17 de September de 2026 a las 12:42
Añadido
get_market_open_status
17 de September de 2026 a las 12:42
Añadido
get_macro_history
17 de September de 2026 a las 12:42
Añadido
get_country_macro_indicators
17 de September de 2026 a las 12:42
Añadido
get_african_policy_rates
17 de September de 2026 a las 12:42
Añadido
get_african_indices
17 de September de 2026 a las 12:42
Añadido
get_pan_african_movers
17 de September de 2026 a las 12:42
Añadido
get_african_exchange_movers
17 de September de 2026 a las 12:42
Añadido
get_african_exchange_stocks
17 de September de 2026 a las 12:42
Añadido
get_african_exchange
17 de September de 2026 a las 12:42
Añadido
get_african_exchanges
17 de September de 2026 a las 12:42
Añadido
get_nasd_stocks
17 de September de 2026 a las 12:42
Añadido
get_ngx_disclosures
17 de September de 2026 a las 12:42
Añadido
get_ngx_market_status
17 de September de 2026 a las 12:42
Añadido
get_ngx_top_losers
17 de September de 2026 a las 12:42
Añadido
get_ngx_top_gainers
17 de September de 2026 a las 12:42
Añadido
get_ngx_all_stocks
17 de September de 2026 a las 12:42
Añadido
get_ngx_stock_price
17 de September de 2026 a las 12:42
Añadido
get_ngx_market_overview
17 de September de 2026 a las 12:42