KoboTerminalNGX API DocsGet a free API key

MCP server

A hosted Model Context Protocol server at https://koboterminal.com/mcp. Your AI assistant gets 24 NGX tools: live prices, history, fundamentals, dividends, disclosures, insider dealings, bonds, T-bills and more.

Transport: Streamable HTTP (stateless, JSON responses). Auth: your Kobo API key. Calls count against your plan like normal API requests.

Claude Code

bash
claude mcp add --transport http kobo-terminal https://koboterminal.com/mcp \
  --header "X-API-Key: $KOBO_API_KEY"

Claude Desktop, Cursor, Windsurf and other clients

Add this to your MCP config (claude_desktop_config.json, .cursor/mcp.json, etc.):

json
{
  "mcpServers": {
    "kobo-terminal": {
      "url": "https://koboterminal.com/mcp",
      "headers": { "X-API-Key": "kobo_your_key_here" }
    }
  }
}

Clients that only support local (stdio) servers can bridge with mcp-remote:

json
{
  "mcpServers": {
    "kobo-terminal": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://koboterminal.com/mcp", "--header", "X-API-Key:kobo_your_key_here"]
    }
  }
}

Claude.ai, ChatGPT and other URL-only connectors

Where you can only paste a URL, put the key in the query string:

text
https://koboterminal.com/mcp?api_key=kobo_your_key_here

Tools

ToolWhat it doesPlan
get_market_summaryNGX All-Share Index level and daily change, market capitalisation, volume, value, deals and breadth (advancers, decliners, unchanged).Free
get_market_statusIs the NGX open right now? Weekend and Nigerian public-holiday aware.Free
list_stocksEvery listed NGX equity in one call: price, previous close, open/high/low, change, 7-day change, volume, value, trades, market cap, shares outstanding and sector.Free
get_price_historyDaily open, high, low, close and volume for one NGX stock, from May 2000 to today.Free
list_indicesAll 21 NGX indices: ASI, NGX30, NGX Premium, NGX Pension, Banking, Insurance, Consumer Goods, Oil & Gas, Industrial, Lotus Islamic, ASeM and more, with week, month, year and inception change.Free
get_indexOne NGX index by code or slug.Free
get_index_historyDaily closing levels for any NGX index, including the full All-Share Index history.Free
get_index_intradayToday's intraday points for an index (level, change, value and volume traded) plus the latest live reading.Free
list_etfsEvery NGX exchange-traded fund with ISIN, issuer, previous close, open/high/low, change, trades, volume and value.Free
get_etfOne ETF by symbol. Common aliases are resolved to the canonical NGX symbol.Free
get_fundamentalsValuation, profitability, leverage and dividend metrics for 145 NGX stocks in one call: P/E, forward P/E, EPS, dividend per share, dividend yield, beta, ROE, ROA, P/B, debt/equity, margins, plus EV/EBITDA, PEG, F-score, RSI and analyst consensus.Starter
lookup_identifiersMaps every NGX ticker to its ISIN and FIGI. 152 securities, 147 with a verified ISIN. Resolve an ISIN or FIGI back to a ticker.Starter
get_disclosuresNGX corporate filings: financial statements, board meeting notices, dividend declarations, director dealings, AGM notices and more, with links to the original PDFs.Starter
get_insider_dealingsStructured director-dealing filings: who bought or sold, role, volume, price, total value and holdings after the trade, plus weekly net insider flow and the most active tickers.Professional
get_dividend_historyEvery dividend a company has paid: amount per share, ex-dividend date, record (qualification) date and payment date.Free
get_dividend_calendarDividends across the whole market by ex-dividend date. Use upcoming=true for what is coming next.Free
get_offersOpen and recent NGX public offers, rights issues and IPOs with unit price, opening and closing dates and days remaining.Free
get_bondsNigerian FGN bonds, Eurobonds, Sukuk and corporate bonds listed on the NGX: issuer, type, currency, coupon, maturity and latest quoted clean price (yield to maturity where published).Free
get_tbill_auctionsCBN Nigerian Treasury Bill auction results: tenor, amount offered, subscribed and allotted, subscription rate, stop rate and yields.Free
get_block_trade_flowNet buying and selling in large trades (₦10 million and up) by stock over the last N days: where the big money is going.Free
list_nasd_stocksPrices for securities on the NASD OTC Securities Exchange (unlisted Nigerian companies such as NASD Plc, Friesland Campina WAMCO, Central Securities Clearing System and more).Starter
get_fx_ratesNaira exchange rates against USD, EUR, GBP, CAD, AUD, CNY, JPY, GHS, ZAR and AED.Professional
get_market_newsLatest Nigerian business and capital-market headlines from BusinessDay, Nairametrics, Premium Times, SEC Nigeria and more.Starter
get_my_usageYour plan, requests used today, daily limit, per-minute limit and lifetime requests.Free

Try it

Ask your assistant things like:

Without a key

tools/list works without a key so clients can discover the tools. Tool calls without a key return a message with a link to get a free key instantly.