cueapi-mcp

Servidor oficial del Model Context Protocol para CueAPI, la capa de coordinación de código abierto para sistemas de agentes de IA.

Dale a tu asistente compatible con MCP (Claude Desktop, Cursor, Zed o cualquier otro host MCP) la capacidad de programar el trabajo de agentes, obtener el historial de ejecución y cerrar el ciclo con informes de resultados respaldados por evidencia, todo desde dentro de una conversación.

Por qué

Los agentes no terminan en una sola llamada. Se coordinan a través del tiempo, herramientas, entornos, agentes y humanos. Cada transferencia es un lugar donde se ocultan fallos silenciosos. CueAPI cierra cada transferencia con evidencia estructurada: un ID externo, una URL de resultado o un artefacto. Este servidor MCP le da al agente acceso directo a esa superficie, de modo que el agente pueda programar su propio trabajo de seguimiento e informar los resultados con pruebas.

Related MCP server: moo-tasks

Instalación

npm install -g @cueapi/mcp
# or use via npx (no install):
npx -y @cueapi/mcp

Configuración (Claude Desktop)

Añade esto a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

{
  "mcpServers": {
    "cueapi": {
      "command": "npx",
      "args": ["-y", "@cueapi/mcp"],
      "env": {
        "CUEAPI_API_KEY": "cue_sk_..."
      }
    }
  }
}

Genera tu clave API en cueapi.ai. ¿Realizas el alojamiento propio? Configura CUEAPI_BASE_URL junto con CUEAPI_API_KEY.

Configuración (Cursor / Zed / otros hosts)

Cualquier host MCP que admita servidores stdio puede ejecutar esto. Apunta el host al binario cueapi-mcp y pasa CUEAPI_API_KEY en el entorno.

Herramientas expuestas

Ejemplo de conversación

Tú: Programa un trabajo diario a las 9am que publique un resumen en mi webhook.

Asistente (usa cueapi_create_cue): Aviso cue_abc123 creado, primer disparo mañana a las 9:00 UTC.

Tú: Muéstrame las últimas cinco veces que se ejecutó.

Asistente (usa cueapi_list_executions): ...

Desarrollo

npm install
npm test        # vitest smoke tests for the tool surface
npm run build   # compile TypeScript to dist/
npm run dev     # run the server locally with tsx

Enlaces

• Página de inicio de CueAPI: https://cueapi.ai

• Documentación: https://docs.cueapi.ai

• Núcleo (código abierto): https://github.com/cueapi/cueapi-core

• Model Context Protocol: https://modelcontextprotocol.io

Registro de cambios

• 0.4.1. Añade la herramienta cueapi_update_cue: actualiza los campos mutables de un aviso (nombre, programación, URL de callback, zona horaria, carga útil, descripción). Envuelve PATCH /v1/cues/{id}. Actualización dispersa: solo se envían los campos proporcionados. Cierra la brecha de paridad entre envoltorios (todos los demás envoltorios de cliente exponían la actualización; MCP no lo hacía hasta ahora).

• 0.4.0. Añade cinco herramientas de ciclo de vida de ejecución: cueapi_get_execution, cueapi_list_claimable_executions, cueapi_claim_execution, cueapi_claim_next_execution, cueapi_execution_heartbeat. Cierra el ciclo de recibir-reclamar-procesar-completar para agentes de host MCP que desean consumir ejecuciones de transporte de trabajador desde la sesión (ej. Claude Desktop, Cursor, Zed). Aspectos destacados: list_claimable_executions filtra en el servidor mediante parámetros de consulta task / agent (el filtrado del lado del cliente alcanza un error conocido de agotamiento LIMIT-50); claim_next_execution acepta un task_name opcional y se distribuye internamente (lista filtrada → elegir la más antigua → reclamar por ID) ya que el servidor aún no admite un filtro de tarea en el punto final de reclamación básico; execution_heartbeat envía worker_id a través del encabezado de solicitud X-Worker-Id (el transporte del servidor para ese campo) y lo requiere en el esquema para que los llamadores mal configurados fallen en el envoltorio en lugar de omitir silenciosamente la protección contra condiciones de carrera. Interno: CueAPIClient.request() obtiene un parámetro opcional extraHeaders para admitir encabezados personalizados por llamada.

• 0.3.0. Añade la herramienta cueapi_fire_cue: dispara un aviso existente inmediatamente con un payload_override opcional (y merge_strategy: 'merge' | 'replace', predeterminado 'merge'). Envuelve POST /v1/cues/{id}/fire. Permite a los agentes activar ejecuciones únicas ad-hoc sin crear avisos desechables, y permite que los datos dinámicos por disparo fluyan hacia el envío de webhook + respuestas de reclamación de trabajador sin mutar el aviso almacenado.

• 0.1.4. Corrige cueapi_pause_cue / cueapi_resume_cue para usar PATCH /v1/cues/{id} con {"status": "paused" | "active"} (anteriormente llamaba a puntos finales /pause y /resume inexistentes, devolviendo un 404 en tiempo de ejecución). PR #1. Esta es la versión que realmente contiene la corrección; la 0.1.3 se publicó prematuramente con esta nota pero sin el código fusionado.

• 0.1.3. Publicación prematura, reemplazada por la 0.1.4. Sin cambios funcionales respecto a la 0.1.2.

• 0.1.2. Registro en el Registro Oficial de MCP.

• 0.1.0. Lanzamiento inicial: 8 herramientas para crear / listar / obtener / pausar / reanudar / eliminar avisos, listar ejecuciones, informar resultados.

Licencia

MIT © Vector Apps Inc.