add-tool-annotation

Add contextual annotations to tools within hypertool-mcp to enhance LLM usage. Provide user-specific guidance, best practices, and usage notes directly within tool descriptions for improved clarity and efficiency.

Instructions

Add contextual annotations to a tool in the current toolset to guide LLM usage. Annotations provide user-specific guidance, best practices, and usage notes that will be displayed with the tool's description. Example: {toolRef: {namespacedName: 'linear.create_issue'}, notes: [{name: 'team-selection', note: 'Always confirm team with user first'}]}

Input Schema

Name	Required	Description	Default
`notes`	Yes	Array of annotations to add to the tool. Each annotation has a name (identifier) and note (content).
`toolRef`	Yes	Reference to the tool (use namespacedName or refId). Use list-available-tools to find the correct reference.

Input Schema (JSON Schema)

{
  "additionalProperties": false,
  "properties": {
    "notes": {
      "description": "Array of annotations to add to the tool. Each annotation has a name (identifier) and note (content).",
      "items": {
        "additionalProperties": false,
        "properties": {
          "name": {
            "description": "Identifier for this annotation (e.g., 'usage-tips', 'team-conventions', 'common-pitfalls')",
            "maxLength": 50,
            "minLength": 2,
            "pattern": "^[a-z0-9-]+$",
            "type": "string"
          },
          "note": {
            "description": "The annotation content to help guide LLM usage. Be clear and specific.",
            "maxLength": 500,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "name",
          "note"
        ],
        "type": "object"
      },
      "maxItems": 20,
      "minItems": 1,
      "type": "array"
    },
    "toolRef": {
      "additionalProperties": false,
      "description": "Reference to the tool (use namespacedName or refId). Use list-available-tools to find the correct reference.",
      "oneOf": [
        {
          "required": [
            "namespacedName"
          ]
        },
        {
          "required": [
            "refId"
          ]
        }
      ],
      "properties": {
        "namespacedName": {
          "description": "Tool reference by namespaced name (e.g., 'linear.create_issue', 'git.status')",
          "type": "string"
        },
        "refId": {
          "description": "Tool reference by unique hash identifier (shown in list-available-tools output)",
          "type": "string"
        }
      },
      "type": "object"
    }
  },
  "required": [
    "toolRef",
    "notes"
  ],
  "type": "object"
}

hypertool-mcp