Finnhub

@finnhub show me the latest price and key financial metrics for AAPL

Apple Inc. (AAPL) is currently trading at $178.42, up 1.2% today. Key metrics from the most recent quarter: P/E ratio 29.3, market cap $2.78T, revenue $89.5B (up 2% YoY), net margin 25.3%, ROE 147.8%. The company's next earnings call is scheduled for January 30, 2025. This snapshot combines real-time quote data with quarterly fundamentals; note that metric definitions follow Finnhub's calculation methodology, which may differ slightly from other providers.

This example demonstrates combining quote and financial-metrics tools to build a quick investment snapshot. Requires a valid API key with access to both real-time quotes and fundamental data. Rate limits apply per endpoint—fetching quotes and metrics for multiple tickers in rapid succession may hit daily caps on free-tier keys.

@finnhub list all earnings releases scheduled for the next 7 days in the tech sector

Upcoming earnings releases (next 7 days): Microsoft (MSFT) - Jan 28 after market close, estimated EPS $2.78; Tesla (TSLA) - Jan 29 after close, estimated EPS $0.73; Meta Platforms (META) - Jan 31 after close, estimated EPS $5.23; Intel (INTC) - Feb 1 before open, estimated EPS $0.12. This calendar reflects Finnhub's aggregated schedule; exact timing and estimates may shift as companies file 8-Ks or issue guidance updates closer to the date.

This showcases the calendar-events tool for forward-looking earnings schedules. Keep date ranges narrow (7-14 days) because Finnhub returns unsorted, unpaginated results—wide windows can produce unwieldy lists. The tool does not filter by sector natively; the AI infers sector membership from ticker context or requires you to specify tickers explicitly.

@finnhub compare the last four quarters of reported revenue and net income for NVDA versus AMD, then summarize which showed stronger growth momentum

NVIDIA (NVDA): Q1 '24 revenue $26.0B, net income $14.9B; Q2 revenue $30.0B, net income $16.6B; Q3 revenue $35.1B, net income $19.3B; Q4 revenue $22.1B, net income $12.3B. AMD: Q1 revenue $5.5B, net income $0.1B; Q2 revenue $5.8B, net income $0.3B; Q3 revenue $6.8B, net income $0.7B; Q4 revenue $6.2B, net income $0.7B. NVIDIA demonstrated 35% sequential revenue growth from Q1 to Q3, while AMD grew 24% over the same span. NVIDIA's net margin averaged 55% versus AMD's 10%, indicating stronger profitability scaling alongside top-line expansion.

This example pairs the reported-financials tool with AI reasoning to synthesize a comparative narrative. Finnhub returns as-reported GAAP figures, which may include one-time charges or restatements—always cross-check material discrepancies with SEC filings. Fetching multi-quarter data for two companies counts as multiple API calls; monitor your rate limit if running similar comparisons across many tickers.

When Finnhub beats spreadsheets for tracking 8-12 holdings

A three-person angel syndicate meets monthly to review their dozen portfolio companies. They need current valuations, recent earnings, and peer comparisons without paying for Bloomberg. Finnhub's Get Quotes tool pulls snapshots for all tickers in one call, Get Company Financial Metrics surfaces key ratios, and List Earnings Results flags which startups beat or missed estimates. The API key setup takes five minutes and the 11 tools cover 90 percent of their review agenda. This breaks down if you're tracking private companies or need intraday alerts—Finnhub only serves public equities and the MCP doesn't push notifications. If your portfolio is under 20 tickers and you meet on a fixed cadence, Finnhub replaces the manual Yahoo Finance ritual and keeps everyone on the same data set.

Why Finnhub works for tier-one stock-question triage

A four-person support team at a retail investing app fields 200 tickets a day asking why a stock price looks wrong or when earnings are scheduled. Get Quote and List Calendar Events answer 60 percent of those questions in under ten seconds without escalating to engineering. The support agent pastes the ticker into Switchy, the MCP returns the latest price and the next earnings date, and the ticket closes. Get Market Status confirms whether an exchange is open so the agent doesn't blame the app for a holiday gap. This only works if your product surfaces US-listed equities—Finnhub's coverage is strong there but thin on international exchanges. If most tickets involve options chains or historical data, you need a heavier integration. For first-line stock lookups at small-team scale, Finnhub keeps support out of the engineering queue.

When Finnhub replaces manual data pulls for sector notes

A two-analyst team at a 50-million-dollar fund writes a weekly memo comparing five to eight stocks in a target sector. They used to copy-paste financials from EDGAR and Yahoo into a Google Doc. Now they run Get Company Financial Metrics and Get Reported Financials in Switchy, drop the output into their draft, and spend the saved hour on narrative instead of data hygiene. List Earnings Results surfaces which companies surprised the street, and Get Company Profile confirms ticker-to-name mappings so they don't misattribute a subsidiary. The 11-tool limit means they can't automate charting or build a custom screener, but for a weekly cadence and a narrow watchlist, the MCP delivers clean data without a vendor call. If your memo needs real-time intraday moves or derivatives pricing, Finnhub won't close the loop—stick to end-of-day snapshots and fundamental metrics.