Name: fffinstill MCP Server
Author: alraico

LABSCO 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 is not on npm, so you build the server from the repository: npm run build produces dist/cli.js, which speaks stdio and reads FINSTILL_API_KEY or --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.

Setup effort

Build from source — git clone https://github.com/alraico/fffinstill-mcp-server.git

See installation options

USE CASES

01

Working up a company from scratch

Run the full analysis prompt and get fundamentals, valuation and risk in one pass.

getCompanyMetricsgetReverseDCFgetBeneishScore

02

Finding candidates that match a thesis

Describe the criteria in words and let the screen translate them.

screenStocksdeepValueScreen

03

Sanity-checking a portfolio

Look at quality, risk and concentration across the holdings together.

getPortfolioAnalysiscrossReferencePortfoliogetBatchRiskMetrics

04

Deciding whether to hold through earnings

Read the ML prediction alongside the estimate revisions and past surprises.

getEarningsPredictiongetEstimateRevisionsgetEarningsSurprises

05

Reading the room before committing capital

Check the market signal, the macro regime and the sentiment picture.

getMarketSignalgetRegimeAnalysisgetFearGreedIndex

69 tools

Listed in project docs. Your client may show a different list.

getCompanyMetrics

getAnalystRatings

getPriceHistory

getQuarterlyFinancials

getScoreHistory

getReverseDCF

getBeneishScore

getZScoreHistory

getConvictionHistory

getMacroSensitivity

getEarningsPrediction

getEstimateRevisions

getCorrelatedStocks

getInstitutionalOwnership

getGeographicRevenue

BEFORE YOU INSTALL

What to know first

Tools you get

69 tools named in the project's documentation.

Requires

Node.js 18+
FINSTILL_API_KEY in your environment

Where it runs

All 3 documented clients run the server on your machine.

INSTALLATION

Connect your client

You clone and build this one yourself.

Server setup

TERMINAL

git clone https://github.com/alraico/fffinstill-mcp-server.git
cd fffinstill-mcp-server
npm install
npm run build

MCP Clients

Claude Desktop, Cursor

JSON

{
  "mcpServers": {
    "fffinstill": {
      "command": "node",
      "args": [
        "<YOUR_PATH_TO_FFFINSTILL_MCP_SERVER>/dist/cli.js"
      ],
      "env": {
        "FINSTILL_API_KEY": "<YOUR_FINSTILL_API_KEY>"
      }
    }
  }
}

VS Code

VS CODE · JSON

{
  "servers": {
    "fffinstill": {
      "type": "stdio",
      "command": "node",
      "args": [
        "<YOUR_PATH_TO_FFFINSTILL_MCP_SERVER>/dist/cli.js"
      ],
      "env": {
        "FINSTILL_API_KEY": "<YOUR_FINSTILL_API_KEY>"
      }
    }
  }
}

fffinstill MCP Server