# 30. Fewer MCP tools: recent, todos and revert_text folded away

Date: 2026-10-25

## Status

Accepted

## Context

The MCP server offered fifteen tools. Models choose better among fewer, and three of them did
nothing another tool could not: `recent` listed pages by `updated_at` (what `search` does for a
query of filters alone), `todos` was one fixed search query with a sort, and `revert_text` was a
second undo beside `revert`.

## Decision

- `search` takes an empty `query`, which lists the most recently changed pages. `recent` is gone
  (`kind:K` replaces its `kind`).
- `todos` is gone. Its list is `search` with `kind:todo -is:done -is:cancelled -is:snoozed
  sort:due` (or `sort:priority`; the tool did exactly this).
- `revert_text` is `revert` with `page` and `to_rev` (and `rev`, `restore_title`,
  `allow_empty`). `revert` takes exactly one of `revision`, `batch` or `page` with `to_rev`. The
  text form is refused with `SCRAP_MCP_CONTENT_EDIT=0`, as `revert_text` was unlisted.
- `rename_tag` stays. It renames nested tags, refuses a name under the old one, needs `merge` to
  join two tags in use and counts trashed pages: none of that fits `edit_meta`'s add, remove and
  set of exact tags without overloading it.
- `/sc-session` is `/sc-summarise all`.

## Consequences

Twelve tools. Clients that allow or deny `mcp__scrap__recent`, `todos` or `revert_text` by name
need `search` and `revert` instead. Nothing is lost: every call maps to one of the new forms.