Model Context Protocol

Conecta tu agente de IA a El Portal.

El servidor MCP de El Portal expone tu sistema operativo personal a cualquier cliente de IA compatible con MCP. Lee el estado de tu ciclo, registra hábitos y haz tus check-ins diarios sin salir del flujo de trabajo de tu agente.

12 herramientasstdio + HTTPJSON-RPC 2.0

Capacidades

Las herramientas de lectura se conceden en todas las claves por defecto. Las herramientas de escritura requieren activación explícita al crear la clave.

Herramientas de lectura

portal_snapshot

Estado completo del dashboard. Ciclo activo, hábitos con rachas y done_today, objetivos, puntuación diaria. Secciones opcionales: pulse_today, archivos, identidad, mantras.

portal_review

Datos de revisión del ciclo. Puntuaciones diarias, porcentajes de consistencia de hábitos, días restantes.

portal_history

Consulta versiones, ciclos o debriefs anteriores. Filtra por versión o estado.

portal_search

Búsqueda de texto completo en objetivos, hábitos, archivos y mantras. Hasta 50 resultados.

Herramientas de escritura

portal_log_habits

Registra hábitos como hechos o no hechos para cualquier fecha. Compatible con upsert. Lotes de hasta 30. Devuelve rachas actualizadas y la puntuación diaria.

portal_pulse

Lee o escribe los check-ins de Pulse matutinos y nocturnos. Cubre ánimo, energía, sueño, estrés, rendimiento, sentimientos y reflexión.

portal_create_cycle

Crea un ciclo completo en una sola llamada: objetivos, hábitos, prioridades, mantras y objetivos trasladados de ciclos anteriores.

portal_debrief_cycle

Cierra un ciclo. El servidor calcula las estadísticas (puntuación media, mejores hábitos, tasa de finalización de objetivos). Aportas la reflexión.

portal_create

Crea nuevas entidades: versión, objetivo, hábito, archivo, mantra o elemento de identidad. Lotes de hasta 10.

portal_update

Actualización parcial de cualquier tipo de entidad. Lotes de hasta 10 operaciones.

portal_delete

Elimina entidades por ID. Aplica en cascada cuando corresponde. Lotes de hasta 10.

portal_settings

Lee o actualiza tu perfil de usuario y tus preferencias de la app.

Primeros pasos

1. Generar una clave de API

Ve a Configuración > Claves de API en El Portal. Tu clave se muestra una sola vez al crearla. Cópiala de inmediato. Las claves empiezan con ep_ seguido de 64 caracteres hexadecimales. Se procesan con un hash SHA-256 antes de guardarse y no se pueden recuperar después de la creación. Hasta 10 claves activas por cuenta, con vencimiento opcional de hasta 365 días.

2. Elegir un transporte

Usa stdio para herramientas de IA locales (Cursor, Claude Desktop, Continue). Usa HTTP para agentes basados en la web o integraciones personalizadas del lado del servidor.

3. Añadir tu configuración

Stdio (.mcp.json)

{
  "mcpServers": {
    "el-portal": {
      "type": "stdio",
      "command": "cmd",
      "args": [
        "/c", "npx", "tsx",
        "--env-file-if-exists=.env.local",
        "--tsconfig", "tsconfig.json",
        "src/mcp/index.ts"
      ],
      "env": {
        "PORTAL_API_KEY": "ep_YOUR_KEY_HERE"
      }
    }
  }
}

Endpoint HTTP

POST https://app.el-portal.app/api/mcp
Authorization: Bearer ep_YOUR_KEY_HERE
Content-Type: application/json

Referencia de herramientas

Todas las herramientas usan JSON-RPC 2.0 a través del protocolo MCP. Expande cada entrada para ver los parámetros y los valores de retorno.

lecturaportal_snapshot

Estado completo del dashboard. Ciclo activo, hábitos con rachas y done_today, objetivos, puntuación diaria. Secciones opcionales: pulse_today, archivos, identidad, mantras.

Parámetros

include?: ("pulse_today" | "archives" | "identity" | "mantras")[]

Retorno

Snapshot object with cycle, habits array, goals array, daily score, and any requested optional sections.

lecturaportal_review

Datos de revisión del ciclo. Puntuaciones diarias, porcentajes de consistencia de hábitos, días restantes.

Parámetros

include?: ("insights" | "pulse_history" | "debrief_stats")[]

Retorno

Review object with scores array, consistency map, days remaining, and optional extras.

lecturaportal_history

Consulta versiones, ciclos o debriefs anteriores. Filtra por versión o estado.

Parámetros

type: "version" | "cycle" | "debrief", version?: string, status?: string

Retorno

Array of matching historical records ordered by creation date.

lecturaportal_search

Búsqueda de texto completo en objetivos, hábitos, archivos y mantras. Hasta 50 resultados.

Parámetros

query: string, limit?: number (max 50)

Retorno

Array of matching entities with type, id, title, and excerpt.

escrituraportal_log_habits

Registra hábitos como hechos o no hechos para cualquier fecha. Compatible con upsert. Lotes de hasta 30. Devuelve rachas actualizadas y la puntuación diaria.

Parámetros

entries: { habit_id: string; status: boolean; date?: string }[], up to 30

Retorno

Array of updated habit records with current streak and revised daily score.

escrituraportal_pulse

Lee o escribe los check-ins de Pulse matutinos y nocturnos. Cubre ánimo, energía, sueño, estrés, rendimiento, sentimientos y reflexión.

Parámetros

action: "read" | "write", section: "morning" | "evening", data?: PulseData

Retorno

Current pulse check-in data for the given section, or confirmation of write.

escrituraportal_create_cycle

Crea un ciclo completo en una sola llamada: objetivos, hábitos, prioridades, mantras y objetivos trasladados de ciclos anteriores.

Parámetros

title: string, goals: Goal[], habits: Habit[], priorities?: string[], mantras?: string[], carry_over?: string[]

Retorno

Created cycle object with all nested entities and generated IDs.

escrituraportal_debrief_cycle

Cierra un ciclo. El servidor calcula las estadísticas (puntuación media, mejores hábitos, tasa de finalización de objetivos). Aportas la reflexión.

Parámetros

cycle_id: string, reflection: string

Retorno

Debrief record with server-computed stats, reflection text, and closed cycle summary.

escrituraportal_create

Crea nuevas entidades: versión, objetivo, hábito, archivo, mantra o elemento de identidad. Lotes de hasta 10.

Parámetros

entities: { type: EntityType; data: EntityData }[], up to 10

Retorno

Array of created entities with generated IDs and timestamps.

escrituraportal_update

Actualización parcial de cualquier tipo de entidad. Lotes de hasta 10 operaciones.

Parámetros

operations: { type: EntityType; id: string; data: Partial<EntityData> }[], up to 10

Retorno

Array of updated entities reflecting the applied changes.

escrituraportal_delete

Elimina entidades por ID. Aplica en cascada cuando corresponde. Lotes de hasta 10.

Parámetros

items: { type: EntityType; id: string }[], up to 10

Retorno

Confirmation array with deleted IDs and cascade summary per item.

escrituraportal_settings

Lee o actualiza tu perfil de usuario y tus preferencias de la app.

Parámetros

action: "read" | "update", data?: Partial<UserSettings>

Retorno

Current or updated user settings object.

Ejemplos

Obtener el snapshot de hoy

{
  "method": "tools/call",
  "params": {
    "name": "portal_snapshot",
    "arguments": {
      "include": ["pulse_today"]
    }
  }
}

Registrar un hábito

{
  "method": "tools/call",
  "params": {
    "name": "portal_log_habits",
    "arguments": {
      "entries": [
        { "habit_id": "your-habit-uuid", "status": true }
      ]
    }
  }
}

Check-in matutino

{
  "method": "tools/call",
  "params": {
    "name": "portal_pulse",
    "arguments": {
      "action": "write",
      "section": "morning",
      "data": {
        "sleep_quality": "good",
        "morning_mood": "energized",
        "one_thing": "Finish the MCP docs"
      }
    }
  }
}

Permisos y límites de frecuencia

Modelo de permisos

  • lectura

    Se concede en todas las claves por defecto. No requiere configuración adicional.

  • escritura

    Activación opcional por clave. Activa o desactiva cada herramienta de escritura al crear la clave o en los ajustes de la clave.

  • almacenamiento

    Las claves se procesan con un hash SHA-256 antes de guardarse. El texto plano nunca se almacena y no se puede recuperar después de la creación.

Límites de frecuencia

Herramientas de lecturaSin límite
Herramientas de escritura30 / min
Creación de claves5 / h
Claves activas10 por cuenta

¿Listo para conectar?

Genera tu primera clave de API en Configuración e insértala en tu configuración de MCP. Acceso de lectura completo en menos de un minuto.

Abrir Configuración