Skip to content

[MCP] Add tool annotations for read-only and destructive tools #552

Description

@manoahLinks

Summary

No tool in the ListTools response carries MCP annotations, so clients cannot tell that mindvault_browse is read-only while mindvault_reset destroys local state.

Scope

  • Keep the implementation aligned with the existing MindVault architecture.
  • Add or update automated tests.
  • Update docs when the change affects contributors, deployers, or agent users.

Acceptance criteria

  • Every tool declares appropriate readOnlyHint, destructiveHint, and idempotentHint annotations plus a human-readable title.
  • A test asserts each registered tool has annotations and that read-only tools are not marked destructive.
  • Failure cases are deterministic and safe to show in issue-driven contributor work.
  • Relevant local tests pass.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area: mcpMCP server for AI agents (mcp/)difficulty: easySmall, low-risk change; little context requiredtype: featureNew functionality or capability

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions