MCP server exposing 7 tools for finnhub.
This URL is a JSON-RPC 2.0 endpoint over HTTP. Issue POST requests with a JSON-RPC body. Browsers and search crawlers land here on GET.
POST https://gateway.pipeworx.io/finnhub/mcp
Content-Type: application/json
{"jsonrpc":"2.0","id":1,"method":"tools/list"}
get_quote — Get a real-time stock quote including current price, change, and volume. Example: get_quote({ symbol: "AAPL" })get_company_news — Get recent news articles about a company within a date range. Returns headline, summary, source, and URL. Example: get_company_news({ symbol: "AAPL", from: "2024-01-01", to: "2024-01-31" })get_earnings_calendar — Get upcoming and recent earnings reports. Pass `symbol` for one company's earnings dates, or omit it for the whole market. Optionally filter by date range. Example: get_earnings_calendar({ symbol: "CRM", from: "2026-01-01", to: "2026-06-30" })get_earnings_surprises — EPS actual vs analyst (consensus) estimate, beat or miss, for a company's recent quarters — the "earnings surprise" history. Returns per quarter: fiscal period, EPS actual, EPS estimate, surprise amount and percent. Revenue is NOT included (Finnhub's earnings-surprise data is EPS-only); for revenue estimates on upcoming quarters, see get_earnings_calendar. Example: get_earnings_surprises({ symbol: "MSFT", limit: 4 })get_recommendation_trends — Analyst recommendation trends for a company — counts of Strong Buy / Buy / Hold / Sell / Strong Sell, by month, for the last several months. Example: get_recommendation_trends({ symbol: "AAPL" })get_price_target — Analyst price-target consensus for a company — high, low, mean, and median 12-month price targets, and when they were last updated. Example: get_price_target({ symbol: "AAPL" })search_symbol — Search for stock ticker symbols by company name or keyword. Returns matching symbols with descriptions. Example: search_symbol({ query: "apple" })Code samples (curl / TypeScript / one-click client install), schemas, and the live playground are on the pack page:
https://pipeworx.io/packs/finnhub/
Pipeworx is an open MCP gateway connecting AI agents to live data. pipeworx.io