yfinance-mcp

Datos de mercado en vivo para tu IA. Un servidor Model Context Protocol que ofrece a Claude (o cualquier cliente MCP) cotizaciones en tiempo real, historial OHLCV, cadenas de opciones completas, noticias y comparación de múltiples tickers. Gratis, sin clave de API.

Por qué

Los LLM responden a preguntas de mercado con suposiciones basadas en datos de entrenamiento. Conecta este servidor una vez y dejan de adivinar:

• "¿A cuánto cotiza Apple?" → cotización en vivo en lugar de una alucinación obsoleta

• "Saca las opciones de AAPL que vencen el próximo mes" → strikes reales con IV y open interest

• "¿NVDA vs AMD vs INTC este año?" → rendimientos reales, volatilidad, drawdowns, calculados a partir de los datos

• "¿Hay noticias recientes sobre PLTR?" → titulares con enlaces que puede citar

Related MCP server: YFinance MCP Server

Herramientas

Las respuestas son JSON, truncadas a tamaños amigables para LLM (opciones limitadas a 60 filas por lado), con estadísticas resumidas para que el modelo razone sobre agregados antes que sobre barras crudas.

Configuración

git clone https://github.com/saksham10arora-dotcom/yfinance-mcp
cd yfinance-mcp
python3 -m venv .venv && .venv/bin/pip install fastmcp yfinance

Claude Desktop / cualquier cliente MCP

Añade a claude_desktop_config.json (Archivo → Configuración → Desarrollador → Editar configuración):

{
  "mcpServers": {
    "yfinance": {
      "command": "/absolute/path/to/yfinance-mcp/.venv/bin/python",
      "args": ["/absolute/path/to/yfinance-mcp/server.py"]
    }
  }
}

Reinicia Claude Desktop. Las herramientas aparecen bajo el icono 🔨. Pregunta sobre cualquier ticker.

Verificar sin un cliente MCP

./.venv/bin/python -c "import server; print(server.get_quote('AAPL'))"

CI ejecuta el mismo handshake stdio que GitHub en cada push, así que main siempre es correcto a nivel de protocolo.

FAQ

¿Los datos son en tiempo real? Datos de Yahoo Finance: casi en tiempo real para acciones de EE. UU., con retraso para algunas bolsas internacionales. Bueno para investigación y chat, no para ejecución de órdenes.

¿Cuesta algo? No. Sin clave de API, sin cuenta de límite de tasa, nada que configurar.

¿Por qué no simplemente pegar código yfinance en el chat? Puedes. Esto elimina el bucle de copiar y pegar y permite que el modelo decida qué herramienta llamar según la pregunta, incluidas las de varios pasos ("compara estos cinco tickers, luego saca la cadena del más volátil").

¿Windows? Funciona. Apunta la configuración a .venv\Scripts\python.exe y usa dobles barras invertidas en JSON.

Solución de problemas

• Icono de herramienta ausente tras reiniciar: las rutas en la configuración deben ser absolutas; las rutas relativas fallan silenciosamente.

• no data for <ticker>: símbolo dado de baja o mal escrito; compruébalo en Yahoo Finance en un navegador.

• Limitación de tasa tras uso intensivo: espera unos minutos; Yahoo limita los picos.

Alternativas comparadas

Licencia

MIT. No es asesoramiento de inversión; la IA que lee tu cartera no es un fiduciario.