One tool registered. Strongest in shared experience, weakest in tool selection.
{ name: "contact_miriam_schwab" /* short, unique, verb-based */ }contact_miriam_schwab: message, user{ name: "contact_miriam_schwab", annotations: { untrustedContentHint: true } }contact_miriam_schwab: description instructs agent how to behave and which tool to prefer{
name: "contact_miriam_schwab",
// Metadata DESCRIBES the tool - it never addresses the agent reading it.
// Rewrite any name, description, title, or schema field description that
// instructs the agent (which tool to prefer, what to output, rules to
// ignore) so it states what the tool does and what it returns instead.
description: "Searches the catalog and returns matching items with prices."
}{
"name": "contact_miriam_schwab",
"description": "Send a message to Miriam Schwab. It arrives in her personal inbox and a human reads it. This cannot be unsent — confirm the exact wording with the user before calling. If the contact form is visible on the page, use prepare_contact_message instead and let the user press send.",
"inputSchema": {
"type": "object",
"required": [
"name",
"email",
"message"
],
"properties": {
"name": {
"type": "string",
"description": "Name of the person the message is from — not your name as an agent."
},
"email": {
"type": "string",
"description": "A real reply-to address for that person. Replies go here."
},
"subject": {
"type": "string",
"description": "Short subject line, e.g. \"speaking invite\"."
},
"message": {
"type": "string",
"description": "The message body, in plain text."
},
"agent": {
"type": "string",
"description": "Optional. Identify yourself, e.g. \"Claude\"."
}
}
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": true
}
}{ name: "contact_miriam_schwab" /* short, unique, verb-based */ }contact_miriam_schwab: message, user{ name: "contact_miriam_schwab", annotations: { untrustedContentHint: true } }contact_miriam_schwab: description instructs agent how to behave and which tool to prefer{
name: "contact_miriam_schwab",
// Metadata DESCRIBES the tool - it never addresses the agent reading it.
// Rewrite any name, description, title, or schema field description that
// instructs the agent (which tool to prefer, what to output, rules to
// ignore) so it states what the tool does and what it returns instead.
description: "Searches the catalog and returns matching items with prices."
}{}