Stock Historical MCP Tool Reference

The Stock Historical MCP server currently exposes 11 tools.

Metadata tools

stock_exchanges_list

Returns all supported stock exchanges and venue metadata.

Arguments

This tool does not require any arguments.

Returns

Each item can include fields such as:

• exchange_id
• mic
• market_name_institution_description
• legal_entity_name
• iso_country_code
• city
• website
• status
• last_datapoint_date

Use when

• You need to discover supported venues before making symbol or OHLCV calls.
• You want MIC codes and basic venue metadata.

stock_symbols_list

Returns all symbols for a single exchange.

Required arguments

Use when

• You already know the venue and need valid symbol_id values for follow-up OHLCV calls.

OHLCV tools

stock_ohlcv_periods_list

Returns the list of supported candle granularities.

Arguments

This tool does not require any arguments.

Typical periods

• 1MIN
• 1HRS
• 1DAY
• 1MTH
• 1YRS

Each row also includes period metadata such as length_seconds, length_months, and display_name.

stock_ohlcv_latest

Returns the latest OHLCV candles for one exchange symbol in descending time order.

Required arguments

Optional arguments

Returns

Rows contain fields such as:

• time_period_start
• time_period_end
• time_open
• time_close
• price_open
• price_high
• price_low
• price_close
• volume_traded
• trades_count

stock_ohlcv_history

Returns historical OHLCV candles for one exchange symbol in ascending time order.

Required arguments

Optional arguments

Use when

• You need a bounded historical window for one symbol.
• You want deterministic ascending output for backfills or batch processing.

stock_ohlcv_history_by_exchange

Returns historical OHLCV data for all symbols on one exchange within a bounded time range.

Required arguments

Important

The time span between time_start and time_end cannot be more than 24 hours.

Use when

• You need venue-wide candles instead of a single symbol.
• You are building cross-sectional or exchange-level analytics for a short window.

Native IEX tools

All native IEX tools use the same basic argument pattern.

Required arguments

Optional arguments

stock_native_iex_system_events

Returns IEX market-wide operational events for a given date.

Examples of returned information

• Start of messages
• Start of system hours
• Start or end of regular market hours
• End of messages

stock_native_iex_admin_messages

Returns administrative messages for a symbol and date.

Examples of returned information

• Short sale price test status
• Operational halt status
• Official prices
• Auction-related state

stock_native_iex_level1_quotes

Returns Level 1 quote updates for a symbol and date.

Typical fields

• bidPrice
• bidSize
• askPrice
• askSize
• isPrePostMarketSession
• isSymbolAvailable

stock_native_iex_level2_price_levels

Returns aggregated Level 2 order book depth updates for a symbol and date.

Typical fields

• price
• size
• isSideBuy
• isEventProcessingComplete

stock_native_iex_level3_order_book

Returns Level 3 order book events for a symbol and date.

Typical event families

• Add order
• Modify order
• Delete order
• Order execution
• Clear book

The payload structure depends on the event type, for example addOrder or deleteOrder.

stock_native_iex_trades

Returns trade prints and trade breaks for a symbol and date.

Typical fields

• timestamp
• price
• size
• tradeID
• isTradeBreak
• isExtendedHoursTrade
• isOddLotTrade

Practical examples

Example: latest daily candles for AAPL on IEX

{
  "tool": "stock_ohlcv_latest",
  "arguments": {
    "exchange_id": "IEXG",
    "symbol_id": "AAPL",
    "period_id": "1DAY",
    "limit": 2
  }
}

Example: historical candles for a fixed time window

{
  "tool": "stock_ohlcv_history",
  "arguments": {
    "exchange_id": "IEXG",
    "symbol_id": "AAPL",
    "period_id": "1DAY",
    "time_start": "2025-04-01T00:00:00Z",
    "time_end": "2025-04-07T00:00:00Z",
    "limit": 100
  }
}

Example: IEX trades for one day

{
  "tool": "stock_native_iex_trades",
  "arguments": {
    "symbol": "AAPL",
    "date": "2025-04-07T00:00:00Z",
    "limit": 100
  }
}

Usage guidance

• Use exchange_id and symbol_id for metadata and OHLCV tools.
• Use plain symbol and date for native IEX tools.
• Start with discovery tools before issuing large historical requests.
• Treat symbol lists as potentially large responses and cache them client-side when possible.
• Expect empty results or explicit errors when requesting dates without underlying venue data.