@pipeworx/mcp-finnhub
Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.
Needs to start: nothing
Contacts while installing and starting: gateway.pipeworx.io
What it contacted
gateway.pipeworx.io
Hosts it looked up or connected to while installing and starting with no input, watched from outside its sandbox. The npm registry is left out. Says nothing about what its tools contact when called.
Starting it
npx -y @pipeworx/mcp-finnhub@0.2.1
Installing a package runs its code. Use a sandbox for anything you have not read.
What its tools tell an agent
In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.
Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.
Tools
get_quote symbol, _apiKey
Get a real-time stock quote including current price, change, and volume. Example: get_quote({ symbol: "AAPL" })get_company_news symbol, from, to, _apiKey
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 symbol, from, to, _apiKey
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 symbol, limit, _apiKey
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 symbol, _apiKey
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 symbol, _apiKey
Analyst price-target consensus for a company — high, low, mean, and median 12-month price targets, and when they were last updated. Requires your own PAID Finnhub API key with price-target access, passed as _apiKey — Pipeworx's shared key is on a lower plan and cannot reach this endpoint. For free analyst buy/hold/sell trends without a key requirement beyond the shared one, use get_recommendation_trends instead. Example: get_price_target({ symbol: "AAPL", _apiKey: "your_finnhub_key" })finnhub_search_symbol query, _apiKey
Search for stock ticker symbols by company name or keyword. Returns matching symbols with descriptions. Example: search_symbol({ query: "apple" })Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.
Install facts
| License | MIT |
|---|---|
| Needs | node >=18 |
| Source | github.com/pipeworx-io/mcp-finnhub |
| Install scripts | None declared by it or anything installed with it. |
| Tarball | sha512-CXZXfhZ65FlOKHa/bbnzrcenu4QhZpoGMF2OSaGcU1VIP0oA+xRBwMd67PwFw3bguDdM4C4kl4IwbPK4ILwjkw== |
Check this report yourself
This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.
Report as JSONExact text and tokenHow to verify it
Show it on your README
[](https://bragproof.smaverk.com/r/%40pipeworx/mcp-finnhub)
New version out? Ask for a fresh report.