# mansa

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add mansamarkets/mansa

# Browse available tools
npx -y @smithery/cli@latest tool list mansamarkets/mansa

# Get full schema for a tool
npx -y @smithery/cli@latest tool get mansamarkets/mansa get_ngx_market_overview

# Call a tool
npx -y @smithery/cli@latest tool call mansamarkets/mansa get_ngx_market_overview '{}'
```

## Direct MCP Connection

Endpoint: `https://mansa--mansamarkets.run.tools`

## Tools (14)

- `get_ngx_market_overview` — Get a real-time overview of the Nigerian Stock Exchange (NGX). Returns the All Share Index (ASI), market capitalisation…
- `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, ZE…
- `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,…
- `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 Nig…
- `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 Niger…
- `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.
- `get_nasd_stocks` — Get all 45 equities on Nigeria's NASD OTC Securities Exchange.
- `get_african_exchanges` — Get a list of all African stock exchanges covered by Mansa API — NGX, GSE, NSE, JSE, BRVM, DSE, LuSE, EGX, CSE, BSE, SE…
- `get_african_exchange` — Get detailed data for one specific African exchange by ID — index value, change, trading hours, currency, and status.
- `get_african_exchange_stocks` — Get stocks on a specific African exchange with prices, change percent, volume, market cap, and sector. Supports filteri…
- `get_african_exchange_movers` — Get the top gainers and/or losers on a specific African exchange today.
- `get_pan_african_movers` — Get the biggest stock movers across ALL African exchanges combined — top gainers and losers by % change from every cove…
- `get_african_indices` — Get all major African market indices in one call — NGX ASI, GSE-CI, NASI, J203, BRVM-CI, LASI and more.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get mansamarkets/mansa <tool-name>
```