MCP Tools Reference

Built-in tools

list_tasks

List project task instances, newest first.

Field	Type	Description
status	string (optional)	Filter: pending, running, success, failed, pending_approval, rejected
limit	integer (optional)	Max results, default 50, max 200
offset	integer (optional)	Pagination offset, default 0

get_task

Get details of one task, including params, result, error_message.

Field	Type	Description
task_id	string	Task instance UUID

list_agents

List all project agents. No input required.

list_workspaces

List all project workspaces. No input required.

list_project_statuses

List all project statuses with their field declarations and current values. Call before set_project_status.

set_project_status

Update field values on a status.

Field	Type	Description
status	string	Status name from list_project_statuses
values	object	Field name → new value mapping

{ "status": "pipeline", "values": { "current_stage": "embedding" } }

list_task_type_memories

List memories for a task type, newest first.

Field	Type	Description
task_type	string	Task type identifier or UUID
limit	integer (optional)	Page size, default 20, max 100
offset	integer (optional)	Offset, default 0

get_task_memories

Get memories for a single task run.

Field	Type	Description
task_id	string	Task instance UUID
limit	integer (optional)	Page size, default 20
offset	integer (optional)	Offset, default 0

okf_search

Search the project knowledge base.

Field	Type	Description
query	string	Search query
workspace_id	string (optional)	Knowledge-base workspace UUID

okf_lint

Run health checks on the knowledge base.

Field	Type	Description
workspace_id	string (optional)	Knowledge-base workspace UUID

Dynamic task tools

Every task type with Allow MCP enabled becomes a tool named after its identifier.

Returns:

Task 'my-task-20260821120000' created successfully.
task_id: 550e8400-...
status: pending

_meta: { task_id, task_name, status }