# Kobo Terminal NGX

> Kobo Terminal NGX is a freemium MCP server for financial data. Live Nigerian stock market (NGX) data for AI assistants via a hosted MCP server. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $20 a month
- **Platforms:** API, Web
- **Website:** https://koboterminal.com/docs/mcp
- **MCP Registry name:** com.koboterminal/ngx
- **Categories:** [financial data](https://ai-powered.com/categories/financial-data)
- **Listing updated:** 2026-11-19

## About

The README-style docs describe a hosted MCP endpoint that gives an AI client access to 24 tools covering the Nigerian Exchange: index levels, stock and ETF quotes, price history back to 2000, fundamentals for 145 stocks, dividends, corporate disclosures, director dealings, bonds and CBN T-bill auctions. Connection is over Streamable HTTP and authenticated with a Kobo API key sent in a header or, for URL-only connectors, a query parameter.

Setup is a single command for Claude Code or a JSON entry for Claude Desktop, Cursor and Windsurf. Clients limited to local stdio servers can bridge through mcp-remote. Tool discovery works without a key, and tool calls count against the key's daily and per-minute quota.

The server suits analysts, developers building finance dashboards, and anyone who wants to ask an assistant questions about NGX-listed companies without writing their own scrapers.

## Features

- **Live market and index data:** Pulls the All-Share Index, market summary, market status and all 21 NGX indices, including intraday readings.
- **Long price history:** Returns daily OHLC and volume for individual stocks from May 2000 onward, subject to plan access.
- **Valuation and fundamentals:** Provides P/E, EPS, ROE, dividend yield and many other ratios for 145 listed stocks in one call.
- **Dividends and corporate filings:** Lists dividend history, ex-dates, upcoming dividends and NGX disclosures with links to original PDFs.
- **Director dealings:** Exposes structured insider trade filings with volumes, prices and net weekly insider flow.
- **Bonds and T-bill auctions:** Covers FGN, Eurobond, Sukuk and corporate bonds plus CBN Treasury Bill auction results.

## Good for

- Asking an AI assistant for the daily NGX All-Share Index move and breadth
- Comparing Nigerian banks by dividend yield and valuation ratios
- Tracking director buying and selling at a listed company
- Building a finance dashboard or client report that needs NGX price history
- Checking recent T-bill auction stop rates and yields

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http ngx https://koboterminal.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://koboterminal.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ngx": {
      "url": "https://koboterminal.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "ngx": {
      "type": "http",
      "url": "https://koboterminal.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "ngx": {
      "serverUrl": "https://koboterminal.com/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://koboterminal.com/mcp
```

Enter a Name (for example "Kobo Terminal NGX"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "ngx": {
      "type": "http",
      "url": "https://koboterminal.com/mcp"
    }
  }
}
```

## Tools

- `get_market_summary`: NGX All-Share Index level, change, market cap, volume, value and breadth.
- `get_market_status`: Reports whether the NGX is open, accounting for weekends and Nigerian holidays.
- `list_stocks`: Returns every listed NGX equity with price, change, volume, market cap and sector.
- `get_price_history`: Daily open, high, low, close and volume for one NGX stock from May 2000.
- `list_indices`: Lists all 21 NGX indices with week, month, year and inception change.
- `get_index`: Returns one NGX index by code or slug.
- `get_index_history`: Daily closing levels for any NGX index.
- `get_index_intraday`: Today's intraday index points plus the latest live reading.
- `list_etfs`: Lists every NGX ETF with ISIN, issuer and trading data.
- `get_etf`: Returns one ETF by symbol, resolving common aliases.
- `get_fundamentals`: Valuation, profitability, leverage and dividend metrics for 145 NGX stocks.
- `lookup_identifiers`: Maps NGX tickers to ISIN and FIGI and back.
- `get_disclosures`: NGX corporate filings with links to the original PDFs.
- `get_insider_dealings`: Structured director-dealing filings and weekly net insider flow.
- `get_dividend_history`: Dividend amounts and ex, record and payment dates for a company.
- `get_dividend_calendar`: Market-wide dividends by ex-dividend date, with an upcoming filter.
- `get_offers`: Open and recent public offers, rights issues and IPOs.
- `get_bonds`: Listed FGN, Eurobond, Sukuk and corporate bonds with coupon and maturity.
- `get_tbill_auctions`: CBN Treasury Bill auction results with stop rates and yields.
- `get_block_trade_flow`: Net buying and selling in large trades over the last N days.
- `list_nasd_stocks`: Prices for securities on the NASD OTC exchange.
- `get_fx_rates`: Naira exchange rates against major currencies.
- `get_market_news`: Latest Nigerian business and capital-market headlines.
- `get_my_usage`: Shows the caller's plan, daily usage and limits.

## FAQ

### Do I need an API key to use it?

Tool discovery works without a key, but tool calls return a message linking to a free key. Calls require the key in the X-API-Key header or an api_key query parameter.

### What does the free plan include?

The free plan covers live prices, market summary, indices, ETFs, bonds, T-bill auctions, dividends, offers, block-trade flow and the last 7 days of price history, with 100 requests per day and 10 per minute.

### How much does the paid plan cost?

Starter is listed at $20 per month, Professional at $50 per month and Institutional at $200 per month, with NGN prices also shown.

### Which clients can connect?

The docs list Claude Code, Claude Desktop, Cursor, Windsurf, ChatGPT and other MCP clients, including URL-only connectors.

### Is Kobo Terminal NGX free?

Kobo Terminal NGX has a free plan, with paid plans for more usage or features. Paid plans start at $20 a month.

### How do I add Kobo Terminal NGX to Claude Code?

Run this command in your terminal: claude mcp add --transport http ngx https://koboterminal.com/mcp

### What are the best alternatives to Kobo Terminal NGX?

The closest alternatives to Kobo Terminal NGX are Finance: Stock, ETF & Crypto Data, Market Pi-Rates, 洋葱财报OnionData-MCP and Strata Finance.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Finance: Stock, ETF & Crypto Data](https://ai-powered.com/mcp/finance-stock-etf-and-crypto-data): Finance: Stock, ETF & Crypto Data is a paid MCP server for finance and payments.
- [Market Pi-Rates](https://ai-powered.com/mcp/market-pi-rates): Market Pi-Rates is a freemium MCP server for finance and payments.
- [洋葱财报OnionData-MCP](https://ai-powered.com/mcp/oniondata-mcp): 洋葱财报OnionData-MCP is a freemium MCP server for financial data.
- [Strata Finance](https://ai-powered.com/mcp/strata-finance): Strata Finance is an MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/kobo-terminal-ngx
