CueAPI MCP sunucusu
✓ DoğrulandıAI agent'larının tekrarlayan veya tek seferlik görevler planlamasına, yürütme geçmişini yönetmesine ve yapılandırılmış kanıtlarla sonuçları raporlamasına olanak tanır.
Ayrıca bilinen adı cueapi/cueapi-mcp, cueapi-mcp, @cueapi/mcp
- Yıldızlar
- 2
- Araçlar
- 15
- İndirmeler, 30 gün
- 282
- En son sürüm
- 0.1.3
- Son commit
- 3 Ağu 2026
- Lisans
- MIT
CueAPI MCP nedir?
CueAPI bir MCP sunucusudur. AI agent'larının tekrarlayan veya tek seferlik görevler planlamasına, yürütme geçmişini yönetmesine ve yapılandırılmış kanıtlarla sonuçları raporlamasına olanak tanır. 15 araç sunar; örneğin cueapi_create_cue, cueapi_list_cues, cueapi_get_cue.
Özet, projenin README dosyasından oluşturuldu
CueAPI MCP sunucusu hakkında
Bu sunucu, bir yapay zeka asistanı içerisinden tekrarlayan agent görevlerini planlamayı ve yürütme geçmişini yönetmeyi sağlar. Claude Desktop, Cursor veya Zed kullanan agent'lar için zamana ve farklı ortamlara yayılan işleri yönetebilecekleri bir koordinasyon katmanı sunar. Bu sunucuyu kullanarak bir agent, cron tabanlı veya tek seferlik programlar oluşturabilir, geçmiş çalıştırmaları takip edebilir ve tamamlanan sonuçları URL'ler veya harici ID'ler gibi yapılandırılmış kanıtlarla raporlayabilir.
Kullanıcılar, paketi npm üzerinden kurarak ve MCP host'larını bir CUEAPI_API_KEY ile yapılandırarak servise bağlanırlar. Kendi sunucusunda barındıranlar (self-hosting) için CUEAPI_BASE_URL de belirtilebilir. Araç seti, bir görevin tüm yaşam döngüsü için özel komutlar içerir; örneğin planlama için cueapi_create_cue, bekleyen işleri devralmak için cueapi_claim_execution ve tamamlanma kanıtı sunmak için cueapi_report_outcome. Bu sayede agent'lar karmaşık iş devirlerini yönetebilir ve sessiz hataların belgelenmiş sonuçlar aracılığıyla yakalanmasını sağlayabilir.
Neler yapabilirsiniz
- 1Tekrarlayan agent iş akışlarını planlayınBir agent, belirli bir webhook'a veri göndermek için günlük bir görev ayarlayabilir.
- 2Görev yürütme geçmişini izleyinBir geliştirici, asistanından planlanmış bir işin önceki çalıştırmalarını incelemesini isteyebilir.
- 3Bekleyen görevleri devralın ve işleyinBir AI agent, belirli görevleri yerine getirmek için mevcut çalışan yürütmelerini devralabilir.
- 4Tamamlanan işler için kanıt sununBir agent, başarı kanıtı olarak bir sonuç URL'si göndererek bir görev döngüsünü kapatabilir.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
CueAPI MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleCueAPI MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'CUEAPI_API_KEY=<YOUR_CUEAPI_API_KEY>' cueapi-mcp -- npx -y @cueapi/mcpCueAPI MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"cueapi-mcp": {
"command": "npx",
"args": [
"-y",
"@cueapi/mcp"
],
"env": {
"CUEAPI_API_KEY": "<YOUR_CUEAPI_API_KEY>"
}
}
}
}CueAPI MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"cueapi-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cueapi/mcp"
],
"env": {
"CUEAPI_API_KEY": "<YOUR_CUEAPI_API_KEY>"
}
}
}
}CueAPI MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"cueapi-mcp","type":"stdio","command":"npx","args":["-y","@cueapi/mcp"],"env":{"CUEAPI_API_KEY":"<YOUR_CUEAPI_API_KEY>"}}'CueAPI MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"cueapi-mcp": {
"command": "npx",
"args": [
"-y",
"@cueapi/mcp"
],
"env": {
"CUEAPI_API_KEY": "<YOUR_CUEAPI_API_KEY>"
}
}
}
}CueAPI MCP'yi Codex içine yükleyin
$ codex mcp add cueapi-mcp --env 'CUEAPI_API_KEY=<YOUR_CUEAPI_API_KEY>' -- npx -y @cueapi/mcpCueAPI MCP'yi Codex config.toml içine yükleyin
~/.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>"
CueAPI MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'CUEAPI_API_KEY=<YOUR_CUEAPI_API_KEY>' cueapi-mcp npx -- -y @cueapi/mcpCueAPI MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"cueapi-mcp": {
"command": "npx",
"args": [
"-y",
"@cueapi/mcp"
],
"env": {
"CUEAPI_API_KEY": "<YOUR_CUEAPI_API_KEY>"
}
}
}
}CueAPI MCP araçları 15
README dosyasından algılandıcueapi_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 | — |
15 aracın tümünü gösterDaha az araç göster
cueapi_claim_next_executioncueapi_execution_heartbeatcueapi_report_outcome
| cueapi_claim_next_execution | — | |
| cueapi_execution_heartbeat | — | |
| cueapi_report_outcome | — |
Yapılandırma
CUEAPI_API_KEYGerekliGizliCueAPI API key. Generate at https://cueapi.ai
CUEAPI_BASE_URLOverride the CueAPI base URL for self-hosted instances. Defaults to https://api.cueapi.ai
| Ad | Açıklama | Sunucu |
|---|---|---|
| CUEAPI_API_KEY | CueAPI API key. Generate at https://cueapi.ai | GerekliGizli |
| CUEAPI_BASE_URL | Override the CueAPI base URL for self-hosted instances. Defaults to https://api.cueapi.ai |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilircueapi/cueapi-mcp is public and reachablegithub.com/cueapi/cueapi-mcp ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyor@cueapi/mcp names cueapi/cueapi-mcp as sourcenpmjs.com/package/@cueapi/mcp ↗Geçti
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-08-03github.com/cueapi/cueapi-mcp ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from @cueapi/mcpGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok99 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok15 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişNo tool named like delete, drop or execGeçti
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
cueapi-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.
CueAPI MCP soruları
CueAPI MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'CUEAPI_API_KEY=<YOUR_CUEAPI_API_KEY>' cueapi-mcp -- npx -y @cueapi/mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
CueAPI MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
CueAPI MCP hangi araçları sunar?
15 araç sunar; bunlar arasında cueapi_create_cue, cueapi_list_cues, cueapi_get_cue, cueapi_fire_cue, cueapi_update_cue yer alır.
CueAPI MCP server nasıl kurulur?
npm install -g @cueapi/mcp komutuyla npm kullanarak global olarak kurabilir veya kurulum yapmadan npx -y @cueapi/mcp komutuyla çalıştırabilirsiniz.
Ne tür görevler planlayabilirim?
Cron zamanlamalarını kullanarak tekrarlayan görevler veya 'at' komutunu kullanarak tek seferlik görevler oluşturabilirsiniz.
Bunu Claude Desktop ile kullanabilir miyim?
Evet, sunucuyu claude_desktop_config.json dosyanıza ekleyerek ve CUEAPI_API_KEY bilginizi sağlayarak Claude Desktop'ı yapılandırabilirsiniz.