Cueport

cueport

cueport gives an MCP host or a terminal access to CueAPI, the coordination layer for agent work: schedule cues (recurring cron or one-time), fire them on demand, watch their executions, claim worker executions, keep a claim alive with heartbeats, and close the loop by reporting an outcome backed by evidence. One binary serves a command-line interface and a stdio MCP server.

An API key is required. Set CUEAPI_API_KEY to a key from your CueAPI account; every call sends it as Authorization: Bearer <key>, and a missing key fails before any request is attempted. Self-hosting or testing against another host? Set CUEAPI_BASE_URL alongside the key; when it is unset, calls go to https://api.cueapi.ai.

Install

npx @reneturcios/cueport list-cues

Or run the container image:

docker run -i ghcr.io/cloudcorprecords/cueport

The container defaults to the MCP server (see below). Pass CLI arguments to use it as a CLI instead.

CLI

cueport create-cue --name digest --schedule "0 9 * * *" --callback-url https://example.test/hookcueport list-cues --status active --limit 5cueport get-cue cue_abc123cueport fire-cue cue_abc123 --payload-override '{"topic":"release notes"}'cueport update-cue cue_abc123 --name "morning digest"cueport pause-cue cue_abc123cueport resume-cue cue_abc123cueport delete-cue cue_abc123cueport list-executions --cue-id cue_abc123 --status failedcueport get-execution exec_123cueport list-claimable --task digest --agent worker-acueport claim-execution exec_123 --worker-id worker-7cueport claim-next --task-name digest --worker-id worker-7cueport heartbeat exec_123 --worker-id worker-7cueport report-outcome exec_123 --outcome succeeded --external-id ext_42 --result-url https://example.test/result
cueport --version

Commands print the upstream JSON payload. Exit codes: 0 on success, 1 when a call fails (including a missing API key or an upstream API error), 2 for usage errors.

Two behaviours are worth knowing. Pausing and resuming are not separate endpoints: both are a PATCH /v1/cues/{id} carrying only a status field (paused or active). And claim-next is a fan-out, not a single call: the claim endpoint has no task filter, so the tool first fetches the server-side filtered claimable list, picks the oldest entry, and then claims that execution by id.

MCP server

One bin serves both faces. The mcp subcommand starts a stdio MCP server:

npx -y @reneturcios/cueport mcp

MCP client configuration:

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

Add CUEAPI_BASE_URL to the env block to point the server at a different CueAPI-compatible host.

Tools

Development

npm installnpm run build   # tsc -> dist/npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)npm run dev     # run the CLI from source via tsx

License

MIT — see LICENSE.