mcp-market-data

Market & Options Data MCP ("market-data") — FastAPI server

A deployable, minimal, vendor-pluggable service that exposes endpoints used by an LLM or any client to fetch OHLCV, option chains, Greeks, basic corporate events, and to assemble a training dataset with alignment/caching. Uses yfinance as a default provider so it runs out-of-the-box; swap in Polygon/IEX/etc by implementing the DataProvider interface below.

Run locally:

  pip install -r requirements.txt
  uvicorn app.main:app --host 0.0.0.0 --port 8000

Docker:

  docker build -t mcp-market-data:edge .
  docker run -p 8000:8000 --name mcp-market-data mcp-market-data:edge

Example curl:

  curl "https://market-data.verumnomen.com/get_ohlcv?symbol=AAPL&timeframe=1d&start=2024-01-01&end=2024-06-30"
  curl -X POST https://market-data.verumnomen.com/make_dataset -H 'Content-Type: application/json' -d '{
    "symbols":["AAPL","NVDA"],
    "features":["ohlcv(1d,120d)","rv_park(5d)","ret_1d","iv30"],
    "horizon":"1d","window":"180d","align":"market_close"
  }'

Notes

• Image will publish to ghcr.io/pishnuke/mcp-market-data:edge on master, plus a sha-<short> tag, and to ghcr.io/pishnuke/mcp-market-data:<tag> when you push a Git tag like v0.1.0.

• Ensure your repo is public or that consumers have permission to pull from GHCR. For private repos, consumers need a token.

• The GHCR repository name is lowercase; if your GitHub org/repo has uppercase, GHCR normalizes it.

Point your MCP client at mcp.json (or the running URL) and call tools like /get_ohlcv.