Labsco
MCP SERVER

fffinstill MCP Server

by alraico ↗

69 read-only equity research tools — fundamentals, screening, macro, ML earnings predictions and alternative data.

Equity & Fund Market Data
Summary
The prompts are how you use 69 tools without knowing all 69.

A surface this size is unusable by tool name alone, which is why `analyze-stock` chains 15 calls and `market-dashboard` chains 13 — you ask one question and the workflow fans out. The read-only annotations across every tool are worth noting too: nothing here can place a trade or change an account.

What it is

The official server for fffinstill, an investment analysis service covering 2,260+ US equities. It brings the whole research surface into a conversation: company fundamentals, multi-factor screening, portfolio analytics, macro indicators, machine-learning earnings predictions, insider and congressional trades, and 18 academic factor models.

What you get
  • 69 tools, 7 resources and 15 prompts. Every tool declares `readOnlyHint: true` and `destructiveHint: false`
  • Stock analysis (16): `getCompanyMetrics`, `getQuarterlyFinancials`, `getReverseDCF` for bear/base/bull fair value, `getBeneishScore` for earnings-manipulation detection, `getZScoreHistory` for bankruptcy risk, `getEarningsPrediction`, `getInstitutionalOwnership`, `getSegmentRevenue` and more
  • Screening and portfolio (7): `screenStocks` across the whole universe, `deepValueScreen`, `compareTickers` for 2-5 side by side, `getPortfolioAnalysis`, `getStrategyPicks`
  • Market and macro (13): `getMarketSignal`, `getRegimeAnalysis`, `getMacroIndicator` for FRED data, `getFearGreedIndex`, `getBLSIndicator`, `getMarketBreadth`, `getEarningsCalendar`, `searchStocks`
  • Alternative data (9): `getInsiderActivity` from SEC Form 4, `getCongressionalTrades` under the STOCK Act, `getLargeShareholderFilings`, `getETFExposure`, `getClinicalTrials`, `getLobbyingActivity`
  • Advanced (11) and Business-exclusive (13): `getRiskMetrics`, `getAcademicFactors`, `getAIVerdict`, plus `getGovtContracts`, `getMergerDeals`, `getRedditMentions`, `getFactorModelScores` and batch variants
  • Resources under `finstill://` for the market signal, macro regime, Fear & Greed, sector overview and company summaries; prompts including `analyze-stock`, `screen-stocks`, `macro-outlook`, `earnings-preview` and `portfolio-health-check`
Requirements

A fffinstill account on a Founding, Pro or Business subscription, with an API key generated under Settings → API and passed as `FINSTILL_API_KEY`. The README's run line names `@fffinstill/mcp-server`, which npm does not have; the command it documents is `fffinstill-mcp`, speaking stdio and taking `--api-key`. Rate limits follow the plan: Founding and Pro get 20 requests a minute and 1,000 a month; Business gets 60 a minute with no monthly cap. Thirteen of the tools are Business-only.