cordum_list_jobsLABSCO SUMMARY
Fourteen tools only look; the seven that change things wait, by default, for a human to approve each call.
The discovery tools tell you what happened and what is pending. The mutating ones, such as cordum_create_workflow, cordum_install_pack and cordum_update_policy_bundle, return an approval id first and run only after someone approves in the dashboard or with cordumctl mcp approve. Every call lands in the per-tenant audit chain as an event, and cordum_audit_verify will tell you whether that chain has gaps — which is the point of pointing an assistant at it in the first place.
What it is
The MCP surface of Cordum, an agent control plane: read-only discovery tools over jobs, workflow runs, packs, topics, workers, agent identities, approvals and the audit chain, plus seven approval-gated tools that create workflows, install or remove packs, register agents and change policy.
What you get
- cordum_list_jobs and cordum_get_job — what ran, filtered by state or topic, and the full record for one job including its policy decision and retry history
- cordum_list_runs, cordum_get_run and cordum_run_timeline — workflow runs with graph state, and an ordered event timeline for tracing where one got stuck
- cordum_list_workflows, cordum_list_packs and cordum_list_topics — the definitions, installed integration packs, and registered job topics
- cordum_list_workers and cordum_list_agents — registered workers with capabilities and last-seen, plus configured agent identities with their allowed tools and risk tier
- cordum_list_pending_approvals — what is waiting on a human, defaulting to pending
- cordum_audit_query and cordum_audit_verify — search the audit chain, and walk the Merkle chain to report ok, compromised or partial
- cordum_status — one health snapshot of the platform components, queue depth and active workers
- List tools page at 50 by default and up to 500, returning an opaque cursor to resume
Requirements
A running Cordum stack — the quickstart script or docker compose brings up the gateway, scheduler, safety kernel and the rest — and a CORDUM_API_KEY. The MCP server runs standalone over stdio from cmd/cordum-mcp, or through the gateway at /mcp/message and /mcp/sse when mcp.enabled is true. Calls are tenant-scoped; cross-tenant queries on the audit tools are admin-only.
Setup effort
Build from source — git clone https://github.com/cordum-io/cordum.git
USE CASES
Finding out why a job failed
List jobs filtered to failed, then pull the one you care about with its policy decision and retry history attached.
Tracing a workflow run that stalled
Fetch the run's graph state, then read its event timeline to see which step it stopped on.
Clearing the approval queue
List what is pending with requester and expiry, so nothing quietly times out.
Proving the audit log has not been tampered with
Walk the tenant's Merkle chain and get back a verdict plus the count of verified events and any gaps.
21 tools
Listed in project docs. Your client may show a different list.
cordum_get_jobcordum_list_runscordum_get_runcordum_run_timelinecordum_list_workflowscordum_list_packscordum_list_topicscordum_list_workerscordum_list_agentscordum_list_pending_approvalscordum_audit_querycordum_audit_verifycordum_statuscordum_create_workflowcordum_install_packcordum_uninstall_packcordum_register_agentcordum_update_policy_bundlecordum_revoke_worker_sessioncordum_set_agent_scopeBEFORE YOU INSTALL
What to know first
Tools you get
21 tools named in the project's documentation.
Requires
- Go 1.26.3+
- CORDUM_API_KEY from the .env the quickstart writes
INSTALLATION
Connect your client
This one is built from source rather than installed with a single command.
Server setup
git clone https://github.com/cordum-io/cordum.git
cd cordumThe quickstart needs Docker Desktop v4+ (or Engine v20.10+ with Compose v2) with at least 4 GB RAM, Go 1.26.3+ and curl.
./tools/scripts/quickstart.shThe script brings up the whole stack with the gateway at http://localhost:8081, and writes a generated CORDUM_API_KEY to .env.
MCP Clients
Claude Desktop
Build the MCP server
Run this inside the cordum clone. go install puts the cordum-mcp binary in $(go env GOPATH)/bin, which needs to be on your PATH.
go install ./cmd/cordum-mcpAdd this to claude_desktop_config.json
<YOUR_CORDUM_API_KEY> is the CORDUM_API_KEY value from the .env file the quickstart wrote.
{
"mcpServers": {
"cordum": {
"command": "cordum-mcp",
"args": [
"--addr",
"http://localhost:8081"
],
"env": {
"CORDUM_API_KEY": "<YOUR_CORDUM_API_KEY>"
}
}
}
}Claude Code
Build the MCP server
Run this inside the cordum clone. go install puts the cordum-mcp binary in $(go env GOPATH)/bin, which needs to be on your PATH.
go install ./cmd/cordum-mcpRegister it with Claude Code
<YOUR_CORDUM_API_KEY> is the CORDUM_API_KEY value from .env.
claude mcp add cordum -e CORDUM_API_KEY=<YOUR_CORDUM_API_KEY> -- cordum-mcp --addr http://localhost:8081