Indexa Capital Server

Servidor MCP de solo lectura para monitorizar tus inversiones en Indexa Capital desde Claude (Desktop, Code, web).

Implementa el subconjunto de lectura de la API REST v1.6 de Indexa:

Tool MCP	Endpoint	Para qué sirve
indexa_portfolio_summary	varios	Resumen agregado de todas tus cuentas en una sola llamada
indexa_get_me	GET /users/me	Lista de cuentas y datos del usuario
indexa_get_account	GET /accounts/{id}	Perfil de la cuenta, riesgo, titulares
indexa_get_portfolio	GET /accounts/{id}/portfolio	Composición actual: valor, fondos, ISIN, P/L
indexa_get_performance	GET /accounts/{id}/performance	Serie histórica de rentabilidad y benchmark
indexa_get_transactions	GET /accounts/{id}/transactions	Movimientos: aportaciones, suscripciones, retiradas
indexa_get_fees	GET /accounts/{id}/fees	Comisiones de gestión por trimestre

Nota de seguridad: este servidor no implementa ningún endpoint de escritura (no puede mover dinero, abrir cuentas, ni modificar tu perfil). Si en el futuro quieres añadir aportaciones programadas o transferencias, requiere un fork explícito.

Requisitos

• Node.js 18 o superior
• Una cuenta en Indexa Capital
• Un token de API personal (instrucciones más abajo)

Instalación

Desde npm (usuarios)

No hace falta clonar ni compilar: el paquete incluye el código ya construido en dist/.

Instalación global (el binario queda en tu PATH de npm):

npm install -g indexa-capital-mcp-server

O ejecutarlo sin instalar globalmente (npx descarga el paquete cuando hace falta; -y evita el prompt de confirmación):

npx -y indexa-capital-mcp-server

Desde el repositorio (desarrollo)

git clone https://github.com/dacmail/indexa-capital-mcp-server.git
cd indexa-capital-mcp-server
npm install
npm run build

Obtener el token de API

1. Entra en tu área privada de Indexa Capital.
2. Ve a Configuración de usuario → Aplicaciones.
3. Genera un token. Tendrá esta pinta: eyJ0eXAiOiJKV1Qi....
4. Guárdalo a buen recaudo: es personal, intransferible, y suficiente para acceder a todos los datos de tu cuenta.

Configuración en Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json y añade una de estas opciones.

Con npx (recomendado; no necesitas ruta al clon ni al global node_modules):

{
  "mcpServers": {
    "indexa-capital": {
      "command": "npx",
      "args": ["-y", "indexa-capital-mcp-server"],
      "env": {
        "INDEXA_API_TOKEN": "eyJ0eXAiOiJKV1Qi..."
      }
    }
  }
}

Si instalaste el paquete con npm install -g:

{
  "mcpServers": {
    "indexa-capital": {
      "command": "indexa-capital-mcp-server",
      "args": [],
      "env": {
        "INDEXA_API_TOKEN": "eyJ0eXAiOiJKV1Qi..."
      }
    }
  }
}

Si trabajas desde un clon local (tras npm run build):

{
  "mcpServers": {
    "indexa-capital": {
      "command": "node",
      "args": ["/ruta/absoluta/a/indexa-capital-mcp-server/dist/index.js"],
      "env": {
        "INDEXA_API_TOKEN": "eyJ0eXAiOiJKV1Qi..."
      }
    }
  }
}

Reinicia Claude Desktop. Verás las 7 tools disponibles bajo el icono del enchufe.

Configuración en Claude Code

Con paquete publicado en npm (npx):

claude mcp add indexa-capital \
  --env INDEXA_API_TOKEN=eyJ0eXAiOiJKV1Qi... \
  -- npx -y indexa-capital-mcp-server

Con instalación global:

claude mcp add indexa-capital \
  --env INDEXA_API_TOKEN=eyJ0eXAiOiJKV1Qi... \
  -- indexa-capital-mcp-server

Desde un clon local:

claude mcp add indexa-capital \
  --env INDEXA_API_TOKEN=eyJ0eXAiOiJKV1Qi... \
  -- node /ruta/absoluta/a/indexa-capital-mcp-server/dist/index.js

Ejemplos de uso

Una vez conectado, puedes preguntarle a Claude cosas como:

• "¿Cómo van mis inversiones en Indexa?" — usa indexa_portfolio_summary
• "¿Qué fondos tengo en mi cartera de Indexa?" — usa indexa_get_portfolio
• "¿Cuánto he ganado este año en mi plan de pensiones?" — usa indexa_get_performance con date_from
• "Lista las aportaciones que hice en 2024" — usa indexa_get_transactions con filtro de fechas
• "¿Cuánto me ha cobrado Indexa en comisiones desde que abrí la cuenta?" — usa indexa_get_fees

Pruebas locales

# Compilar
npm run build

# Test rápido del token
INDEXA_API_TOKEN=eyJ... node -e "
  const axios = require('axios');
  axios.get('https://api.indexacapital.com/users/me', {
    headers: { 'X-AUTH-TOKEN': process.env.INDEXA_API_TOKEN }
  }).then(r => console.log(JSON.stringify(r.data, null, 2)));
"

# Inspector MCP oficial
npx @modelcontextprotocol/inspector node dist/index.js

(Recuerda exportar INDEXA_API_TOKEN antes de lanzar el inspector.)

Estructura del proyecto

src/
├── index.ts              # Entry point, registro de tools
├── constants.ts          # API URL, headers, límites
├── schemas/
│   └── common.ts         # Schemas Zod compartidos
├── services/
│   ├── client.ts         # Cliente Axios + manejo de errores
│   └── format.ts         # Helpers de formato (Markdown/JSON/EUR)
└── tools/
    ├── get_me.ts
    ├── get_account.ts
    ├── get_portfolio.ts
    ├── get_performance.ts
    ├── get_transactions.ts
    ├── get_fees.ts
    └── portfolio_summary.ts

Notas sobre la API

• El base URL es https://api.indexacapital.com.
• La autenticación se hace con el header X-AUTH-TOKEN.
• Los tokens generados desde el área privada no caducan, a diferencia de los tokens emitidos vía /auth/authenticate que duran ~16 h.
• Los endpoints /portfolio, /performance, /transactions y /fees no aparecen en la documentación pública RAML pero están confirmados por el soporte oficial y por clientes existentes (Indexa-Dashboard, plantillas Google Sheets, integraciones de la suite Sure). Las interfaces TypeScript son intencionalmente permisivas (? opcional, [key: string]: unknown) por si la API evoluciona.

Licencia

MIT.