Polygon.io

[!IMPORTANT] :test_tube: Este proyecto es experimental y puede estar sujeto a cambios que rompan la compatibilidad.

Massive.com MCP Server

Un servidor de Model Context Protocol (MCP) que proporciona acceso a la API completa de datos financieros de Massive.com a través de una interfaz amigable para LLM.

En lugar de exponer una herramienta por endpoint, este servidor ofrece al LLM tres herramientas componibles — search, call y query — que cubren toda la superficie de la API de Massive.com. Los datos pueden almacenarse en una base de datos SQLite en memoria y enriquecerse con funciones financieras integradas.

Herramientas

Funciones integradas

Las funciones pueden aplicarse a resultados de API o salidas de consultas mediante el parámetro apply en call_api y query_data. Usa search_endpoints con scope="functions" para descubrirlas.

Cobertura de datos

El servidor indexa dinámicamente todos los endpoints de la API de Massive.com al iniciarse desde llms.txt, por lo que se mantiene automáticamente sincronizado con la API. La cobertura incluye:

• Agregados de acciones, opciones, forex, criptomonedas y futuros
• Operaciones y cotizaciones en tiempo real e históricas
• Instantáneas de mercado, ganadores/perdedores
• Detalles de tickers y datos de referencia
• Dividendos, splits, OPI
• Fundamentales financieros
• Calificaciones de analistas y noticias (Benzinga)
• Rendimientos del Tesoro, datos de inflación
• Estado del mercado y días festivos

Instalación

Requisitos previos

• Python 3.12+
• Una clave de API de Massive.com
  
• Astral UV (v0.4.0+)

Claude Code

Primero, instala Claude Code

npm install -g @anthropic-ai/claude-code

Instala el servidor MCP y luego regístralo con Claude Code:

# Install the server (one-time — downloads dependencies ahead of time)
uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.10.0"

# Register with Claude Code
claude mcp add massive -e MASSIVE_API_KEY=your_api_key_here -- mcp_massive

Para actualizar a una nueva versión más adelante:

uv tool upgrade mcp_massive

[!NOTE] ¿Actualizando desde uvx o uv run --with? Las versiones anteriores recomendaban uvx --from ... mcp_massive o uv run --with. Estos comandos descargan dependencias en cada inicio en frío, lo que puede hacer que el servidor supere el tiempo de espera de conexión de 30 segundos de Claude. Cambia a uv tool install como se muestra arriba: descarga las dependencias una vez y se inicia instantáneamente después.

Este comando instalará el servidor MCP en tu proyecto actual. Si quieres instalarlo globalmente, puedes ejecutar el comando con la bandera -s <scope>. Consulta claude mcp add --help para más opciones.

Para iniciar Claude Code, ejecuta claude en tu terminal.

• Si es tu primera vez usándolo, sigue las indicaciones de configuración para autenticarte

También puedes ejecutar claude mcp add-from-claude-desktop si el servidor MCP ya está instalado para Claude Desktop.

Claude Desktop

1. Sigue las instrucciones de instalación de MCP para Claude Desktop para completar la instalación inicial y encontrar tu archivo de configuración.
2. Instala el servidor:

uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.10.0"

3. Encuentra la ruta del binario instalado:

# Mac/Linux
which mcp_massive

# Windows
where mcp_massive

4. Añade el servidor a tu configuración de Claude Desktop. Reemplaza <path_to_mcp_massive> con la salida del paso anterior y completa los campos restantes.

{
    "mcpServers": {
        "massive": {
            "command": "<path_to_mcp_massive>",
            "env": {
                "MASSIVE_API_KEY": "<your_api_key_here>",
                "HOME": "<your_home_directory>"
            }
        }
    }
}

Configuración

Variables de entorno

Transporte

Por defecto, se utiliza el transporte STDIO. El transporte puede configurarse mediante el argumento CLI --transport o la variable de entorno MCP_TRANSPORT (el argumento CLI tiene prioridad).

# CLI argument
MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massive --transport streamable-http

# Environment variable
MCP_TRANSPORT=streamable-http MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massive

Ejemplos de uso

Una vez integrado, puedes pedirle a Claude que acceda a los datos de Massive.com:

Get the latest price for AAPL stock
Show me yesterday's trading volume for MSFT
What were the biggest stock market gainers today?
Get me the latest crypto market data for BTC-USD
Calculate the 20-day SMA for AAPL closing prices over the last 3 months
Compute Black-Scholes delta for these option contracts

Desarrollo

Ejecución local

Verifica que tengas instalados los requisitos previos.

# Sync dependencies
uv sync

# Run the server
MASSIVE_API_KEY=your_api_key_here uv run mcp_massive

uv tool install --force /path/to/mcp_massive

{
  "mcpServers": {
    "massive": {
      "command": "mcp_massive",
      "env": {
        "MASSIVE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Depuración

Para depuración y pruebas, recomendamos usar el MCP Inspector:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp_massive run mcp_massive

Esto abrirá una interfaz de navegador donde podrás interactuar directamente con tu servidor MCP y ver la entrada/salida de cada herramienta.

Selecciona el tipo de transporte STDIO en la interfaz del navegador con el comando uv y run mcp_massive como argumentos.

Linting de código

Este proyecto usa just para tareas comunes de desarrollo. Para hacer lint de tu código antes de enviar un PR:

just lint

Esto ejecutará ruff format y ruff check --fix para formatear automáticamente tu código y corregir problemas de linting.

Enlaces

• Massive.com Documentation
• Model Context Protocol
• MCP Python SDK

Política de privacidad

Este servidor MCP interactúa con la API de Massive.com para obtener datos de mercado. Todas las solicitudes de datos están sujetas a la política de privacidad y los términos de servicio de Massive.com.

• Política de privacidad de Massive.com: https://massive.com/legal/privacy
• Manejo de datos: Este servidor no almacena ni guarda en caché ningún dato de usuario. Todas las solicitudes se envían directamente a la API de Massive.com.
• Clave de API: Tu clave de API de Massive.com se usa únicamente para autenticar solicitudes a su API.
• User-Agent: Las solicitudes de API incluyen una cadena User-Agent que contiene la versión del servidor MCP (p. ej., MCP-Massive/0.x.y). No se incluye información personal identificable.

Contribuciones

Si encontraste un error o tienes una idea para una nueva función, primero coméntalo con nosotros enviando un nuevo issue. Responderemos a los issues en un máximo de 3 semanas. También estamos abiertos a voluntarios si quieres enviar un PR para cualquier issue abierto, pero por favor coméntalo con nosotros de antemano. Los PR que no estén vinculados a un issue existente o que no se hayan discutido con nosotros con antelación generalmente serán rechazados.