7 tools registered. Strongest in shared experience, weakest in task completion.
{ name: "what_is_atlan" /* short, unique, verb-based */ }what_is_atlan: Description instructs on output format; list_atlan_products: Description instructs on output format; list_customer_stories: Description instructs on output format; get_atlan_resources: Description instructs on output format{
name: "what_is_atlan",
// 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": "what_is_atlan",
"description": "Explain what Atlan is and does: the Context Layer for AI, the Enterprise Data Graph, who uses it, and where to learn more. No input. Returns a short plain-text explanation with canonical URLs.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {}
}list_customer_stories: declares no required list, so an agent cannot tell which parameters are mandatory{
name: "list_customer_stories",
inputSchema: {
type: "object",
properties: {
query: { type: "string", description: "What to search for" }
},
required: ["query"]
}
}{ name: "what_is_atlan" /* short, unique, verb-based */ }list_atlan_products, list_customer_stories, get_atlan_resources{
name: "list_atlan_products",
// Declare readOnlyHint: true on tools that truly have no side effects -
// that is the claim that lets an agent relax confirmation on reads.
// (false is the default, so declaring it adds no information.)
annotations: { readOnlyHint: true }
}fill_lead_form: user, email{ name: "fill_lead_form", annotations: { untrustedContentHint: true } }what_is_atlan: Description instructs on output format; list_atlan_products: Description instructs on output format; list_customer_stories: Description instructs on output format; get_atlan_resources: Description instructs on output format{
name: "what_is_atlan",
// 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."
}{}{}{}