mcpField
W
watchlist-brief

watchlist-brief

github.com/eli-alvaradoData & databases310 installsUpdated 6d ago
Repository

About watchlist-brief

A skill for producing morning or closing summaries of a stock watchlist, including prices, changes, technical indicators, stop and target proximity, and upcoming earnings. It keeps the report informational and factual, with no trade recommendations or order placement.

Key features

  1. 01Creates morning and closing briefs
  2. 02Summarizes prices and daily changes
  3. 03Shows RSI and moving-average trends
  4. 04Tracks distance to stops and targets
  5. 05Highlights earnings and notable conditions
  6. 06Includes data source and delay notes

Use cases

  1. 01Review a watchlist before the market opens
  2. 02Summarize closing levels and daily moves
  3. 03Spot upcoming earnings and nearby stop or target levels

MCP support

The workflow may use news tools, including tickertick, when available to add a sourced headline for notable tickers.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/eli-alvarado/us-watchlist-alerts --skill watchlist-brief

After installing, type/watchlist-briefin Claude Code to confirm it loaded.

Details

From the project README

Watchlist Brief (morning / close)

Informational summary only - not financial advice; no trade suggestions or order placement.

Steps

  1. Determine context with python scripts/market_calendar.py. Morning brief ~08:30-09:25 ET; close brief after 16:05 ET. On holidays/weekends, say the market is closed and give the next session.
  2. Generate the table: python scripts/brief.py --kind morning (or --kind close). Columns: Ticker | Price | Chg | RSI14 | Trend (SMA50 vs SMA200) | To stop | To target 1. "To stop" is remaining cushion (positive = room left); shorts use stop-minus-price. Earnings dates in the footer are upcoming only (Yahoo calendarEvents, then Finnhub, then Alpha Vantage, or already on the quote).
  3. Run python scripts/alerts.py --dry-run --force-session --format json to list conditions currently true without consuming cooldowns; mention notable ones.
  4. Optionally add 1 headline per ticker that moved > 3% or has earnings within 7 days (web search, or tickertick/news tools if available). Cite sources; never fabricate news.
  5. Write the brief:
    • Headline (one sentence: the overall picture of the list).
    • The table.
    • Watch today / tomorrow: earnings, tickers within 3% of stop or target, gap moves.
    • Data source + delay note, and "Informational only - not financial advice." Keep it under ~250 words unless asked for more.

Morning vs close

  • Morning: use prior close as baseline; mention pre-market moves only if the data source returns them (label as pre-market).
  • Close: day's change, closing levels vs stops/targets, anything that triggered today, what's on tomorrow's calendar.

Tone

Neutral and factual: "TSLA is 2.1% above its stop" - not "you should sell TSLA".

Comments

Markdown supported