MCP server for fffinstill — investment analysis for 2,260+ US equities.
Connect Claude Desktop, Cursor, VS Code, or any MCP-compatible AI assistant to fffinstill's stock analysis, screening, macro data, ML earnings predictions, and alternative data tools.
69 tools — Stock analysis, screening, portfolio analytics, macro indicators, ML predictions, insider/congressional trades, alternative data, risk metrics, 18 academic factor models, and 13 Business-exclusive tools
7 resources — Market signal, macro regime, Fear & Greed, sector overview, company summaries
15 prompts — Pre-built workflows for stock analysis, comparison, screening, macro outlook, portfolio health, alternative data, market dashboard, deep value, risk assessment, growth momentum, income analysis, factor models, insider intelligence
Related MCP server: equivault-mcp
Sign up at fffinstill.com and generate an API key at Settings → API.
Requires a Founding, Pro, or Business subscription.
Add to ~/.config/claude/claude_desktop_config.json (Linux/macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"fffinstill": {
"command": "npx",
"args": ["-y", "@fffinstill/mcp-server"],
"env": {
"FINSTILL_API_KEY": "finstill_xxx_yyy"
}
}
}
}Add to .cursor/mcp.json in your project root:
{
"mcpServers": {
"fffinstill": {
"command": "npx",
"args": ["-y", "@fffinstill/mcp-server"],
"env": {
"FINSTILL_API_KEY": "finstill_xxx_yyy"
}
}
}
}Add to .vscode/mcp.json in your project root:
{
"servers": {
"fffinstill": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@fffinstill/mcp-server"],
"env": {
"FINSTILL_API_KEY": "finstill_xxx_yyy"
}
}
}
}Once configured, your AI assistant can:
"Analyze AAPL" → calls getCompanyMetrics, getReverseDCF, getBeneishScore, etc.
"Screen for high-quality tech stocks" → uses the screen-stocks prompt
"Compare NVDA, AMD, and INTC" → calls compareTickers
"What's the macro outlook?" → uses the macro-outlook prompt
"Is MSFT likely to beat earnings?" → uses earnings-preview prompt
# With npx (no install)
npx @fffinstill/mcp-server --api-key finstill_xxx_yyy
# With environment variable
FINSTILL_API_KEY=finstill_xxx_yyy npx @fffinstill/mcp-server
# Global install
npm install -g @fffinstill/mcp-server
fffinstill-mcp --api-key finstill_xxx_yyy
# Show help
fffinstill-mcp --helpTool | Description |
| Full fundamentals: revenue, margins, valuations, quality scores |
| Consensus, price targets, ratings breakdown |
| Weekly prices with returns (default: 52 weeks) |
| 8 quarters: revenue, margins, ROIC, D/E |
| Composite quality score (7 components) over 12 periods |
| Bear/base/bull fair value scenarios |
| M-Score earnings manipulation detection |
| Altman Z-Score bankruptcy risk history |
| Insider conviction trajectory scores (buying patterns) |
| Sensitivity to rates, inflation, VIX, USD |
| ML earnings beat/miss prediction |
| Analyst EPS revision trends |
| Price correlation analysis with sector peers |
| Top holders, whale activity, concentration risk |
| Revenue by geographic region |
| Business segment revenue breakdown |
Tool | Description |
| Multi-factor screen of 2,260+ stocks |
| Piotroski ≥ 6 value stocks |
| 2-5 stocks side-by-side |
| Aggregate statistics across top 100 stocks |
| Multi-holding portfolio analytics |
| Portfolio vs market signal alignment |
| Pre-computed strategy picks |
Tool | Description |
| Current signal with 5-component breakdown |
| Macro regime classification |
| FRED data (CPI, GDP, rates, etc.) |
| Fear & Greed with optional history |
| Top stocks by market cap for a sector |
| BLS economic data (employment, CPI, PPI) |
| Macro Google Search Volume for stress terms |
| Historical regime transitions |
| Daily signal history + SPY returns |
| Advance/decline, new highs/lows |
| Upcoming earnings reports calendar |
| Fuzzy search 2,260+ US equities |
| Sector performance heatmap with top gainers/losers |
Tool | Description |
| SEC Form 4 insider trades |
| STOCK Act trades |
| Historical beats/misses |
| Revenue & earnings acceleration |
| 13D/13G activist & ownership filings |
| Revenue/employee, SGA/employee, headcount |
| Reverse ETF lookup with weights |
| Biotech/pharma trial pipeline |
| Federal lobbying spend & issues |
Tool | Description |
| Next earnings date and reporting details |
| Peer group analysis with relative rankings |
| Historical P/E, P/S, EV/EBITDA time series |
| Beta, max drawdown, Sharpe, Sortino, VaR |
| Multi-year revenue, income, margins trajectory |
| Industry-specific KPIs and operational metrics |
| Wikipedia + Google Trends anomalies |
| Residual income, accruals quality, Fama-French |
| ML composite foresight/trajectory score |
| Derived insider conviction patterns and clusters |
| AI analyst buy/hold/sell verdict with thesis |
Tool | Description |
| Government contract awards (by company or screened) |
| Volatility analysis: risk metrics, vs SPY benchmark |
| Reddit sentiment & mention trends |
| Active M&A deals with spreads |
| ML predictions for multiple tickers |
| ETF holdings, sector breakdown |
| Upcoming IPOs with pricing details |
| Unusual attention spikes across universe |
| Full sentiment: AAII, VIX, put/call, ISM |
| Aggregated contract exposure: 12-month totals, top agencies |
| Risk metrics for multiple tickers |
| 18 academic factor models with scores |
| Stocks on quality improvement streaks |
Resource URI | Description | Cache |
| Current market signal | 5 min |
| Macro regime | 1 hour |
| Fear & Greed Index | 1 hour |
| Sector aggregates | 1 hour |
| Company summary | 24 hours |
| Tool documentation | Static |
| Covered tickers | 24 hours |
Prompt | Args | Description |
|
| Full stock analysis (15 tools) |
|
| Side-by-side comparison |
|
| NL criteria → stock screen |
| — | Macro environment summary (10 tools) |
| — | Sector rotation analysis |
|
| Pre-earnings analysis (10 tools) |
|
| Portfolio health: quality, risk, concentration |
|
| Non-traditional data deep dive |
| — | Comprehensive market overview (13 tools) |
|
| Deep value stock discovery |
import { createServer, connectStdio } from '@fffinstill/mcp-server';
const server = createServer({
apiUrl: 'https://fffinstill.com',
apiKey: process.env.FINSTILL_API_KEY!,
});
await connectStdio(server);This server implements the full MCP specification:
Tool annotations: All 69 tools declare readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true, and human-readable title fields
Resource metadata: All resources include title, mimeType, description, and audience/priority annotations
Capabilities: Explicitly declares tools, resources, and prompts with listChanged: false
Server instructions: Provides server-level instructions for LLM context
Rate limits depend on your subscription tier:
Plan | Requests/min | Monthly cap |
Founding | 20 | 1,000 |
Pro | 20 | 1,000 |
Business | 60 | Unlimited |
MIT
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
An MCP server for deep research or task groups
MCP server for Gainium — manage trading bots, deals, and balances via AI assistants
MCP server for Flux AI image generation
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/alraico/fffinstill-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server