Skip to content

[codex] Add conservative MCP tool safety annotations - #84

Open
farvend wants to merge 3 commits into
fosdickio:mainfrom
farvend:codex/feat-tool-annotations
Open

[codex] Add conservative MCP tool safety annotations#84
farvend wants to merge 3 commits into
fosdickio:mainfrom
farvend:codex/feat-tool-annotations

Conversation

@farvend

@farvend farvend commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

What changed

  • Add MCP annotations to every TypeScript bridge tool.
  • Classify inspection tools as read-only.
  • Keep only select_binary and make_function_at non-destructive.
  • Mark operations that may overwrite or delete analysis state as destructive.
  • Add an integration test that rejects missing or incorrectly grouped annotations.

Why

Clients had no structured way to distinguish inspection, additive changes, and destructive analysis mutations.

Impact

MCP clients can present more accurate confirmation and safety UI. These remain protocol hints, not authorization controls.

Validation

  • npm run build
  • npm run test:annotations (54 tools)

@farvend
farvend marked this pull request as ready for review August 26, 2026 10:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant