Skip to main content
Glama
market-mcp

market-mcp

by mrsoto

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: market-data-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/

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      Enables querying real-time and historical financial market data for stocks, options, forex, and crypto, including quotes, trades, technical indicators, and reference data through a set of MCP tools.
      71
      3
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP clients to retrieve US stock market OHLCV data, company fundamentals and financial statements, FRED macroeconomic indicators, market news, Reddit/StockTwits sentiment, and Polymarket prediction market probabilities via simple tools.
      MIT
    • F
      license
      Not graded
      quality
      A
      maintenance
      Exposes Tiingo API endpoints as MCP tools so users can programmatically retrieve end-of-day and intraday prices, forex quotes, news articles, fundamentals and corporate actions like dividends and splits for given tickers.
      -