# Weget MCP tool guide

## Scopes

| Scope | Allows |
| --- | --- |
| `mcp:read` | Overview, focus, tasks, activity, non-private notes, folders, and projects |
| `mcp:write` | Create and update tasks, notes, folders, projects, and task documents |
| `mcp:private` | Include, read, create, or edit private notes |
| `mcp:finish` | Start and update verified Finish Mode; also requires `mcp:write` |

The normal `api` scope is separate. An MCP-only key cannot call arbitrary REST endpoints.

## Context and retrieval

- `weget_workspace_overview`: preferred first call for a coherent snapshot.
- `weget_get_focus`: approvals, overdue work, active Finish Mode, and next actions.
- `weget_search_notes`: semantic retrieval across notes.
- `weget_list_notes`: folder, tag, text, and archive filters.
- `weget_get_note`: full note content.
- `weget_list_note_folders`: folder tree and note counts.

## Projects

- `weget_list_projects`: project progress, linked work, and next action.
- `weget_resolve_project`: automatic or suggested project match for free-form text.
- `weget_create_project`: main project note, folder, and optional weekly pulse.

## Tasks

- `weget_list_tasks`, `weget_get_task`: current state.
- `weget_create_task`: explicit or inferred task with source and project links.
- `weget_update_task`: status, deadline, follow-up, priority, and links.
- `weget_get_task_activity`: audit trail.
- `weget_cancel_task`: destructive; confirm first.
- `weget_create_task_artifact`: linked note, checklist, brief, or report.

## Finish Mode

- `weget_start_finish_mode`: outcome, definition of done, and autonomy policy.
- `weget_update_finish_mode`: progress, evidence, pause, failure, or approval request.
- `weget_complete_finish_mode`: final result, evidence, and artifact references.

Use `expected_version` from the latest task response to prevent two agents from silently overwriting each other's progress.