MCP server de CueAPI
✓ VerificadoPermite que los agentes de IA programen tareas recurrentes o únicas, gestionen el historial de ejecución y reporten resultados con evidencia estructurada.
También conocido como cueapi/cueapi-mcp, cueapi-mcp, @cueapi/mcp
- Stars
- 2
- Herramientas
- 15
- Descargas, 30 días
- 282
- Última versión
- 0.1.3
- Último commit
- 3 ago 2026
- Licencia
- MIT
¿Qué es CueAPI MCP?
CueAPI es un MCP server. Permite que los agentes de IA programen tareas recurrentes o únicas, gestionen el historial de ejecución y reporten resultados con evidencia estructurada. Expone 15 herramientas, como cueapi_create_cue, cueapi_list_cues, cueapi_get_cue.
Resumen generado a partir del README del proyecto
Acerca del MCP server de CueAPI
Este servidor permite programar tareas recurrentes de agentes y gestionar el historial de ejecución directamente desde un asistente de IA. Proporciona una capa de coordinación para agentes que utilizan Claude Desktop, Cursor o Zed para manejar trabajos que se extienden en el tiempo y a través de diferentes entornos. Al usar este servidor, un agente puede crear programaciones basadas en cron o tareas únicas, rastrear ejecuciones históricas y reportar resultados completados utilizando evidencia estructurada como URLs o IDs externos.
Los usuarios se conectan al servicio instalando el paquete vía npm y configurando su host MCP con una CUEAPI_API_KEY. Para quienes realizan self-hosting, también se puede especificar la CUEAPI_BASE_URL. El conjunto de herramientas incluye comandos específicos para el ciclo de vida completo de una tarea, como cueapi_create_cue para la programación, cueapi_claim_execution para tomar trabajo pendiente y cueapi_report_outcome para proporcionar pruebas de finalización. Esto permite que los agentes gestionen traspasos complejos y aseguren que los fallos silenciosos se detecten mediante resultados documentados.
Qué puedes hacer con él
- 1Programar flujos de trabajo recurrentes de agentesUn agente puede configurar una tarea diaria para enviar datos a un webhook específico.
- 2Monitorear el historial de ejecución de tareasUn desarrollador puede pedirle a su asistente que revise ejecuciones previas de un trabajo programado.
- 3Reclamar y procesar tareas pendientesUn agente de IA puede tomar ejecuciones de trabajadores disponibles para realizar tareas específicas.
- 4Proporcionar evidencia de trabajo completadoUn agente puede cerrar el ciclo de una tarea enviando una URL de resultado como prueba de éxito.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar CueAPI MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar CueAPI MCP en Claude Code
$ claude mcp add --env 'CUEAPI_API_KEY=<YOUR_CUEAPI_API_KEY>' cueapi-mcp -- npx -y @cueapi/mcpInstalar CueAPI MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"cueapi-mcp": {
"command": "npx",
"args": [
"-y",
"@cueapi/mcp"
],
"env": {
"CUEAPI_API_KEY": "<YOUR_CUEAPI_API_KEY>"
}
}
}
}Instalar CueAPI MCP en VS Code
.vscode/mcp.json
{
"servers": {
"cueapi-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cueapi/mcp"
],
"env": {
"CUEAPI_API_KEY": "<YOUR_CUEAPI_API_KEY>"
}
}
}
}Instalar CueAPI MCP en VS Code CLI
$ code --add-mcp '{"name":"cueapi-mcp","type":"stdio","command":"npx","args":["-y","@cueapi/mcp"],"env":{"CUEAPI_API_KEY":"<YOUR_CUEAPI_API_KEY>"}}'Instalar CueAPI MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"cueapi-mcp": {
"command": "npx",
"args": [
"-y",
"@cueapi/mcp"
],
"env": {
"CUEAPI_API_KEY": "<YOUR_CUEAPI_API_KEY>"
}
}
}
}Instalar CueAPI MCP en Codex
$ codex mcp add cueapi-mcp --env 'CUEAPI_API_KEY=<YOUR_CUEAPI_API_KEY>' -- npx -y @cueapi/mcpInstalar CueAPI MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.cueapi-mcp] command = "npx" args = ["-y", "@cueapi/mcp"] [mcp_servers.cueapi-mcp.env] CUEAPI_API_KEY = "<YOUR_CUEAPI_API_KEY>"
Instalar CueAPI MCP en Gemini CLI
$ gemini mcp add -s user -e 'CUEAPI_API_KEY=<YOUR_CUEAPI_API_KEY>' cueapi-mcp npx -- -y @cueapi/mcpInstalar CueAPI MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"cueapi-mcp": {
"command": "npx",
"args": [
"-y",
"@cueapi/mcp"
],
"env": {
"CUEAPI_API_KEY": "<YOUR_CUEAPI_API_KEY>"
}
}
}
}Herramientas de CueAPI MCP 15
Detectado desde el READMEcueapi_create_cuecueapi_list_cuescueapi_get_cuecueapi_fire_cuecueapi_update_cuecueapi_pause_cuecueapi_resume_cuecueapi_delete_cuecueapi_list_executionscueapi_get_executioncueapi_list_claimable_executionscueapi_claim_execution
| cueapi_create_cue | — | |
| cueapi_list_cues | — | |
| cueapi_get_cue | — | |
| cueapi_fire_cue | — | |
| cueapi_update_cue | — | |
| cueapi_pause_cue | — | |
| cueapi_resume_cue | — | |
| cueapi_delete_cue | — | |
| cueapi_list_executions | — | |
| cueapi_get_execution | — | |
| cueapi_list_claimable_executions | — | |
| cueapi_claim_execution | — |
Mostrar las 15 herramientasMostrar menos herramientas
cueapi_claim_next_executioncueapi_execution_heartbeatcueapi_report_outcome
| cueapi_claim_next_execution | — | |
| cueapi_execution_heartbeat | — | |
| cueapi_report_outcome | — |
Configuración
CUEAPI_API_KEYObligatorioSecretoCueAPI API key. Generate at https://cueapi.ai
CUEAPI_BASE_URLOverride the CueAPI base URL for self-hosted instances. Defaults to https://api.cueapi.ai
| Nombre | Descripción | Tipo |
|---|---|---|
| CUEAPI_API_KEY | CueAPI API key. Generate at https://cueapi.ai | ObligatorioSecreto |
| CUEAPI_BASE_URL | Override the CueAPI base URL for self-hosted instances. Defaults to https://api.cueapi.ai |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesiblecueapi/cueapi-mcp is public and reachablegithub.com/cueapi/cueapi-mcp ↗Aprobado
- El paquete indica este repositorio como su origen@cueapi/mcp names cueapi/cueapi-mcp as sourcenpmjs.com/package/@cueapi/mcp ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-08-03github.com/cueapi/cueapi-mcp ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from @cueapi/mcpAprobado
- No hay avisos críticos en el paquete ni en sus dependencias99 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo15 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo tool named like delete, drop or execAprobado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubcueapi-mcp
Official Model Context Protocol server for CueAPI, the open-source coordination layer for AI agent systems.
Give your MCP-enabled assistant (Claude Desktop, Cursor, Zed, or any other MCP host) the ability to schedule agent work, fetch execution history, and close the loop with evidence-backed outcome reports, all from inside a conversation.
Why
Agents don't finish in one call. They coordinate across time, tools, environments, agents, and humans. Every handoff is a place where silent failure hides. CueAPI closes each handoff with structured evidence: an external ID, a result URL, or an artifact. This MCP server gives the agent direct access to that surface, so the agent can both schedule its own follow-up work and report outcomes with proof.
Install
npm install -g @cueapi/mcp
# or use via npx (no install):
npx -y @cueapi/mcp
Configure (Claude Desktop)
Add this to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"cueapi": {
"command": "npx",
"args": ["-y", "@cueapi/mcp"],
"env": {
"CUEAPI_API_KEY": "cue_sk_..."
}
}
}
}
Generate your API key at cueapi.ai. Self-hosting? Set CUEAPI_BASE_URL alongside CUEAPI_API_KEY.
Configure (Cursor / Zed / other hosts)
Any MCP host that supports stdio servers can run this. Point the host at the cueapi-mcp binary and pass CUEAPI_API_KEY in the environment.
Tools exposed
| Tool | What it does |
|---|---|
cueapi_create_cue |
Create a recurring (cron) or one-time (at) cue |
cueapi_list_cues |
List cues, filter by status |
cueapi_get_cue |
Fetch details for a single cue |
cueapi_fire_cue |
Fire an existing cue immediately, optional payload override |
cueapi_update_cue |
Update a cue's mutable fields (name, schedule, callback, payload, etc.) |
cueapi_pause_cue |
Pause a cue so it stops firing |
cueapi_resume_cue |
Resume a paused cue |
cueapi_delete_cue |
Delete a cue permanently |
cueapi_list_executions |
List historical executions, filter by cue/status |
cueapi_get_execution |
Fetch a single execution by ID, with state + outcome |
cueapi_list_claimable_executions |
List unclaimed worker executions, filter server-side by task/agent |
cueapi_claim_execution |
Atomically claim a specific execution for processing |
cueapi_claim_next_execution |
Claim the next available execution (optional task filter) |
cueapi_execution_heartbeat |
Extend the claim lease on an in-flight execution |
cueapi_report_outcome |
Report write-once outcome with evidence (external ID / URL) |
Example conversation
You: Schedule a daily 9am job that posts a digest to my webhook.
Assistant (uses
cueapi_create_cue): Created cuecue_abc123, first fire tomorrow at 9:00 UTC.You: Show me the last five times it ran.
Assistant (uses
cueapi_list_executions): ...
Development
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
Links
- CueAPI homepage: https://cueapi.ai
- Docs: https://docs.cueapi.ai
- Core (open source): https://github.com/cueapi/cueapi-core
- Model Context Protocol: https://modelcontextprotocol.io
Changelog
- 0.4.1. Add
cueapi_update_cuetool: update a cue's mutable fields (name, schedule, callback URL, timezone, payload, description). WrapsPATCH /v1/cues/{id}. Sparse update — only provided fields are sent. Closes the cross-wrapper parity gap (every other client wrapper exposed update; MCP didn't until now). - 0.4.0. Add five execution-lifecycle tools —
cueapi_get_execution,cueapi_list_claimable_executions,cueapi_claim_execution,cueapi_claim_next_execution,cueapi_execution_heartbeat. Closes the receive-claim-process-complete loop for MCP-host agents that want to consume worker-transport executions from in-session (e.g. Claude Desktop, Cursor, Zed). Highlights:list_claimable_executionsfilters server-side viatask/agentquery params (client-side filtering hits a known LIMIT-50 starvation bug);claim_next_executionaccepts an optionaltask_nameand internally fans out (filtered list → pick oldest → claim by ID) since the server doesn't yet support a task filter on the bare claim endpoint;execution_heartbeatsendsworker_idvia theX-Worker-Idrequest header (the server's transport for that field) and requires it in the schema so misconfigured callers fail at the wrapper instead of silently bypassing race protection. Internal:CueAPIClient.request()gains an optionalextraHeadersparameter to support per-call custom headers. - 0.3.0. Add
cueapi_fire_cuetool: fire an existing cue immediately with an optionalpayload_override(andmerge_strategy: 'merge' | 'replace', default'merge'). WrapsPOST /v1/cues/{id}/fire. Lets agents trigger ad-hoc one-shot executions without creating throwaway cues, and lets per-fire dynamic data flow through to webhook dispatch + worker-claim responses without mutating the stored cue. - 0.1.4. Fix
cueapi_pause_cue/cueapi_resume_cueto usePATCH /v1/cues/{id}with{"status": "paused" | "active"}(previously called non-existent/pauseand/resumeendpoints, returning a runtime 404). PR #1. This is the release that actually contains the fix; 0.1.3 was published prematurely with this note but without the merged code. - 0.1.3. Premature publish, superseded by 0.1.4. No functional changes from 0.1.2.
- 0.1.2. Register with the Official MCP Registry.
- 0.1.0. Initial release: 8 tools for create / list / get / pause / resume / delete cues, list executions, report outcome.
License
MIT © Vector Apps Inc.
Preguntas sobre CueAPI MCP
¿Cómo agrego CueAPI MCP a Claude Code?
Ejecuta claude mcp add --env 'CUEAPI_API_KEY=<YOUR_CUEAPI_API_KEY>' cueapi-mcp -- npx -y @cueapi/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego CueAPI MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona CueAPI MCP?
Expone 15 herramientas, incluidas cueapi_create_cue, cueapi_list_cues, cueapi_get_cue, cueapi_fire_cue, cueapi_update_cue.
¿Cómo instalo el MCP server de CueAPI?
Puedes instalarlo globalmente usando npm con npm install -g @cueapi/mcp o ejecutarlo sin instalación usando npx -y @cueapi/mcp.
¿Qué tipo de tareas puedo programar?
Puedes crear tanto tareas recurrentes usando cron schedules como tareas únicas usando el comando 'at'.
¿Puedo usar esto con Claude Desktop?
Sí, puedes configurar Claude Desktop añadiendo el servidor a tu archivo claude_desktop_config.json y proporcionando tu CUEAPI_API_KEY.