A tool as described to a caller, carrying everything a model needs to decide whether to call it.
Returned by McpToolExecutionService.listTools and by the discovery meta-tool.
search_toolsstringThe tool's unique snake_case name within its toolset, e.g. search_products.
stringHuman-readable title declared by the tool. The same value is copied onto
annotations.title.
stringWhat the tool does, written for an AI agent to read.
McpToolsetWhich Vendure API the tool works over: shop for the Shop API, admin for the Admin API.
McpToolBehaviorWhat the tool does to data: readonly only reads it, mutating changes it, and
destructive changes it and needs a confirmation round-trip before running.
ToolAnnotationsMCP annotations derived from behavior. readOnlyHint and idempotentHint are true for
a readonly tool. destructiveHint is true for a destructive tool.
McpJsonSchemaThe input schema a call must satisfy: the tool's declared schema plus, for a destructive
tool, the optional confirm field the registry injects.
Architecture reviews, custom plugin work, migrations, ongoing support. Get a hand from the team that builds Vendure.