Skip to main content
Glama
NG-Bullseye

nvda-cpi-watch

by NG-Bullseye
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

nvda-cpi-watch

MCP-Server + Repo-Agent fuer NVDA-Earnings + US-CPI Daten. Liefert historische Werte, Markt-Forecasts (Finnhub), Live-Nowcasts (Cleveland Fed), und einen aggregierten Trade-Brief fuer den naechsten CPI-Release.

Quickstart

cd ~/repos/nvda-cpi-watch
cp .env.example .env
# Edit .env: FINNHUB_API_KEY=... (free key from https://finnhub.io/register)

# Dependencies sind im venv installiert. Falls nicht:
python3 -m venv venv && venv/bin/pip install -r requirements.txt

# Agent spawnen (Repo-MCP wird automatisch geladen via .mcp.json):
tmux new-session -d -s nvda-cpi-watch "cd ~/repos/nvda-cpi-watch && claude --mcp-config .mcp.json"
tmux attach -t nvda-cpi-watch

Alternativ Standalone-Server testen:

venv/bin/python server.py < /dev/null   # startet stdio-loop, EOF beendet

Related MCP server: IsoFinancial-MCP

Tools

Tool

Zweck

Quelle

cpi_latest

Letzter Headline + Core CPI, MoM/YoY

BLS API v2

cpi_history(months=N)

Reihe der letzten N Monate

BLS API v2

cpi_next_release

Naechster Release-Termin

BLS Schedule (hardcoded)

cpi_consensus

Markt-Konsens: Headline YoY/MoM, Core MoM (direkt) + Core YoY (derived)

Median aus TradingView + ForexFactory + Investing.com, dazu BLS

cpi_forecast

DEPRECATED. Finnhub-Index, kein YoY.

Finnhub

cpi_nowcast

Cleveland Fed Live-Modell

clevelandfed.org (HTML-scrape)

cpi_trade_brief

Aggregat: Konsens (incl. derived Core YoY) + Nowcast + Previous + Spreads

alle

nvda_earnings_history(quarters=N)

Letzte N Quartale

Finnhub

nvda_earnings_next

Naechster Earnings-Termin

Finnhub

Env

Var

Notwendig

Quelle

FINNHUB_API_KEY

Ja, fuer Forecast + Earnings

https://finnhub.io/register

BLS_API_KEY

Nein (optional, hoehere Limits)

https://data.bls.gov/registrationEngine/

Architektur

server.py            ← MCP stdio, Tool-Registry, Dispatch, derivations
├── bls.py           ← BLS API client + CPI Release Schedule
├── finnhub.py       ← Finnhub client (Earnings + Economic Calendar)
├── clevelandfed.py  ← HTML scraper fuer Inflation Nowcasting
├── tradingview.py   ← TradingView calendar (consensus source, median)
├── forexfactory.py  ← ForexFactory feed (consensus source, median)
├── investing.py     ← Investing.com event-page scraper (consensus source, median)
└── cache.py         ← File-Cache (TTL je Tool)

Core YoY Derivation: Free APIs publizieren keinen direkten Core-CPI-YoY-Konsens (nur Core MoM). Wir berechnen es deterministisch: core_yoy_forecast = (latest_core_idx × (1 + core_mom_forecast/100)) / year_ago_core_idx - 1 mit latest_core_idx und year_ago_core_idx aus BLS. Source-Transparenz im _derivation-Feld des Briefs.

Cache-Files unter cache/*.json (gitignored). TTLs: BLS 6h, Finnhub Earnings 1h, Forecast 30min, Konsens 15min, Nowcast 3h.

Phase 1 = passiv

Aktuelle Phase: on-demand Daten-Server. Keine Alerts, keine Cron-Jobs, keine HA-Integration. Roadmap → docs/vision.md, Stand → docs/STATUS.md.

Disclaimer

Daten-Server, keine Anlage- oder Trade-Beratung. Werte direkt aus BLS / Finnhub / Cleveland Fed; bei Drift Source pruefen.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • market-data-mcp

    SmashToes
    -
    license
    Not graded
    quality
    Not graded
    maintenance
    Real-time financial market data MCP server. Stocks, crypto, technicals, sentiment, FDA calendar. No API keys required.
    -

  • IsoFinancial-MCP

    Niels-8
    A
    license
    Not graded
    quality
    D
    maintenance
    An enhanced MCP server providing comprehensive financial market data endpoints for quantitative trading analysis, including SEC filings, FINRA short volume, earnings, news, and Google Trends. It features meta-tools that consolidate multiple data sources into single efficient calls, optimizing for AI agents with iteration budgets.
    8
    MIT

  • mcp-financex

    xerktech
    A
    license
    A
    quality
    B
    maintenance
    Comprehensive MCP server for real-time stock, cryptocurrency, options, and fundamental analysis, including SEC filings and insider trading data.
    26
    37 npm
    MIT
  • siftingio-mcp by SiftingIO

    siftingio-mcpofficial

    SiftingIO
    A
    license
    A
    quality
    C
    maintenance
    MCP server that provides access to SiftingIO market data, including live prices, SEC filings, OHLCV bars, 13F holdings, market status, and economic calendar tools for AI assistants.
    36
    19 npm
    1
    MIT

Appeared in Searches