Getting Started with Stock API MCP

This guide shows how to connect an MCP client to the hosted FinFeedAPI Stock Historical MCP server.

Endpoint and authentication

• MCP endpoint: https://api-historical.stock.finfeedapi.com/mcp
• Header: X-APIKey: YOUR_API_KEY
• Transport: HTTP streaming MCP

Cursor example

Add the Stock Historical server to your MCP client configuration:

{
  "mcpServers": {
    "FinFeedAPI-Stock-Historical": {
      "url": "https://api-historical.stock.finfeedapi.com/mcp",
      "headers": {
        "X-APIKey": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Replace YOUR_API_KEY_HERE with your real API key and restart the client if required by your MCP application.

First requests to try

Once connected, these are the fastest ways to validate the integration:

1. List exchanges

Call stock_exchanges_list with no arguments.

Example response excerpt:

[
  {
    "exchange_id": "IEXG",
    "mic": "IEXG",
    "market_name_institution_description": "INVESTORS EXCHANGE",
    "iso_country_code": "US",
    "city": "NEW YORK",
    "status": "ACTIVE"
  },
  {
    "exchange_id": "XWAR",
    "mic": "XWAR",
    "market_name_institution_description": "WARSAW STOCK EXCHANGE/EQUITIES/MAIN MARKET",
    "iso_country_code": "PL",
    "city": "WARSAW",
    "status": "ACTIVE"
  }
]

2. List supported OHLCV periods

Call stock_ohlcv_periods_list with no arguments.

Example response excerpt:

[
  { "period_id": "1MIN", "display_name": "1 Minute" },
  { "period_id": "1HRS", "display_name": "1 Hour" },
  { "period_id": "1DAY", "display_name": "1 Day" },
  { "period_id": "1MTH", "display_name": "1 Month" }
]

3. Fetch latest OHLCV candles

Call stock_ohlcv_latest with:

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

Example response excerpt:

[
  {
    "time_period_start": "2025-04-07T00:00:00Z",
    "time_period_end": "2025-04-08T00:00:00Z",
    "price_open": 177.42,
    "price_high": 194.13,
    "price_low": 174.64,
    "price_close": 181.5,
    "volume_traded": 5763951,
    "trades_count": 67137
  }
]

Recommended workflows

Symbol-level OHLCV workflow

1. Call stock_exchanges_list.
2. Select an exchange_id.
3. Call stock_symbols_list for that exchange.
4. Call stock_ohlcv_periods_list.
5. Fetch data with stock_ohlcv_latest or stock_ohlcv_history.

Exchange-wide OHLCV workflow

Use stock_ohlcv_history_by_exchange when you want one time window across all symbols on a venue.

{
  "exchange_id": "IEXG",
  "period_id": "1MIN",
  "time_start": "2025-04-07T12:00:00Z",
  "time_end": "2025-04-07T13:00:00Z"
}

The window between time_start and time_end must not exceed 24 hours.

Native IEX workflow

Use the stock_native_iex_* tools with:

• symbol, for example AAPL
• date, for example 2025-04-07T00:00:00Z
• optional limit

Example stock_native_iex_trades payload:

{
  "symbol": "AAPL",
  "date": "2025-04-07T00:00:00Z",
  "limit": 2
}

Example response excerpt:

[
  {
    "symbol": "AAPL",
    "timestamp": "2025-04-07T12:05:21.6031069Z",
    "size": 40,
    "price": 182.01,
    "isExtendedHoursTrade": true
  }
]

Troubleshooting

No tools appear in the client

• Verify the endpoint URL is exactly https://api-historical.stock.finfeedapi.com/mcp.
• Confirm the request includes the X-APIKey header.
• Restart the MCP client after editing its configuration.

Native IEX call returns an error

If you see an error such as:

There is no TOPS data for symbol=AAPL at the date=2026-04-07.

it usually means the chosen symbol/date combination has no dataset available for that day. Retry with another trading date.

OHLCV returns no rows

• Check that the exchange_id and symbol_id match.
• Confirm the period_id is supported by stock_ohlcv_periods_list.
• Verify the requested time range actually contains market activity.