🧠 FinSage MCP

🌐 Website

FinSage es un servidor MCP (Model Context Protocol) que conecta agentes de IA como Claude con el API de Finnhub.io(se agregaran otras en el futuro) para obtener datos del mercado en tiempo real. Pregunta sobre cualquier acción, analiza tendencias, y toma decisiones financieras informadas — todo desde tu chat.

Y esto es solo el comienzo, seguimos agregando más herramientas.

🎯 ¿Qué puedes hacer con FinSage?

• Cotizaciones en Tiempo Real - Obtén el precio actual de cualquier acción de EE.UU. con cambio porcentual, máximos y mínimos del día.

• Noticias del Mercado - Accede a las últimas noticias financieras filtradas por categoría: general, forex, crypto o fusiones.

• Análisis de Earnings - Revisa el historial de reportes de ganancias y descubre si una empresa superó o falló las expectativas.

• Métricas Financieras - Consulta ratios clave como P/E, márgenes de ganancia, 52-week high/low y más indicadores.

• Calendario de Reportes - Sabe exactamente cuándo cada empresa publicará sus resultados trimestrales.

• Visualizaciones Interactivas - Genera gráficos dinámicos directamente en el chat para visualizar datos y comparar métricas.

Related MCP server: Stock Market MCP Server

🛠️ Herramientas Disponibles

FinSage actualmente cuenta con 7 herramientas:

🚀 Instalación

1. Obtén tu API Key (Gratis)

1. Ve a Finnhub.io

2. Crea una cuenta gratuita

3. Copia tu API Key desde el dashboard

💡 El plan gratuito es suficiente para uso personal.

2. Configura el proyecto

git clone https://github.com/robbintech2019/FINSAGE_MCP.git
cd FINSAGE_MCP
pip install -r requirements.txt

3. Configura tu API Key

Renombra .env.example a .env y agrega tu API Key:

FINNHUB_API_KEY=tu_api_key_aqui

4. Conecta con tu asistente de IA

Agrega esta configuración en tu archivo MCP:

{
  "mcpServers": {
    "finsage": {
      "command": "python",
      "args": ["/ruta/a/server.py"]
    }
  }
}

📁 Estructura del Proyecto

finsage-mcp/
├── server.py          # Servidor MCP con todas las herramientas
├── templates/         # Templates HTML para visualizaciones
├── requirements.txt   # Dependencias
├── .env               # Tu API Key (no se sube a git)
└── website/           # Landing page del proyecto

📋 Próximas Funcionalidades

• Búsqueda en bulk - Consultar múltiples símbolos a la vez

• Análisis de sentimiento de noticias financieras

• Top Movers - Acciones con mayor movimiento del día

🤝 Contribuciones

¿Tienes ideas para nuevas herramientas? ¡Las contribuciones son bienvenidas!

📄 Licencia

MIT License

Hecho con 💚 para inversionistas y programadores