massive-mcp

Un servidor MCP (Model Context Protocol) que expone la API REST de acciones de Massive.com a Claude Desktop y Claude Code.

Construido con FastMCP + httpx (asíncrono). Transporte Stdio.

Qué cubre

Los valores predeterminados están ajustados para mantener las respuestas pequeñas (limit bajo, truncamiento a 200 elementos con una _truncated_note). Todas las herramientas paginadas aceptan cursor y muestran next_cursor cuando hay más datos disponibles.

Instalación

# Recommended: uv
uv tool install --from . massive-mcp
# or pipx
pipx install .

Para desarrollo:

uv sync --extra dev
uv run pytest

Configuración

Establece tu clave de API a través de una variable de entorno. Se admiten ambos modos de autenticación: comienza con bearer; si Massive rechaza con 401, cambia a query.

export MASSIVE_API_KEY=sk_live_...
export MASSIVE_AUTH_MODE=bearer   # or "query"

O copia .env.example a .env.

Conexión

Claude Desktop

Edita claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "massive": {
      "command": "uvx",
      "args": ["massive-mcp"],
      "env": {
        "MASSIVE_API_KEY": "sk_live_...",
        "MASSIVE_AUTH_MODE": "bearer"
      }
    }
  }
}

Reinicia Claude Desktop.

Claude Code

claude mcp add massive --env MASSIVE_API_KEY=sk_live_... --env MASSIVE_AUTH_MODE=bearer -- uvx massive-mcp

Desarrollo local

uv run massive-mcp

Usa el Inspector MCP para probar las herramientas manualmente:

npx @modelcontextprotocol/inspector uvx massive-mcp

Pruébalo

Una vez conectado, pregúntale a Claude cosas como:

• "¿Cuál fue el cierre anterior de NVDA?"

• "Obtén los dividendos de AAPL de los últimos 12 meses."

• "Muéstrame las 10 acciones con mayores ganancias ahora mismo."

• "Obtén barras de 5 minutos para TSLA de ayer."

• "RSI para SPY en los últimos 30 días."

Habilidad complementaria

Este repositorio también incluye una habilidad de Claude: massive-trade-analysis, que utiliza las herramientas MCP para producir planes de trading profesional (swing / largo plazo) (entrada, SL, TP en cascada, R:R, dimensionamiento de posición). Consulta skills/ para obtener instrucciones de instalación.

Notas y limitaciones

• Solo REST. No hay soporte para WebSocket / FlatFiles.

• Solo clase de activos de acciones. Los endpoints de opciones/FX/cripto están fuera del alcance de la v1.

• Algunos endpoints (/vX/...) están versionados por Massive como beta: las rutas pueden cambiar.

• Las respuestas 429 se reintentan automáticamente respetando Retry-After. Las 5xx se reintentan con retroceso exponencial (máximo 3 intentos).

• La clave de API nunca se registra. Los errores eliminan apiKey de la URL mostrada.

Licencia

MIT