Get a real-time stock quote: price, % change, day high/low, and previous close.

Backed by Finnhub free tier. Returns 'no data' for unknown/delisted symbols (Finnhub returns zeros for unknowns — we treat that as no data, never fabricate).

Args: params: symbol (str) and response_format ('markdown'|'json').

Examples: - "What is Apple's current stock price?" -> symbol='AAPL' - "How much is NVIDIA up today?" -> symbol='NVDA' - "Get me a quote for Tesla" -> symbol='TSLA'

Fetch the latest market news — company-specific or general market headlines.

With a symbol: returns top 5 news items for that ticker from the past 7 days. Without a symbol: returns top 5 general market headlines. Backed by Finnhub free tier.

Args: params: symbol (optional ticker) and response_format ('markdown'|'json').

Examples: - "What's the latest news about Microsoft?" -> symbol='MSFT' - "Give me today's market news" -> (no symbol) - "Any news on Amazon this week?" -> symbol='AMZN'

Fetch the earnings calendar for the next N days.

Returns upcoming earnings reports with estimated EPS and revenue where available. NOTE: This endpoint may be premium-gated on the Finnhub free tier. If so, it degrades gracefully with an honest 'no data' message rather than fabricating events.

Args: params: days (int, 1-30, default 7) and response_format.

Examples: - "Which companies report earnings this week?" -> days=7 - "Show me earnings for the next 2 weeks" -> days=14 - "What's reporting tomorrow?" -> days=1

Scan a watchlist of stocks and rank them by absolute % change (biggest movers first).

Accepts up to 25 symbols. Unknown or delisted tickers are skipped gracefully. Useful for monitoring a portfolio or sector basket for unusual activity.

Args: params: symbols (comma-separated string, max 25) and response_format.

Examples: - "Which of AAPL, MSFT, GOOGL, AMZN, META is moving most today?" -> symbols='AAPL,MSFT,GOOGL,AMZN,META' - "Scan my tech watchlist: NVDA,AMD,INTC,TSM,AVGO" -> symbols='NVDA,AMD,INTC,TSM,AVGO' - "Show biggest movers in AAPL TSLA MSFT today" -> symbols='AAPL,TSLA,MSFT'

Composite market analysis: momentum score, news catalyst, and earnings proximity.

Combines real-time quote (momentum), latest news headline (catalyst), and earnings calendar (risk flag) into a single scored verdict. Each component degrades gracefully — if news or calendar are unavailable, only quote is used. Score: -100 (strong selling pressure) to +100 (strong upward momentum).

Args: params: symbol (str) and response_format ('markdown'|'json').

Examples: - "Give me a full read on Apple" -> symbol='AAPL' - "What's the momentum on NVIDIA right now?" -> symbol='NVDA' - "Analyze Tesla for me" -> symbol='TSLA'

Read open positions from an Alpaca paper trading account.

OPTIONAL — requires ALPACA_API_KEY and ALPACA_SECRET_KEY in .env. If keys are absent, returns a graceful 'no data' message with setup instructions. Read-only: never places orders or moves money.

Args: params: response_format ('markdown'|'json').

Examples: - "What positions do I have open in my paper account?" -> (no ticker needed) - "Show me my paper portfolio" -> (no ticker needed)