Skip to main content

MCPToolUIDescriptor

UI-facing tool projection used by the /mcp-configurations/available-sources picker. Drops the execution-internal transport field carried on the full wire-shape tool definition.

namestringrequired
descriptionstringrequired
tagsstring[]required
required_abilitiesstring[]required
input_schema objectrequired

The MCP inputSchema shape shipped to the LLM in tools/list.

typestringrequired

Possible values: [object]

propertiesobjectrequired
requiredstring[]
output_schemaobject
annotations objectrequired

MCP tool annotations. For catalog-derived tools these default from the HTTP method (GET/HEAD are read-only and idempotent, other verbs are treated as destructive) when not explicitly authored.

readOnlyHintboolean
destructiveHintboolean
idempotentHintboolean
openWorldHintboolean
titlestring

Human-readable display title for the tool, shown by MCP clients alongside the snake_case name.

MCPToolUIDescriptor
{
  "name": "string",
  "description": "string",
  "tags": [
    "string"
  ],
  "required_abilities": [
    "string"
  ],
  "input_schema": {
    "type": "object",
    "properties": {},
    "required": [
      "string"
    ]
  },
  "output_schema": {},
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": true,
    "idempotentHint": true,
    "openWorldHint": true,
    "title": "string"
  }
}