MCP server CueAPI
✓ VerificadoPermite que agentes de IA agendem tarefas recorrentes ou únicas, gerenciem o histórico de execução e relatem resultados com evidências estruturadas.
Também conhecido como cueapi/cueapi-mcp, cueapi-mcp, @cueapi/mcp
- Stars
- 2
- Ferramentas
- 15
- Downloads, 30 dias
- 282
- Versão mais recente
- 0.1.3
- Último commit
- 3 de ago. de 2026
- Licença
- MIT
O que é o MCP CueAPI?
Permite que agentes de IA agendem tarefas recorrentes ou únicas, gerenciem o histórico de execução e relatem resultados com evidências estruturadas. Ele expõe 15 ferramentas, como cueapi_create_cue, cueapi_list_cues, cueapi_get_cue.
Resumo gerado a partir do README do projeto
Sobre o MCP server de CueAPI
Este servidor permite o agendamento de tarefas recorrentes de agentes e o gerenciamento do histórico de execução diretamente de dentro de um assistente de IA. Ele fornece uma camada de coordenação para agentes que utilizam Claude Desktop, Cursor ou Zed para lidar com trabalhos que abrangem diferentes períodos de tempo e ambientes. Ao usar este servidor, um agente pode criar agendamentos baseados em cron ou tarefas únicas, rastrear execuções históricas e relatar resultados concluídos usando evidências estruturadas, como URLs ou IDs externos.
Os usuários se conectam ao serviço instalando o pacote via npm e configurando seu host MCP com uma CUEAPI_API_KEY. Para quem faz self-hosting, a CUEAPI_BASE_URL também pode ser especificada. O conjunto de ferramentas inclui comandos específicos para o ciclo de vida completo de uma tarefa, como cueapi_create_cue para agendamento, cueapi_claim_execution para assumir trabalhos pendentes e cueapi_report_outcome para fornecer prova de conclusão. Isso permite que os agentes gerenciem handoffs complexos e garantam que falhas silenciosas sejam detectadas por meio de resultados documentados.
O que você pode fazer com ele
- 1Agendar workflows recorrentes de agentesUm agente pode configurar uma tarefa diária para enviar dados para um webhook específico.
- 2Monitorar o histórico de execução de tarefasUm desenvolvedor pode pedir ao seu assistente para revisar execuções anteriores de um job agendado.
- 3Assumir e processar tarefas pendentesUm agente de IA pode assumir execuções de workers disponíveis para realizar funções específicas.
- 4Fornecer evidências de trabalho concluídoUm agente pode fechar o ciclo de uma tarefa enviando uma URL de resultado como prova de sucesso.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Como instalar o MCP CueAPI
Formatos verificados em 10 nov 2026Adicionar ao CursorAdicionar ao GooseInstalar o MCP CueAPI no Claude Code
$ claude mcp add --env 'CUEAPI_API_KEY=<YOUR_CUEAPI_API_KEY>' cueapi-mcp -- npx -y @cueapi/mcpInstalar o MCP CueAPI no Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"cueapi-mcp": {
"command": "npx",
"args": [
"-y",
"@cueapi/mcp"
],
"env": {
"CUEAPI_API_KEY": "<YOUR_CUEAPI_API_KEY>"
}
}
}
}Instalar o MCP CueAPI no 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 o MCP CueAPI no 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 o MCP CueAPI no Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"cueapi-mcp": {
"command": "npx",
"args": [
"-y",
"@cueapi/mcp"
],
"env": {
"CUEAPI_API_KEY": "<YOUR_CUEAPI_API_KEY>"
}
}
}
}Instalar o MCP CueAPI no Codex
$ codex mcp add cueapi-mcp --env 'CUEAPI_API_KEY=<YOUR_CUEAPI_API_KEY>' -- npx -y @cueapi/mcpInstalar o MCP CueAPI no 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 o MCP CueAPI no Gemini CLI
$ gemini mcp add -s user -e 'CUEAPI_API_KEY=<YOUR_CUEAPI_API_KEY>' cueapi-mcp npx -- -y @cueapi/mcpInstalar o MCP CueAPI no Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"cueapi-mcp": {
"command": "npx",
"args": [
"-y",
"@cueapi/mcp"
],
"env": {
"CUEAPI_API_KEY": "<YOUR_CUEAPI_API_KEY>"
}
}
}
}Ferramentas do MCP CueAPI 15
Detectadas a partir do 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 todas as 15 ferramentasMostrar menos ferramentas
cueapi_claim_next_executioncueapi_execution_heartbeatcueapi_report_outcome
| cueapi_claim_next_execution | — | |
| cueapi_execution_heartbeat | — | |
| cueapi_report_outcome | — |
Configuração
CUEAPI_API_KEYObrigatórioSecretoCueAPI API key. Generate at https://cueapi.ai
CUEAPI_BASE_URLOverride the CueAPI base URL for self-hosted instances. Defaults to https://api.cueapi.ai
| Nome | Descrição | Tipo |
|---|---|---|
| CUEAPI_API_KEY | CueAPI API key. Generate at https://cueapi.ai | ObrigatórioSecreto |
| CUEAPI_BASE_URL | Override the CueAPI base URL for self-hosted instances. Defaults to https://api.cueapi.ai |
Verificações automatizadas
Executado em 14 de nov. de 2026Relatório completo →Passou em nossas verificações automatizadas. Isso não é uma auditoria de segurança: leia o código e dê ao servidor o acesso mais restrito de que ele precisa. Como as verificações funcionam
- Repositório de origem vinculado e acessívelcueapi/cueapi-mcp is public and reachablegithub.com/cueapi/cueapi-mcp ↗Passou
- O pacote indica este repositório como sua origem@cueapi/mcp names cueapi/cueapi-mcp as sourcenpmjs.com/package/@cueapi/mcp ↗Passou
- Proveniência da build (atestação Sigstore)No build attestation published for this releaseNão verificado
- Licença de código aberto (OSI)MITspdx.org/licenses/MIT.html ↗Passou
- Commit ou release no último anoLast commit or release 2026-08-03github.com/cueapi/cueapi-mcp ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNo popular package one edit away from @cueapi/mcpPassou
- Nenhum aviso crítico no pacote ou em suas dependências99 resolved dependencies checked; no critical advisoryosv.dev ↗Passou
- Sem instruções ocultas para o modelo15 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNo tool named like delete, drop or execPassou
- O endpoint remoto responde ao handshake do MCPNão verificado
README
Ver no 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.
Perguntas sobre o MCP CueAPI
Como adiciono o MCP CueAPI ao Claude Code?
Execute claude mcp add --env 'CUEAPI_API_KEY=<YOUR_CUEAPI_API_KEY>' cueapi-mcp -- npx -y @cueapi/mcp no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.
Como adiciono o MCP CueAPI ao Cursor?
Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.
Quais ferramentas o MCP CueAPI oferece?
Ele expõe 15 ferramentas, incluindo cueapi_create_cue, cueapi_list_cues, cueapi_get_cue, cueapi_fire_cue, cueapi_update_cue.
Como eu instalo o MCP server CueAPI?
Você pode instalá-lo globalmente usando npm com npm install -g @cueapi/mcp ou executá-lo sem instalação usando npx -y @cueapi/mcp.
Que tipo de tarefas posso agendar?
Você pode criar tanto tarefas recorrentes usando cron schedules quanto tarefas únicas usando o comando 'at'.
Posso usar isso com o Claude Desktop?
Sim, você pode configurar o Claude Desktop adicionando o servidor ao seu arquivo claude_desktop_config.json e fornecendo sua CUEAPI_API_KEY.