entherium_get_task

Status: GA Access: token required API contract: 0.3.0 · capability 2026-09-03.1 View as Markdown Open in Claude Open in ChatGPT

READ one task in full by numeric task_id, INCLUDING its update log — every status change, reassignment, spec-retarget and note, in time order (who / what / when). Use it to check a task’s current state and history before acting on it. Returns the task fields plus activity: [{at, by, kind, verb, field, old, new, note}], or {“error”: “task not found”}. Needs the manage_task capability.

Access: read-only — safe to call repeatedly, changes nothing

Available at: /mcp/, /mcp/readonly/

Hints declared to MCP clients (ToolAnnotations)

Hint	Value
`readOnlyHint`	true
`destructiveHint`	false
`idempotentHint`	true
`openWorldHint`	false

Parameters

Name	Type	Required	Description
`task_id`	`integer`	yes	Numeric task id returned by create

Example call

Send inside an initialized MCP session (see Connecting). Every parameter is shown with a typed placeholder; drop the optional ones you do not need — but for defect/task tools the QA fields are what keeps a report out of quarantine.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "entherium_get_task",
    "arguments": {
      "task_id": 1
    }
  }
}

Returns

Field	Type	Description
`task_id`	`integer` (optional)	Task id on the board
`title`	`string` (optional)
`status`	`string` (optional)	Board status of the task
`assignee`	`string \| null` (optional)	Assignee display name, if any
`spec_ref`	`string \| null` (optional)	Feature id the task targets (opaque SPEC-NNN), if any
`description`	`string \| null` (optional)
`updated_at`	`string \| null` (optional)	ISO-8601 time of the last change
`note_count`	`integer` (optional)	Number of notes logged on the task (listing only)
`last_note_at`	`string \| null` (optional)	ISO-8601 time of the latest note (listing only)
`created_at`	`string \| null` (optional)	ISO-8601 creation time
`closed_at`	`string \| null` (optional)	ISO-8601 close time, if closed
`activity`	`array of object` (optional)	Full time-ordered change log of the task
`activity[].at`	`string \| null`	ISO-8601 time of the event
`activity[].by`	`string \| null`	Actor display name
`activity[].kind`	`string`	Event kind (status change, reassign, note, …)
`activity[].verb`	`string \| null`	Human verb for the event
`activity[].field`	`string \| null`	Field that changed, if any
`activity[].old`	`object`	Previous value, if any
`activity[].new`	`object`	New value, if any
`activity[].note`	`string \| null`	Note body for note events
`error`	`string` (optional)	Present only when the task could not be read

If it fails

Symptom	Cause	Action
`401`	Token missing/expired	Tokens are issued by the platform owner via `POST /api/v1/auth/agent-token` (superuser-only) — ask for a re-issue. ⚠️ A new token replaces your grant set
`403` / capability error	Your token lacks the capability or the contract grant	Check `my_capabilities` first; ask the owner for the grant