YFinance MCP — Instalar & Demo en vivo

Por qué usarlo

Características clave

Sin clave API, sin registro
Cotizaciones, OHLC histórico, fundamentos, balances
Cadenas de opciones, fechas de resultados, dividendos
Titulares de noticias por ticker
Implementación rápida en Python vía uvx

Demo en vivo

Cómo se ve en la práctica

yfinance-mcp.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "yfinance-mcp": {
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "yfinance-mcp": {
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "yfinance-mcp": {
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "yfinance-mcp": {
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "yfinance-mcp",
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "yfinance-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "yfinance-mcp"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add yfinance-mcp -- uvx yfinance-mcp

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: YFinance MCP

Instantánea rápida de tu lista de seguimiento — precios, P/E y noticias

👤 Inversores que hacen revisiones diarias ⏱ ~5 min beginner

Cuándo usarlo: Quieres un briefing de 10 tickers con un solo prompt antes de que abra el mercado.

Flujo

Precios

Use yfinance-mcp. For AAPL, MSFT, NVDA, TSLA, GOOGL, AMZN, META, BRK-B, JPM, V — current price, 1d %, 52w range.✓ Copiado

→ Tabla limpia con las 10 filas
Fundamentos

For the same list, P/E, forward P/E, EPS, and dividend yield.✓ Copiado

→ Fundamentos alineados con la tabla anterior
Noticias

For the 3 biggest movers today, pull the 3 most recent headlines each. Summarize the vibe.✓ Copiado

→ Noticias agrupadas por ticker con una línea de resumen

Resultado: Un briefing matutino de 10 líneas adaptado a tu lista de seguimiento.

Errores comunes

Límite de tasa si agrupas demasiados tickers a la vez — Divide en grupos de 10 por llamada, espera 1s entre ellas

Combinar con: memory

Hacer backtesting de una idea de estrategia simple sobre precios históricos

👤 Traders minoristas que prueban ideas ⏱ ~20 min intermediate

Cuándo usarlo: Tienes una idea como «comprar SPY cuando RSI < 30, vender en > 70» y quieres una comprobación histórica rápida.

Flujo

Obtener histórico

Pull 5y daily OHLC for SPY.✓ Copiado

→ Serie temporal devuelta como array
Calcular

Compute RSI(14). Run the "buy<30, sell>70" strategy. Report CAGR, max drawdown, trade count vs buy-and-hold.✓ Copiado

→ Métricas de la estrategia con comparación honesta con la línea base
Comprobación de realidad

Account for commissions ($1/trade) and slippage (5bps). Does the edge survive?✓ Copiado

→ Cifras netas de costes

Resultado: Una decisión de seguir o no probando la idea.

Errores comunes

Sesgo de supervivencia — yfinance solo tiene tickers líquidos — Para backtesting serio, usa un dataset dedicado; yfinance es para esbozar ideas

Combinar con: alpaca

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

yfinance-mcp + alpaca

yfinance para investigación, Alpaca para las órdenes reales

Pick 3 ideas via yfinance, place paper trades via Alpaca.✓ Copiado

yfinance-mcp + memory

Seguir tu propia tesis sobre tickers a lo largo del tiempo

Store the thesis on NVDA as of today, along with the price.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
get_quote	ticker: str	Instantánea del precio actual	free
get_history	ticker, period: str, interval: str	Datos históricos para gráficos o backtesting	free
get_fundamentals	ticker	Análisis de valoración y fundamentos	free
get_options	ticker, expiry?: date	Consulta de cadena de opciones	free
get_news	ticker, limit?: int	Titulares por ticker	free

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Límites no documentados de Yahoo — evita el abuso masivo
Tokens por llamada: OHLC de 5 años ≈ 50k tokens; mantén las solicitudes enfocadas
Monetario: Gratuito
Consejo: Remuestrea a semanal para historiales largos; extrae datos diarios solo cuando los necesites

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Ninguno

Salida de datos: query1.finance.yahoo.com

Yahoo ha roto yfinance antes con cambios en el HTML — mantén el paquete actualizado

Resolución de problemas

Errores comunes y soluciones

Devuelve vacío o error para un ticker

Usa el formato de símbolo de Yahoo (por ejemplo BRK-B, no BRK.B); algunas bolsas requieren sufijo (.T para Tokio)

JSONDecodeError

Yahoo te ha aplicado límite de tasa. Espera unos minutos o reduce los tickers por lote.

Paquete desactualizado

uvx --upgrade yfinance-mcp — Yahoo rompe cosas con regularidad

Alternativas

YFinance MCP vs otros

Alternativa	Cuándo usarla	Contrapartida
Alpaca MCP	Quieres datos reales de bróker y colocación de órdenes	Requiere cuenta en Alpaca
Polygon / Finnhub	Necesitas datos de nivel producción con baja latencia	De pago; sin MCP (por ahora)

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills