MCP Tools
Keyoku exposes 31 tools over MCP. Your coding agent calls them directly — you mostly just ask for things in plain language and the agent picks the right tool.
Activity & observation
The trace that everything else is mined from.
| Tool | Description |
|---|---|
activity_record | Record an activity event manually (type: manual) |
activity_list | List recent events from ~/.keyoku/activity.jsonl |
observation_list | List observations the harness has collected |
Patterns & workflows
Mine repeated sequences and turn them into templates.
| Tool | Description |
|---|---|
workflow_suggest | Mine the trace for repeated 2–6 step patterns and propose drafts |
pattern_list | List detected patterns |
workflow_list | List workflows |
workflow_approve | Save a draft as a template (slug, name, description, steps) |
workflow_template_list | List saved workflow templates |
workflow_template_delete | Delete a workflow template |
Execution
Run templates and resume paused steps.
| Tool | Description |
|---|---|
workflow_execute | Run a template; state persists step-by-step to ~/.keyoku/executions.json |
execution_complete | Resume a paused step with { id, step_index, result } — in-order completion enforced |
execution_list | Show execution history |
Goals
Convergence mode: machine-checkable definitions of done.
| Tool | Description |
|---|---|
goal_create | Create a goal with criteria (command / http / mcp probes + assertions) |
goal_list | List goals |
goal_get | Fetch a single goal |
goal_update | Update a goal |
goal_delete | Delete a goal |
goal_assess | Re-check a goal's criteria and report which pass |
goal_record | Record progress against a goal |
Harness
Learning and status for the harness itself.
| Tool | Description |
|---|---|
harness_learn | Mine patterns from traces toward goal convergence |
harness_status | Report the harness's current status |
Connectors
External MCP servers and OpenAPI-backed services.
| Tool | Description |
|---|---|
connector_add | Register a connector — stdio, HTTP, or synthesized from an OpenAPI spec |
connector_list | List registered connectors |
connector_remove | Remove a connector |
connector_tools | List the tools a connector exposes |
connector_call | Call a connector tool, gated by its autonomy level |
connector_set_autonomy | Set a connector's autonomy: observe, suggest, approve, or autonomous |
Approvals & audit
The human decision queue and the append-only record.
| Tool | Description |
|---|---|
approval_list | List pending approval requests |
approval_approve | Approve a queued request |
approval_deny | Deny a queued request |
audit_list | Read the append-only audit trail |
Related
- Workflows — step types and execution semantics
- Connectors — autonomy levels and the approval queue
- CLI — the command-line counterparts