highlowticker-algo-mcp

A read-only MCP server that lets an AI agent (Claude Desktop, Cursor) explore the live HighLowTicker algo feed conversationally. It consumes the feed into a rolling in-memory buffer and exposes a few query tools plus the wire-protocol schema as a resource.

Read-only by design. The server subscribes to the periodic market summary for itself, but it never sends a watch list, so it can never change the feed subscription state of any other program connected to the same socket. The capability to drive subscriptions belongs to your own strategy via the highlowticker-algo-feed client, not to this shared agent lens.

Install

pip install highlowticker-algo-mcp

Requirements

• HighLowTicker running with the algo feed enabled (Settings, Algo feed :7412).
• Python 3.10 or newer. (The plain highlowticker-algo-feed client works on 3.9; the MCP layer needs 3.10.)

Wire-protocol reference and examples: https://highlowtick.com/algo-feed.html

Tools

• get_market_summary() — latest market push/pull and breadth summary.
• recent_tape(symbol=None, kind=None, n=20) — recent new-high / new-low / price-update frames.
• top_movers(by="high", k=10) — symbols ranked by cumulative new-high or new-low count since session start.
• hottest_recent(by="high", k=10, window_seconds=300) — symbols ranked by new-high/new-low crossings in a trailing window (default 5 min), distinct from top_movers's cumulative count. Response includes coverage_seconds so a freshly-started MCP process visibly under-reports rather than silently claiming full-window coverage it hasn't observed yet.
• index_quotes() — last-known price/pct_change for configured index symbols (default SPY/QQQ/IWM, override via HLT_INDEX_SYMBOLS), retained even as the rolling tape buffer evicts older events.

Resources

• schema://algo-feed — the wire-protocol JSON Schema.
• doc://field-reference — a condensed field reference.
• doc://python-client-quickstart — how to use the hlt_algo_feed pypi package's Python API (AlgoFeed, run(), notify_when()) to write a standalone strategy script, including a minimal runnable example.

Claude Desktop config

Add to your MCP servers config:

{
  "mcpServers": {
    "highlowticker-algo-feed": {
      "command": "hlt-algo-mcp"
    }
  }
}

Interactive testing (MCP Inspector)

mcp dev loads its target as a standalone file, which breaks the package's relative imports. Use the scripts/mcp_dev.py shim (it re-exports the installed package's FastMCP instance) and keep the editable install active with -e .:

cd highlowticker-algo-mcp
source .venv/bin/activate
pip install "mcp[cli]"
mcp dev -e . scripts/mcp_dev.py:mcp

The background feed reader starts via the server's FastMCP lifespan, so the Inspector's Tools tab returns live data (feed must be running on :7412).