> ## Documentation Index
> Fetch the complete documentation index at: https://docket.hypertext.studio/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP tools and resources

> The 25 tools, the docket:// resource scheme, the bootstrap prompts, and the scopes each one needs.

**25 tools**, a set of `docket://` resources, and 3 prompts. Each is named for what the caller is
trying to do.

## Tools

<AccordionGroup>
  <Accordion title="Reading: 5 tools" defaultOpen>
    | Tool         | Does                                                        |
    | ------------ | ----------------------------------------------------------- |
    | `workspaces` | Lists the workspaces you belong to. Usually the first call. |
    | `find`       | Searches the workspace and ranks the results.               |
    | `list_work`  | Lists rows matching exact criteria.                         |
    | `get`        | Returns one entity in full, by ID or by name.               |
    | `brief`      | Returns what needs you today.                               |

    `find` reads the same permission-filtered index the web app reads. That index updates a moment
    after a write.

    `list_work` filters on team, project, assignee, delegate, state, priority, label, cycle, due
    window, blocked-ness, and the triage queue. Pass a filter the chosen entity has no column for
    and the call **fails, naming the filters that entity does support**.

    `get` returns a task with its dependencies and subtasks, and lists the references you cannot
    see in `missing`.
  </Accordion>

  <Accordion title="Writing: 9 tools">
    | Tool            | Does                                                            |
    | --------------- | --------------------------------------------------------------- |
    | `capture`       | Creates a task from a sentence.                                 |
    | `organize`      | Applies a whole plan in one call. Re-runs create no duplicates. |
    | `update`        | Changes work you describe in words.                             |
    | `comment`       | Adds threaded discussion.                                       |
    | `report_status` | Posts an update. The verdict you set becomes the item's health. |
    | `link`          | Links Docket work to Docket work.                               |
    | `archive`       | Archives work.                                                  |
    | `plan_day`      | Creates the day's plan.                                         |
    | `undo`          | Reverses a change set.                                          |

    **Every write records an undoable change set.** Call `undo` once and Docket reverses forty
    edits.
  </Accordion>

  <Accordion title="Time and reflection: 2 tools">
    | Tool         | Does                                                       |
    | ------------ | ---------------------------------------------------------- |
    | `track`      | Records time against work. See [Time](/docs/guides/daily/time). |
    | `retrospect` | Returns a retrospective for a period.                      |
  </Accordion>

  <Accordion title="Repeating work and processes: 3 tools">
    | Tool               | Does                        |
    | ------------------ | --------------------------- |
    | `define_process`   | Defines a process.          |
    | `schedule_process` | Schedules a process to run. |
    | `repeat_task`      | Makes a task recur.         |
  </Accordion>

  <Accordion title="Agents, sessions, and connectors: 6 tools">
    | Tool                               | Does                                               |
    | ---------------------------------- | -------------------------------------------------- |
    | `run_agent`                        | Starts an agent session.                           |
    | `manage_session`                   | Approves, rejects, or redirects a running session. |
    | `link_external`                    | Links a GitHub or Linear item onto Docket work.    |
    | `acknowledge_directive`            | Acknowledges a directive.                          |
    | `pause_athena_assignment_trigger`  | Pauses a trigger on your Athena assignment.        |
    | `remove_athena_assignment_trigger` | Removes a trigger on your Athena assignment.       |
  </Accordion>
</AccordionGroup>

### Scopes per tool

| Scope             | Covers                                                                                                                                                                                                  |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `work:read`       | `workspaces`, `find`, `list_work`, `get`, `brief`, and every resource read                                                                                                                              |
| `work:write`      | `capture`, `organize`, `update`, `comment`, `report_status`, `link`, `archive`, `plan_day`, `undo`, `track`, `retrospect`, `acknowledge_directive`, `define_process`, `schedule_process`, `repeat_task` |
| `agents:run`      | `run_agent`, `manage_session`, `pause_athena_assignment_trigger`, `remove_athena_assignment_trigger`                                                                                                    |
| `connectors:link` | `link_external`                                                                                                                                                                                         |

See [Authentication](/docs/developers/authentication#scopes) for requesting and stepping up scopes.

## Resources

The same data, read as resources. An item you cannot see looks like one that does not exist.

| URI                      | Contents                                |
| ------------------------ | --------------------------------------- |
| `docket://orgs`          | Every workspace you belong to           |
| `docket://hub/today`     | Your daily plan                         |
| `docket://hub/inbox`     | What needs a response                   |
| `docket://hub/directive` | The current scheduling directive        |
| `docket://hub/portfolio` | Every workspace's programs and projects |

Everything else is templated:

```
docket://{org}/{type}/{id}
```

Where `type` is one of `task`, `project`, `program`, `initiative`, `cycle`, `team`, `update`,
`comment`, `session`, `agent`, `view`, or `org`.

### Subscriptions

Call `resources/subscribe`, then open the `GET /mcp` stream and Docket sends
`notifications/resources/updated`. Delivery is best-effort and never replayed. Read the resource
again when one arrives.

## Prompts

| Prompt          | Purpose                  |
| --------------- | ------------------------ |
| `docket_system` | The Docket system prompt |
| `task_brief`    | A brief on one task      |
| `standup`       | A standup summary        |

## Widgets

Hosts that render MCP Apps get UI resources under `ui://docket/*` for every entity type, plus work
lists, plans, and change reports. Other hosts get the structured results.

## Server capabilities

`tools.listChanged`, `resources.subscribe`, `resources.listChanged`, `prompts.listChanged`,
`completions`, and `logging`. A deployment flag turns on experimental MCP task support.

<Note>
  `tools/list` returns only the tools **your** grants allow. Change one and Docket sends
  `notifications/tools/list_changed` immediately.
</Note>