fffinstill MCP Server
About
Investment analysis for 2,260+ US equities — 43 tools for stock screening, ML earnings predictions, insider/congressional trades, macro signals, Fear & Greed, and alternative data.
Details
- Author
- alraico
- Categories
- Finance, AI, Other
Jump to
Setup
Install fffinstill MCP Server in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/alraico/fffinstill-mcp-server
Follow the installation instructions in the repository README, then restart your MCP client.
MCP server forfffinstill— 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
Sign up atfffinstill.comand generate an API key atSettings → 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.jsonin your project root:
{ "mcpServers": { "fffinstill": { "command": "npx", "args": ["-y", "@fffinstill/mcp-server"], "env": { "FINSTILL_API_KEY": "finstill_xxx_yyy" } } } }
Add to.vscode/mcp.jsonin your project root:
{ "servers": { "fffinstill": { "type": "stdio", "command": "npx", "args": ["-y", "@fffinstill/mcp-server"], "env": { "FINSTILL_API_KEY": "finstill_xxx_yyy" } } } }
- "Analyze AAPL" → callsgetCompanyMetrics,getReverseDCF,getBeneishScore, etc.
- "Screen for high-quality tech stocks" → uses thescreen-stocksprompt
- "Compare NVDA, AMD, and INTC" → callscompareTickers
- "What's the macro outlook?" → uses themacro-outlookprompt
- "Is MSFT likely to beat earnings?" → usesearnings-previewprompt
# 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 --help
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 declarereadOnlyHint: true,destructiveHint: false,idempotentHint: true,openWorldHint: true, and human-readabletitlefields
- Resource metadata: All resources includetitle,mimeType,description, and audience/priority annotations
- Capabilities: Explicitly declarestools,resources, andpromptswithlistChanged: false
- Server instructions: Provides server-level instructions for LLM context
Rate limits depend on your subscription tier:
Stocklake — Stock Data & Market Intelligence
Stock prices, technicals (RSI/MACD/Bollinger), AI sentiment, insider activity, earnings, sector intelligence, and market outlook for 1000+ stocks.
Access ROIC.AI financial data from AI tools, including company financials, ratios, prices, transcripts, and market research data.
Hosted MCP server for AI-enriched financial news — full-text and ticker-scoped news search, trending stories, and SEC Form 4 insider activity, each story scored 1–10 for relevance (OAuth 2.1, free tier 100 calls/hour).
Read-only MCP for U.S. household financial distress data: 96 indicators, the American Distress Index (ADI), and county-level distress scores for all 3,144 U.S. counties.
Read-only MCP for U.S. household financial distress data: 96 indicators, the American Distress Index (ADI), and county-level distress scores for all 3,144 U.S. counties.
Hosted MCP server for Chinese A-share and ETF market data, including prices, fundamentals, capital flows, financial statements, real-time quotes, and news.
Clean SEC EDGAR company financials, ratios, filings, and 10-K/10-Q sections as normalized JSON — a hosted MCP server with 5 tools and a free tier.
US stock market & financial data — SEC filings full-text search, XBRL fundamentals, 13F institutional holdings, insider & congressional trades, earnings-call transcripts, short interest, and FRED macro; 90+ tools, free tier, self-hostable.
Market intelligence your AI agent can call
SEC filings, earnings transcripts, guidance signals & macro calendar for S&P 500. 11 MCP tools for algo traders and financial analysts using Claude Code.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
