Serveur MCP CueAPI
✓ VérifiéPermet aux agents IA de planifier des tâches récurrentes ou ponctuelles, de gérer l'historique d'exécution et de rapporter les résultats avec des preuves structurées.
Aussi connu sous cueapi/cueapi-mcp, cueapi-mcp, @cueapi/mcp
- Étoiles
- 2
- Outils
- 15
- Téléchargements, 30 jours
- 282
- Dernière version
- 0.1.3
- Dernier commit
- 3 août 2026
- Licence
- MIT
Qu'est-ce que CueAPI MCP ?
CueAPI est un serveur MCP. Permet aux agents IA de planifier des tâches récurrentes ou ponctuelles, de gérer l'historique d'exécution et de rapporter les résultats avec des preuves structurées. Il expose 15 outils, comme cueapi_create_cue, cueapi_list_cues, cueapi_get_cue.
Résumé généré à partir du README du projet
À propos du MCP server CueAPI
Ce serveur permet de planifier des tâches d'agents récurrentes et de gérer l'historique d'exécution directement depuis un assistant IA. Il fournit une couche de coordination pour les agents utilisant Claude Desktop, Cursor ou Zed afin de gérer des travaux qui s'étendent dans le temps et sur différents environnements. En utilisant ce serveur, un agent peut créer des plannings basés sur cron ou des tâches ponctuelles, suivre les exécutions historiques et rapporter les résultats terminés en utilisant des preuves structurées telles que des URL ou des identifiants externes.
Les utilisateurs se connectent au service en installant le package via npm et en configurant leur hôte MCP avec une CUEAPI_API_KEY. Pour ceux qui pratiquent l'auto-hébergement, la CUEAPI_BASE_URL peut également être spécifiée. L'ensemble d'outils comprend des commandes spécifiques pour le cycle de vie complet d'une tâche, comme cueapi_create_cue pour la planification, cueapi_claim_execution pour récupérer le travail en attente, et cueapi_report_outcome pour fournir une preuve d'achèvement. Cela permet aux agents de gérer des transferts complexes et de s'assurer que les échecs silencieux sont détectés grâce à des résultats documentés.
Ce que vous pouvez faire avec
- 1Planifier des workflows d'agents récurrentsUn agent peut mettre en place une tâche quotidienne pour envoyer des données vers un webhook spécifique.
- 2Surveiller l'historique d'exécution des tâchesUn développeur peut demander à son assistant de passer en revue les exécutions précédentes d'un job planifié.
- 3Récupérer et traiter les tâches en attenteUn agent IA peut récupérer les exécutions de workers disponibles pour accomplir des missions spécifiques.
- 4Fournir des preuves pour le travail terminéUn agent peut clôturer une boucle de tâche en soumettant une URL de résultat comme preuve de succès.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer CueAPI MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller CueAPI MCP dans Claude Code
$ claude mcp add --env 'CUEAPI_API_KEY=<YOUR_CUEAPI_API_KEY>' cueapi-mcp -- npx -y @cueapi/mcpInstaller CueAPI MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"cueapi-mcp": {
"command": "npx",
"args": [
"-y",
"@cueapi/mcp"
],
"env": {
"CUEAPI_API_KEY": "<YOUR_CUEAPI_API_KEY>"
}
}
}
}Installer CueAPI MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"cueapi-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cueapi/mcp"
],
"env": {
"CUEAPI_API_KEY": "<YOUR_CUEAPI_API_KEY>"
}
}
}
}Installer CueAPI MCP dans 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>"}}'Installer CueAPI MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"cueapi-mcp": {
"command": "npx",
"args": [
"-y",
"@cueapi/mcp"
],
"env": {
"CUEAPI_API_KEY": "<YOUR_CUEAPI_API_KEY>"
}
}
}
}Installer CueAPI MCP dans Codex
$ codex mcp add cueapi-mcp --env 'CUEAPI_API_KEY=<YOUR_CUEAPI_API_KEY>' -- npx -y @cueapi/mcpInstaller CueAPI MCP dans 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>"
Installer CueAPI MCP dans Gemini CLI
$ gemini mcp add -s user -e 'CUEAPI_API_KEY=<YOUR_CUEAPI_API_KEY>' cueapi-mcp npx -- -y @cueapi/mcpInstaller CueAPI MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"cueapi-mcp": {
"command": "npx",
"args": [
"-y",
"@cueapi/mcp"
],
"env": {
"CUEAPI_API_KEY": "<YOUR_CUEAPI_API_KEY>"
}
}
}
}Outils MCP CueAPI 15
Détectés depuis le 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 | — |
Afficher les 15 outilsAfficher moins d'outils
cueapi_claim_next_executioncueapi_execution_heartbeatcueapi_report_outcome
| cueapi_claim_next_execution | — | |
| cueapi_execution_heartbeat | — | |
| cueapi_report_outcome | — |
Configuration
CUEAPI_API_KEYRequisSecretCueAPI API key. Generate at https://cueapi.ai
CUEAPI_BASE_URLOverride the CueAPI base URL for self-hosted instances. Defaults to https://api.cueapi.ai
| Nom | Description | Type |
|---|---|---|
| CUEAPI_API_KEY | CueAPI API key. Generate at https://cueapi.ai | RequisSecret |
| CUEAPI_BASE_URL | Override the CueAPI base URL for self-hosted instances. Defaults to https://api.cueapi.ai |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessiblecueapi/cueapi-mcp is public and reachablegithub.com/cueapi/cueapi-mcp ↗Réussi
- Le nom du package correspond au dépôt source@cueapi/mcp names cueapi/cueapi-mcp as sourcenpmjs.com/package/@cueapi/mcp ↗Réussi
- Provenance du build (attestation Sigstore)No build attestation published for this releaseNon vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-08-03github.com/cueapi/cueapi-mcp ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from @cueapi/mcpRéussi
- Aucun avis critique dans le package ou ses dépendances99 resolved dependencies checked; no critical advisoryosv.dev ↗Réussi
- Aucune instruction cachée destinée au modèle15 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNo tool named like delete, drop or execRéussi
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur 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.
Questions sur CueAPI MCP
Comment ajouter CueAPI MCP à Claude Code ?
Exécutez claude mcp add --env 'CUEAPI_API_KEY=<YOUR_CUEAPI_API_KEY>' cueapi-mcp -- npx -y @cueapi/mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter CueAPI MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Quels outils CueAPI MCP fournit-il ?
Il expose 15 outils, dont cueapi_create_cue, cueapi_list_cues, cueapi_get_cue, cueapi_fire_cue, cueapi_update_cue.
Comment installer le MCP server CueAPI ?
Vous pouvez l'installer globalement via npm avec npm install -g @cueapi/mcp ou l'exécuter sans installation en utilisant npx -y @cueapi/mcp.
Quel type de tâches puis-je planifier ?
Vous pouvez créer aussi bien des tâches récurrentes via des programmes cron que des tâches ponctuelles en utilisant la commande 'at'.
Puis-je l'utiliser avec Claude Desktop ?
Oui, vous pouvez configurer Claude Desktop en ajoutant le serveur à votre fichier claude_desktop_config.json et en fournissant votre CUEAPI_API_KEY.