fffinstill MCP Server

Análise de investimentos para mais de 2.260 ações dos EUA — 43 ferramentas para triagem de ações, previsões de lucros por ML, negociações de insiders/congressistas, sinais macroeconômicos, Fear & Greed e dados alternativos.

GitHubExperimente este MCPPatrocinado

Documentação

@fffinstill/mcp-server

Servidor MCP para fffinstill — análise de investimentos para mais de 2.260 ações dos EUA.

Conecte Claude Desktop, Cursor, VS Code ou qualquer assistente de IA compatível com MCP às ferramentas de análise de ações, triagem, dados macro, previsões de lucros por ML e dados alternativos da fffinstill.

Recursos

69 ferramentas — Análise de ações, triagem, análise de portfólio, indicadores macro, previsões de ML, negociações de insiders/congressistas, dados alternativos, métricas de risco, 18 modelos de fatores acadêmicos e 13 ferramentas exclusivas do plano Business
7 recursos — Sinal de mercado, regime macro, Fear & Greed, visão geral do setor, resumos de empresas
15 prompts — Fluxos de trabalho pré-construídos para análise de ações, comparação, triagem, perspectivas macro, saúde do portfólio, dados alternativos, painel de mercado, deep value, avaliação de risco, momentum de crescimento, análise de renda, modelos de fatores, inteligência de insiders

Início Rápido

1. Obtenha uma Chave de API

Cadastre-se em fffinstill.com e gere uma chave de API em Configurações → API.

Requer uma assinatura Founding, Pro ou Business.

2. Configure Seu Cliente de IA

Claude Desktop

Adicione em ~/.config/claude/claude_desktop_config.json (Linux/macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "fffinstill": {
      "command": "npx",
      "args": ["-y", "@fffinstill/mcp-server"],
      "env": {
        "FINSTILL_API_KEY": "finstill_xxx_yyy"
      }
    }
  }
}

Cursor

Adicione em .cursor/mcp.json na raiz do seu projeto:

{
  "mcpServers": {
    "fffinstill": {
      "command": "npx",
      "args": ["-y", "@fffinstill/mcp-server"],
      "env": {
        "FINSTILL_API_KEY": "finstill_xxx_yyy"
      }
    }
  }
}

VS Code

Adicione em .vscode/mcp.json na raiz do seu projeto:

{
  "servers": {
    "fffinstill": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@fffinstill/mcp-server"],
      "env": {
        "FINSTILL_API_KEY": "finstill_xxx_yyy"
      }
    }
  }
}

3. Use

Após a configuração, seu assistente de IA pode:

"Analise AAPL" → chama getCompanyMetrics, getReverseDCF, getBeneishScore, etc.
"Faça triagem de ações de tecnologia de alta qualidade" → usa o prompt screen-stocks
"Compare NVDA, AMD e INTC" → chama compareTickers
"Qual é a perspectiva macro?" → usa o prompt macro-outlook
"É provável que a MSFT supere as estimativas de lucros?" → usa o prompt earnings-preview

Uso via CLI

# 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

Referência de Ferramentas

Análise de Ações (16 ferramentas)

Ferramenta	Descrição
`getCompanyMetrics(ticker)`	Fundamentos completos: receita, margens, avaliações, pontuações de qualidade
`getAnalystRatings(ticker)`	Consenso, preços-alvo, detalhamento de classificações
`getPriceHistory(ticker, weeks?)`	Preços semanais com retornos (padrão: 52 semanas)
`getQuarterlyFinancials(ticker)`	8 trimestres: receita, margens, ROIC, D/E
`getScoreHistory(ticker)`	Pontuação de qualidade composta (7 componentes) ao longo de 12 períodos
`getReverseDCF(ticker)`	Cenários de valor justo bear/base/bull
`getBeneishScore(ticker)`	Detecção de manipulação de lucros M-Score
`getZScoreHistory(ticker)`	Histórico de risco de falência Altman Z-Score
`getConvictionHistory(ticker)`	Pontuações de trajetória de convicção de insiders (padrões de compra)
`getMacroSensitivity(ticker)`	Sensibilidade a taxas, inflação, VIX, USD
`getEarningsPrediction(ticker)`	Previsão de superação/queda de lucros por ML
`getEstimateRevisions(ticker)`	Tendências de revisão de EPS por analistas
`getCorrelatedStocks(ticker)`	Análise de correlação de preços com pares do setor
`getInstitutionalOwnership(ticker)`	Principais detentores, atividade de baleias, risco de concentração
`getGeographicRevenue(ticker)`	Receita por região geográfica
`getSegmentRevenue(ticker)`	Detalhamento de receita por segmento de negócio

Triagem e Portfólio (7 ferramentas)

Ferramenta	Descrição
`screenStocks(...)`	Triagem multifatorial de mais de 2.260 ações
`deepValueScreen(sector?, limit?)`	Ações de valor com Piotroski ≥ 6
`compareTickers(tickers)`	2 a 5 ações lado a lado
`computeMetric(metric, aggregation)`	Estatísticas agregadas das 100 principais ações
`getPortfolioAnalysis(tickers)`	Análise de portfólio com múltiplas participações
`crossReferencePortfolio(tickers)`	Alinhamento do portfólio com o sinal de mercado
`getStrategyPicks(strategy?)`	Seleções de estratégia pré-computadas

Mercado e Macro (13 ferramentas)

Ferramenta	Descrição
`getMarketSignal()`	Sinal atual com detalhamento de 5 componentes
`getRegimeAnalysis()`	Classificação de regime macro
`getMacroIndicator(indicator)`	Dados FRED (CPI, PIB, taxas, etc.)
`getFearGreedIndex(timeline?)`	Fear & Greed com histórico opcional
`getSectorBreakdown(sector?)`	Principais ações por capitalização de mercado para um setor
`getBLSIndicator(series_id)`	Dados econômicos BLS (emprego, CPI, PPI)
`getMacroAttention(weeks?)`	Volume de pesquisa do Google para termos de estresse macro
`getRegimeTransitions(days?)`	Transições históricas de regime
`getSignalHistory(days?)`	Histórico diário de sinal + retornos SPY
`getMarketBreadth(period_type?)`	Avanços/recuos, novas máximas/mínimas
`getEarningsCalendar(from?, to?)`	Calendário de próximos relatórios de lucros
`searchStocks(query)`	Busca difusa de mais de 2.260 ações dos EUA
`getMarketHeatmap()`	Mapa de calor de desempenho do setor com maiores altas/baixas

Dados Alternativos (9 ferramentas)

Ferramenta	Descrição
`getInsiderActivity(ticker)`	Negociações de insiders do Formulário 4 da SEC
`getCongressionalTrades(...)`	Negociações da Lei STOCK
`getEarningsSurprises(ticker)`	Superações/erros históricos
`getAccelerationMatrix(...)`	Aceleração de receita e lucros
`getLargeShareholderFilings(ticker)`	Arquivos 13D/13G de ativismo e participação acionária
`getLaborEfficiency(ticker)`	Receita/funcionário, SGA/funcionário, número de funcionários
`getETFExposure(ticker)`	Consulta reversa de ETF com pesos
`getClinicalTrials(ticker?, phase?)`	Pipeline de ensaios de biotecnologia/farmacêutica
`getLobbyingActivity(ticker?, sector?)`	Gastos e temas de lobby federal

Análise Avançada (11 ferramentas — Nível 2)

Ferramenta	Descrição
`getNextEarnings(ticker)`	Próxima data de lucros e detalhes do relatório
`getPeerComparison(ticker)`	Análise de grupo de pares com classificações relativas
`getValuationHistory(ticker)`	Séries temporais históricas de P/L, P/V, EV/EBITDA
`getRiskMetrics(ticker)`	Beta, rebaixamento máximo, Sharpe, Sortino, VaR
`getAnnualTrends(ticker)`	Trajetória plurianual de receita, lucro e margens
`getKPIs(ticker)`	KPIs específicos do setor e métricas operacionais
`getAttentionSignals(ticker)`	Anomalias de Wikipedia + Google Trends
`getAcademicFactors(ticker)`	Renda residual, qualidade dos accruals, Fama-French
`getForesightScore(ticker)`	Pontuação composta de previsão/trajetória por ML
`getInsiderSignals(ticker)`	Padrões e clusters derivados de convicção de insiders
`getAIVerdict(ticker)`	Veredito de compra/manutenção/venda do analista de IA com tese

Exclusivo Business (13 ferramentas — Nível 3)

Ferramenta	Descrição
`getGovtContracts(ticker?, agency?)`	Contratos governamentais concedidos (por empresa ou triados)
`getVolatilityProfile(ticker)`	Análise de volatilidade: métricas de risco, vs benchmark SPY
`getRedditMentions(ticker?)`	Sentimento e tendências de menções no Reddit
`getMergerDeals(status?, ticker?)`	Negócios ativos de M&A com spreads
`getBatchEarningsPredictions(tickers)`	Previsões de ML para múltiplos tickers
`getETFBreakdown(ticker)`	Participações de ETF, detalhamento por setor
`getIPOCalendar(range?)`	Próximos IPOs com detalhes de precificação
`getAttentionAlerts(days?)`	Picos incomuns de atenção em todo o universo
`getMacroSentiment()`	Sentimento completo: AAII, VIX, put/call, ISM
`getGovtContractSummary(ticker)`	Exposição contratual agregada: totais de 12 meses, principais agências
`getBatchRiskMetrics(tickers)`	Métricas de risco para múltiplos tickers
`getFactorModelScores(model)`	18 modelos de fatores acadêmicos com pontuações
`getMarketStreaks(sector?)`	Ações em sequências de melhoria de qualidade

Recursos

URI do recurso	Descrição	Cache
`finstill://market/signal`	Sinal atual de mercado	5 min
`finstill://market/regime`	Regime macro	1 hora
`finstill://market/fear-greed`	Índice Fear & Greed	1 hora
`finstill://sectors/overview`	Agregados do setor	1 hora
`finstill://company/{ticker}`	Resumo da empresa	24 horas
`finstill://meta/tools`	Documentação de ferramentas	Estático
`finstill://meta/coverage`	Tickers cobertos	24 horas

Prompts

Prompt	Argumentos	Descrição
`analyze-stock`	`{ticker}`	Análise completa de ações (15 ferramentas)
`compare-stocks`	`{tickers}`	Comparação lado a lado
`screen-stocks`	`{criteria}`	Critérios em linguagem natural → triagem de ações
`macro-outlook`	—	Resumo do ambiente macro (10 ferramentas)
`sector-rotation`	—	Análise de rotação de setores
`earnings-preview`	`{ticker}`	Análise pré-lucros (10 ferramentas)
`portfolio-health-check`	`{tickers}`	Saúde do portfólio: qualidade, risco, concentração
`alternative-data-scan`	`{ticker}`	Mergulho profundo em dados não tradicionais
`market-dashboard`	—	Visão geral abrangente do mercado (13 ferramentas)
`deep-value-hunt`	`{sector?}`	Descoberta de ações deep value

Uso Programático

import { createServer, connectStdio } from '@fffinstill/mcp-server';

const server = createServer({
  apiUrl: 'https://fffinstill.com',
  apiKey: process.env.FINSTILL_API_KEY!,
});

await connectStdio(server);

Conformidade com MCP

Este servidor implementa a especificação completa do MCP:

Anotações de ferramentas: Todas as 69 ferramentas declaram os campos readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true e title legíveis por humanos
Metadados de recursos: Todos os recursos incluem title, mimeType, description e anotações de público/prioridade
Capacidades: Declara explicitamente tools, resources e prompts com listChanged: false
Instruções do servidor: Fornece instruções em nível de servidor para o contexto do LLM

Limites de Taxa

Os limites de taxa dependem do seu nível de assinatura:

Plano	Solicitações/min	Limite mensal
Founding	20	1.000
Pro	20	1.000
Business	60	Ilimitado

Licença

MIT