iTick

You run an MCP server that streams real-time stock quotes, K-line data, tick data, and market depth from iTick API. This server enables AI assistants to access up-to-date financial data across multiple markets with practical, ready-to-use endpoints and tooling.

How to use

You interact with the server through an MCP client. The server exposes a unified MCP endpoint at /mcp that you can query for real-time quotes, K-line data, tick data, depth, and analytics. You can configure your client to pass your iTick API key and request data for specific regions and stock codes. Use the provided endpoints to obtain current prices, historical candles, microsecond tick data, and analytical indicators for decision making.

How to install

Prerequisites: you need Python 3.8+ and a working network connection. You also need an iTick API key to access market data.

pip install -r requirements.txt

Create and populate the environment file with your API key and the port you want the server to run on.

cp .env.example .env

Edit .env to include your API key and your preferred port, for example:

ITICK_API_KEY=your_itick_api_key_here
PORT=3000

Start the server in development mode for automatic reloads during development, or in production mode for deployment.

# Development mode (auto-reload)
uvicorn src.server:app --reload --port 3000

# Production mode
uvicorn src.server:app --host 0.0.0.0 --port 3000

Configuration and access

After the server starts, you can access the MCP endpoint and health checks locally.

MCP endpoint: http://localhost:3000/mcp
Health check: http://localhost:3000/health
API docs: http://localhost:3000/docs

Claude Desktop integration

Configure Claude Desktop to use the local MCP server by adding a connection that points to the MCP endpoint and passes your API key in the request headers.

{
  "mcpServers": {
    "itick-stock": {
      "type": "streamableHttp",
      "url": "http://localhost:3000/mcp",
      "timeout": 600,
      "headers": {
        "X-Itick-Token": "your_itick_api_key_here"
      }
    }
  }
}

Available tools

itick_stock_quote

Fetches real-time stock quotes for a given region and code (e.g., SH, SZ, HK, US).

itick_stock_kline

Retrieves K-line data across multiple periods such as 1min, 5min, daily, weekly, and monthly.

itick_stock_tick

Returns tick-by-tick trade data for a specified stock, with high-resolution timing.

itick_stock_depth

Provides depth of book data (five or ten levels) for bid and ask.

current_timestamp

Returns the current timestamp in various formats for time-related needs.

itick_technical_indicators

Calculates technical indicators such as MACD, RSI, KDJ, Bollinger Bands, and moving averages.

itick_money_flow

Analyzes money flow and fund flow across segments like mega, large, medium, and small orders.

itick_index_analysis

Analyzes major market indices and sector indices with current and historical insights.

itick_sector_analysis

Analyzes industry sectors and concepts for strength, money flow, and opportunities.