market-mcp

Local MCP (stdio) for technical analysis of ETFs / indices / equities.

The market data implementation lives in the shared ../services/market-data package. This project exposes that implementation through MCP tools.

Features:

• Symbol resolution with equivalents fallback (exchange suffixes + UCITS).

• Automatic FRED routing for macroeconomic series alongside Yahoo Finance.

• Local equivalences persistence with registration and query tools.

• Locally calculated indicators (RSI, MACD, SMAs).

• Snapshots at three dates: current, last_week, last_month.

• Disk cache for OHLCV and snapshots.

• Compact responses with explicit reporting of when an equivalent was used.

Installation

uv sync

Related MCP server: polygon-mcp

Execution

uv run market-mcp

Configuration in Codex / OpenCode

OpenCode (opencode.json)

{
  "mcpServers": {
    "market-analysis": {
      "type": "local",
      "command": ["uv", "--directory", ".../mcp/marketdata", "run", "market-mcp"],
      "enabled": true
    }
  }
}

Codex

{
  "mcpServers": {
    "market-analysis": {
      "command": "uv",
      "args": ["--directory", ".../mcp/marketdata", "run", "market-mcp"]
    }
  }
}

Exposed tools

• register_ticker_equivalence

• list_ticker_equivalences

• get_ticker_equivalence

• get_etf_price_snapshot

• get_multiple_etf_price_snapshots

• get_price_history

• get_technical_snapshot

• evaluate_technical_signal

• compare_technical_snapshots

• get_maritime_chokepoint_status

Maritime chokepoints

get_maritime_chokepoint_status consults daily AIS observations from IMF PortWatch for hormuz, bab_el_mandeb, or both. It reports vessel counts, tankers, estimated capacity, rolling averages, data freshness, and AIS caveats. It does not provide maritime insurance premiums or coverage decisions.

FRED series

The following identifiers are routed automatically to FRED's CSV endpoint:

• T10YIE - 10-Year Breakeven Inflation Rate

• DFII10 - 10-Year Treasury Inflation-Indexed Security

• DGS10 - 10-Year Treasury Constant Maturity Rate

• DGS2 - 2-Year Treasury Constant Maturity Rate

• DGS30 - 30-Year Treasury Constant Maturity Rate

• T10Y2Y - 10-Year Treasury Constant Maturity Minus 2-Year Treasury Constant Maturity

• DTWEXBGS - Nominal Broad U.S. Dollar Index

The explicit FRED:<id> form is also supported. FRED observations are scalar daily values normalized as candles with equal open/high/low/close fields and no volume. Negative values, such as an inverted yield spread, are supported.

Persistent data

Runtime data must be outside Git and is configured through MARKET_DATA_ROOT:

export MARKET_DATA_ROOT="$HOME/ai/var/market-data"

The core creates these paths below the configured root:

• yahoo_ticker_equivalence_registry.json

• yahoo_ticker_memory.json

• ohlcv_cache/

• snapshot_cache/