fintools-mcp

Herramientas de análisis financiero para asistentes de IA a través de MCP (Model Context Protocol).

Dale a Claude, ChatGPT, Cursor o cualquier IA compatible con MCP acceso a análisis financieros reales: no solo precios de acciones, sino el conjunto de herramientas analíticas que un operador realmente utiliza.

Herramientas

Herramienta	Qué hace
`get_technical_indicators`	RSI, MACD, ATR, EMAs (9/21/50/200), niveles de Fibonacci, evaluación de tendencias
`get_stock_quote`	Precio actual, volumen, rango de 52 semanas, capitalización de mercado
`get_trend_score`	Puntuación de tendencia de -100 (tendencia bajista fuerte) a +100 (tendencia alcista fuerte) con desglose de componentes
`get_support_resistance`	Niveles clave de soporte/resistencia con conteo de toques y calificaciones de fuerza
`screen_stocks`	Filtra el S&P 500 por RSI, puntuación de tendencia, posición de EMA, volumen relativo: encuentra configuraciones rápidamente
`analyze_options_chain`	Cadena de opciones con análisis de IV, filtrado de liquidez, ratios put/call
`calculate_position_size`	Dimensionamiento de posición basado en el riesgo con stop loss y objetivo de beneficio
`calculate_atr_position`	Dimensionamiento de posición basado en ATR: calcula automáticamente el stop y el objetivo a partir de la volatilidad
`analyze_trades`	Tasa de aciertos, factor de beneficio, ratio de Sharpe, drawdown, rachas a partir de P&L de operaciones
`compare_tickers`	Comparación técnica lado a lado entre múltiples símbolos

Cómo funciona

Diagrama de secuencia de fintools-mcp

Inicio rápido

Instalación

pip install fintools-mcp

O con uv:

uv pip install fintools-mcp

Añadir a Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "fintools": {
      "command": "uv",
      "args": ["run", "--from", "fintools-mcp", "fintools-mcp"]
    }
  }
}

O si se instaló mediante pip:

{
  "mcpServers": {
    "fintools": {
      "command": "fintools-mcp"
    }
  }
}

Añadir a Claude Code

claude mcp add fintools -- uv run --from fintools-mcp fintools-mcp

Ejemplos

Una vez configurado, puedes pedirle a tu asistente de IA cosas como:

"Encuentra acciones del S&P 500 sobrevendidas que sigan por encima de su EMA de 200"
"¿Cuál es la puntuación de tendencia de SPY?"
"Muéstrame los niveles de soporte y resistencia para NVDA"
"¿Cuál es la configuración técnica de AAPL en este momento?"
"Analiza la cadena de opciones de SPY para el próximo viernes"
"Si quiero ir en largo en NVDA con una cuenta de $100k arriesgando un 1.5%, ¿cuántas acciones y dónde está mi stop?"
"Compara AAPL, GOOGL, MSFT y AMZN: ¿cuál tiene la tendencia más fuerte?"
"Aquí están mis últimas 20 operaciones: [150, -80, 200, ...] — ¿cuál es mi tasa de aciertos y mi Sharpe?"

Ejemplo de salida

Indicadores técnicos

> "What's the technical setup on SPY?"

SPY @ $573.42
  RSI(14): 58.3 — bullish momentum
  MACD: 2.14 (histogram +0.38, bullish)
  ATR(14): $7.82
  EMAs: 9 > 21 > 50 > 200 (fully stacked bullish)
  Fibonacci: In golden pocket (0.618-0.65 retracement)
  Trend: Bullish (all signals aligned)

Dimensionamiento de posición

> "Size a long position on AAPL at $227, stop $220, target $245"

  Shares: 214
  Position value: $48,578
  Risk: $1,498 (1.5% of $100k)
  Reward: $3,852
  R:R ratio: 2.57

Arquitectura

fintools-mcp/
├── fintools_mcp/
│   ├── server.py              # MCP server — tool definitions
│   ├── data.py                # Market data via yfinance
│   ├── indicators/            # Technical indicators (standalone, no deps)
│   │   ├── rsi.py             # RSI — Wilder's smoothing
│   │   ├── macd.py            # MACD (12, 26, 9)
│   │   ├── atr.py             # ATR — Average True Range
│   │   ├── ema.py             # EMA — any period
│   │   ├── vwap.py            # VWAP — intraday, daily reset
│   │   └── fibonacci.py       # Fibonacci retracement + golden pocket
│   └── analysis/
│       ├── position_sizer.py  # Risk-based + ATR-based sizing
│       └── trade_stats.py     # KPI calculator (60+ metrics)
└── tests/

Fuentes de datos

Datos bursátiles: Yahoo Finance (gratis, no requiere clave API)
Datos de opciones: Cadenas de opciones de Yahoo Finance
No se necesitan claves API para la funcionalidad básica.

Desarrollo

git clone https://github.com/slimbiggins007/fintools-mcp.git
cd fintools-mcp
uv sync
uv run python -m fintools_mcp  # starts the MCP server

Ejecutar pruebas:

uv run pytest

Licencia

MIT

fintools-mcp

fintools-mcp

Herramientas

Cómo funciona

Inicio rápido

Instalación

Añadir a Claude Desktop

Añadir a Claude Code

Ejemplos

Ejemplo de salida

Indicadores técnicos

Dimensionamiento de posición

Arquitectura

Fuentes de datos

Desarrollo

Licencia

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API