MCP Tool

`tasks_read`

Read tasks. Pass an `id` to fetch a single task, or omit it to list tasks (optionally filtered by `label`). Anonymous callers can't list, but can fetch a public task by ID.

Input schema

api_keystring

API key for authentication

idstring

Task ID — when set, returns that single task

labelstring

List filter: only tasks carrying this label

limitinteger

List size (1-100, default 20)

afterstring

List cursor (last item ID from the previous page)

Example call

tools/call params

{
  "name": "tasks_read",
  "arguments": {
    "api_key": "agt_…"
  }
}