Inicio rápido

Claude Desktop

Añadir a ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "equivault": {
      "command": "npx",
      "args": ["-y", "equivault-mcp"],
      "env": {
        "EQUIVAULT_API_KEY": "your-api-key",
        "EQUIVAULT_TENANT_ID": "your-tenant-id"
      }
    }
  }
}

Claude Code

claude mcp add equivault -- npx -y equivault-mcp

Luego, configura tus credenciales:

export EQUIVAULT_API_KEY=your-api-key
export EQUIVAULT_TENANT_ID=your-tenant-id

Configuración

Variable	Requerido	Predeterminado	Descripción
`EQUIVAULT_API_KEY`	Sí	—	Tu clave de API de EquiVault
`EQUIVAULT_TENANT_ID`	Sí	—	Tu ID de inquilino de EquiVault
`EQUIVAULT_BASE_URL`	No	`https://api.equivault.ai/api/v1`	URL base de la API (sobrescribir para autoalojamiento)

Herramientas

Investigación principal (M1)

Herramienta	Descripción
`search_companies`	Buscar empresas por nombre, ticker o palabra clave
`get_company`	Obtener perfil detallado de la empresa
`get_financials`	Estados financieros (resultados, balance, flujo de caja)
`get_metrics`	Series temporales de ratios financieros y métricas
`get_stock_quote`	Precio actual de la acción, variación y volumen
`screen_companies`	Filtrar empresas por criterios financieros
`compare_companies`	Comparación lado a lado entre pares
`get_billing_status`	Comprobar nivel de suscripción y uso de la API

Datos profundos de la empresa (M2)

Herramienta	Descripción	Nivel
`get_company_narrative`	Tesis de inversión, impulsores, vientos en contra, vientos a favor	Starter+
`get_guidance`	Rastreador de previsiones de gestión con resultados de superación/incumplimiento	Professional+
`get_segments`	Ingresos e ingresos operativos por segmento de negocio	Professional+
`get_capital_allocation`	Historial de recompras, dividendos, deuda, fusiones y adquisiciones, capex	Professional+
`get_risk_factors`	Evolución de los factores de riesgo a partir de los archivos presentados	Professional+
`get_insider_transactions`	Compras y ventas de información privilegiada, indicador 10b5-1	Advisor+
`get_earnings_quality`	Devengos, conversión de efectivo, indicadores no GAAP	Professional+
`get_debt_maturities`	Calendario de vencimiento de la deuda	Professional+
`get_competitive_signals`	Cuota de mercado, nuevos competidores, señales de precios	Professional+
`get_management_statements`	Declaraciones notables de la dirección con sentimiento	Advisor+
`get_accounting_snapshots`	Políticas contables y cambios entre periodos	Professional+
`get_strategy_profiles`	Perfiles de estrategia de inversión disponibles	Todos

Compuesto (M2)

Herramienta	Descripción
`analyze_company`	Un solo paso: perfil + estados financieros + métricas + narrativa
`company_deep_dive`	Todo lo de `analyze_company` + las 10 secciones del perfil

Señales y alertas (M3)

Herramienta	Descripción	Nivel
`get_signals`	Señales paginadas para una sola empresa	Analyst+
`get_signal_summary`	Desglose de recuentos por tipo/gravedad + recuento de no leídos	Analyst+
`get_signal_dashboard`	Visión general de señales de toda la cartera	Analyst+
`get_signal_trends`	Actividad segmentada por tiempo en toda la cartera	Analyst+
`get_trending_signals`	Señales de tendencia entre empresas en este momento	Analyst+
`create_alert`	Crear una regla de alerta	Advisor+
`update_alert`	Actualizar una regla de alerta	Advisor+
`delete_alert`	Eliminar una regla de alerta	Advisor+

Informes, cartera y medios (M3)

Herramienta	Descripción	Nivel
`list_briefs`	Listar informes de inversión (filtrar por empresa o seguidos)	Starter+
`get_brief`	Contenido completo del informe con cuadro de mando	Starter+
`get_portfolio_analytics`	Rentabilidad, Sharpe, asignación sectorial, ganadores/perdedores	Analyst+
`list_media`	Llamadas de resultados, podcasts, presentaciones, comunicados de prensa	Starter+
`get_guru_holdings`	Participaciones y cambios en la cartera de inversores destacados	Analyst+
`get_markets`	Mercados disponibles (código, país, moneda, MIC)	Todos

Compuesto avanzado (M3)

Herramienta	Descripción
`morning_briefing`	Panel de señales + tendencias + informes + cartera opcional — en una sola llamada
`research_report`	`company_deep_dive` + señales recientes + informes relacionados, listo para renderizar

Ejemplos

Investigar una empresa:

"¿Cuáles son los últimos estados financieros anuales y las métricas clave de Apple?"

Buscar oportunidades:

"Encuentra empresas tecnológicas con una capitalización de mercado superior a 10.000 millones de dólares y un ratio P/E inferior a 20."

Comparar competidores:

"Compara Microsoft, Google y Amazon en cuanto a crecimiento de ingresos y márgenes de beneficio."

Comprobar el estado de la cuenta:

"¿Cuántas consultas me quedan este mes?"

Documentación

EXAMPLES.md — Prompts reales de Claude para cada categoría de herramienta
docs/ALIGNMENT.md — Cómo se mantiene el MCP sincronizado con las versiones de la API de la plataforma
CHANGELOG.md — Notas de la versión por versión
CONTRIBUTING.md — Flujo de trabajo y convenciones de desarrollo

Desarrollo

# Clone and install
git clone https://github.com/equivault/equivault-mcp
cd equivault-mcp
npm install

# Build
npm run build

# Run tests
npm test

# Type check
npm run typecheck

# Watch mode (development)
npm run dev

Licencia

MIT

equivault-mcp