fffinstill MCP Server

Análisis de inversiones para más de 2,260 acciones estadounidenses — 43 herramientas para selección de acciones, predicciones de ganancias con ML, operaciones de personas con información privilegiada y del Congreso, señales macroeconómicas, Fear & Greed y datos alternativos.

GitHubPrueba este MCPPatrocinado

Documentación

@fffinstill/mcp-server

Servidor MCP para fffinstill — análisis de inversiones para más de 2,260 acciones estadounidenses.

Conecta Claude Desktop, Cursor, VS Code o cualquier asistente de IA compatible con MCP a las herramientas de análisis de acciones, selección, datos macro, predicciones de ganancias por ML y datos alternativos de fffinstill.

Características

69 herramientas — Análisis de acciones, selección, analítica de carteras, indicadores macro, predicciones de ML, operaciones de insiders/congresistas, datos alternativos, métricas de riesgo, 18 modelos factoriales académicos y 13 herramientas exclusivas de Business
7 recursos — Señal de mercado, régimen macro, Fear & Greed, resumen sectorial, resúmenes de empresas
15 prompts — Flujos de trabajo preconstruidos para análisis de acciones, comparación, selección, perspectivas macro, salud de cartera, datos alternativos, panel de mercado, valor profundo, evaluación de riesgos, impulso de crecimiento, análisis de ingresos, modelos factoriales, inteligencia de insiders

Inicio Rápido

1. Obtén una Clave de API

Regístrate en fffinstill.com y genera una clave de API en Configuración → API.

Requiere una suscripción Founding, Pro o Business.

2. Configura tu Cliente de IA

Claude Desktop

Añade a ~/.config/claude/claude_desktop_config.json (Linux/macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Cursor

Añade a .cursor/mcp.json en la raíz de tu proyecto:

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

VS Code

Añade a .vscode/mcp.json en la raíz de tu proyecto:

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

3. Úsalo

Una vez configurado, tu asistente de IA puede:

"Analiza AAPL" → llama a getCompanyMetrics, getReverseDCF, getBeneishScore, etc.
"Selecciona acciones tecnológicas de alta calidad" → usa el prompt screen-stocks
"Compara NVDA, AMD e INTC" → llama a compareTickers
"¿Cuál es la perspectiva macro?" → usa el prompt macro-outlook
"¿Es probable que MSFT supere las ganancias?" → usa el prompt earnings-preview

Uso desde 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

Referencia de Herramientas

Análisis de Acciones (16 herramientas)

Herramienta	Descripción
`getCompanyMetrics(ticker)`	Fundamentos completos: ingresos, márgenes, valoraciones, puntuaciones de calidad
`getAnalystRatings(ticker)`	Consenso, precios objetivo, desglose de calificaciones
`getPriceHistory(ticker, weeks?)`	Precios semanales con rendimientos (por defecto: 52 semanas)
`getQuarterlyFinancials(ticker)`	8 trimestres: ingresos, márgenes, ROIC, D/E
`getScoreHistory(ticker)`	Puntuación compuesta de calidad (7 componentes) durante 12 períodos
`getReverseDCF(ticker)`	Escenarios de valor razonable bajista/base/alcista
`getBeneishScore(ticker)`	Detección de manipulación de ganancias M-Score
`getZScoreHistory(ticker)`	Historial de riesgo de quiebra Altman Z-Score
`getConvictionHistory(ticker)`	Puntuaciones de trayectoria de convicción de insiders (patrones de compra)
`getMacroSensitivity(ticker)`	Sensibilidad a tasas, inflación, VIX, USD
`getEarningsPrediction(ticker)`	Predicción de superación/fallo de ganancias por ML
`getEstimateRevisions(ticker)`	Tendencias de revisiones de EPS de analistas
`getCorrelatedStocks(ticker)`	Análisis de correlación de precios con pares del sector
`getInstitutionalOwnership(ticker)`	Principales tenedores, actividad de ballenas, riesgo de concentración
`getGeographicRevenue(ticker)`	Ingresos por región geográfica
`getSegmentRevenue(ticker)`	Desglose de ingresos por segmento de negocio

Selección y Cartera (7 herramientas)

Herramienta	Descripción
`screenStocks(...)`	Selección multifactorial de más de 2,260 acciones
`deepValueScreen(sector?, limit?)`	Acciones de valor con Piotroski ≥ 6
`compareTickers(tickers)`	2-5 acciones lado a lado
`computeMetric(metric, aggregation)`	Estadísticas agregadas entre las 100 principales acciones
`getPortfolioAnalysis(tickers)`	Analítica de carteras multi-holding
`crossReferencePortfolio(tickers)`	Alineación de cartera con señal de mercado
`getStrategyPicks(strategy?)`	Selecciones de estrategia precalculadas

Mercado y Macro (13 herramientas)

Herramienta	Descripción
`getMarketSignal()`	Señal actual con desglose de 5 componentes
`getRegimeAnalysis()`	Clasificación de régimen macro
`getMacroIndicator(indicator)`	Datos FRED (IPC, PIB, tasas, etc.)
`getFearGreedIndex(timeline?)`	Fear & Greed con historial opcional
`getSectorBreakdown(sector?)`	Principales acciones por capitalización de mercado para un sector
`getBLSIndicator(series_id)`	Datos económicos BLS (empleo, IPC, IPP)
`getMacroAttention(weeks?)`	Volumen de búsqueda macro en Google para términos de estrés
`getRegimeTransitions(days?)`	Transiciones históricas de regímenes
`getSignalHistory(days?)`	Historial diario de señales + rendimientos de SPY
`getMarketBreadth(period_type?)`	Avances/retrocesos, nuevos máximos/mínimos
`getEarningsCalendar(from?, to?)`	Calendario de próximos informes de ganancias
`searchStocks(query)`	Búsqueda difusa de más de 2,260 acciones estadounidenses
`getMarketHeatmap()`	Mapa de calor de rendimiento sectorial con principales ganadores/perdedores

Datos Alternativos (9 herramientas)

Herramienta	Descripción
`getInsiderActivity(ticker)`	Operaciones de insiders del Formulario 4 de la SEC
`getCongressionalTrades(...)`	Operaciones bajo la Ley STOCK
`getEarningsSurprises(ticker)`	Superaciones/fallos históricos
`getAccelerationMatrix(...)`	Aceleración de ingresos y ganancias
`getLargeShareholderFilings(ticker)`	Presentaciones 13D/13G de activismo y propiedad
`getLaborEfficiency(ticker)`	Ingresos/empleado, SGA/empleado, plantilla
`getETFExposure(ticker)`	Búsqueda inversa de ETF con ponderaciones
`getClinicalTrials(ticker?, phase?)`	Pipeline de ensayos de biotecnología/farmacéutica
`getLobbyingActivity(ticker?, sector?)`	Gasto e incidencias de lobby federal

Análisis Avanzado (11 herramientas — Nivel 2)

Herramienta	Descripción
`getNextEarnings(ticker)`	Próxima fecha de ganancias y detalles del informe
`getPeerComparison(ticker)`	Análisis de grupo de pares con clasificaciones relativas
`getValuationHistory(ticker)`	Series temporales históricas de P/E, P/S, EV/EBITDA
`getRiskMetrics(ticker)`	Beta, drawdown máximo, Sharpe, Sortino, VaR
`getAnnualTrends(ticker)`	Trayectoria multianual de ingresos, beneficios y márgenes
`getKPIs(ticker)`	KPIs específicos de la industria y métricas operativas
`getAttentionSignals(ticker)`	Anomalías de Wikipedia + Google Trends
`getAcademicFactors(ticker)`	Ingreso residual, calidad de devengos, Fama-French
`getForesightScore(ticker)`	Puntuación compuesta de previsión/trayectoria por ML
`getInsiderSignals(ticker)`	Patrones y clústeres derivados de convicción de insiders
`getAIVerdict(ticker)`	Veredicto de compra/mantenimiento/venta del analista de IA con tesis

Exclusivas de Business (13 herramientas — Nivel 3)

Herramienta	Descripción
`getGovtContracts(ticker?, agency?)`	Adjudicaciones de contratos gubernamentales (por empresa o seleccionadas)
`getVolatilityProfile(ticker)`	Análisis de volatilidad: métricas de riesgo, vs. benchmark SPY
`getRedditMentions(ticker?)`	Sentimiento y tendencias de menciones en Reddit
`getMergerDeals(status?, ticker?)`	Acuerdos activos de M&A con diferenciales
`getBatchEarningsPredictions(tickers)`	Predicciones de ML para múltiples tickers
`getETFBreakdown(ticker)`	Tenencias de ETF, desglose sectorial
`getIPOCalendar(range?)`	Próximas OPVs con detalles de precios
`getAttentionAlerts(days?)`	Picos inusuales de atención en todo el universo
`getMacroSentiment()`	Sentimiento completo: AAII, VIX, put/call, ISM
`getGovtContractSummary(ticker)`	Exposición agregada a contratos: totales a 12 meses, principales agencias
`getBatchRiskMetrics(tickers)`	Métricas de riesgo para múltiples tickers
`getFactorModelScores(model)`	18 modelos factoriales académicos con puntuaciones
`getMarketStreaks(sector?)`	Acciones con rachas de mejora de calidad

Recursos

URI del Recurso	Descripción	Caché
`finstill://market/signal`	Señal de mercado actual	5 min
`finstill://market/regime`	Régimen macro	1 hora
`finstill://market/fear-greed`	Índice Fear & Greed	1 hora
`finstill://sectors/overview`	Agregados sectoriales	1 hora
`finstill://company/{ticker}`	Resumen de empresa	24 horas
`finstill://meta/tools`	Documentación de herramientas	Estático
`finstill://meta/coverage`	Tickers cubiertos	24 horas

Prompts

Prompt	Args	Descripción
`analyze-stock`	`{ticker}`	Análisis completo de acciones (15 herramientas)
`compare-stocks`	`{tickers}`	Comparación lado a lado
`screen-stocks`	`{criteria}`	Criterios en lenguaje natural → selección de acciones
`macro-outlook`	—	Resumen del entorno macro (10 herramientas)
`sector-rotation`	—	Análisis de rotación sectorial
`earnings-preview`	`{ticker}`	Análisis pre-ganancias (10 herramientas)
`portfolio-health-check`	`{tickers}`	Salud de cartera: calidad, riesgo, concentración
`alternative-data-scan`	`{ticker}`	Inmersión profunda en datos no tradicionales
`market-dashboard`	—	Resumen integral del mercado (13 herramientas)
`deep-value-hunt`	`{sector?}`	Descubrimiento de acciones de valor profundo

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);

Cumplimiento de MCP

Este servidor implementa la especificación completa de MCP:

Anotaciones de herramientas: Las 69 herramientas declaran readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true y campos legibles por humanos title
Metadatos de recursos: Todos los recursos incluyen title, mimeType, description y anotaciones de audiencia/prioridad
Capacidades: Declara explícitamente tools, resources y prompts con listChanged: false
Instrucciones del servidor: Proporciona instrucciones a nivel de servidor para el contexto del LLM

Límites de Tasa

Los límites de tasa dependen de tu nivel de suscripción:

Plan	Solicitudes/min	Tope mensual
Founding	20	1,000
Pro	20	1,000
Business	60	Ilimitado

Licencia

MIT