2 tools registered. Strongest in shared experience, weakest in trust.
{ name: "nopaque-find-api-endpoint" /* short, unique, verb-based */ }nopaque-find-api-endpoint: Description instructs agent to use this tool for specific questions{
name: "nopaque-find-api-endpoint",
// 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": "nopaque-find-api-endpoint",
"description": "Search the Nopaque TotalPath REST API documentation for the endpoint that performs a given task. Returns the matching endpoints with their HTTP method, path, what they do, and a link to the full reference including Python, TypeScript and cURL examples. Use this to answer \"which endpoint do I call to ...\". Read-only: it searches published documentation and does not call the API.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "What you are trying to do, in plain words — for example \"create a mapping job\", \"list test runs\", \"upload audio\", \"schedule a recurring test\"."
}
},
"required": [
"query"
]
},
"annotations": {}
}obstruction: weaknopaque-get-pricing: declares no required list, so an agent cannot tell which parameters are mandatory{
name: "nopaque-get-pricing",
inputSchema: {
type: "object",
properties: {
query: { type: "string", description: "What to search for" }
},
required: ["query"]
}
}{ name: "nopaque-find-api-endpoint" /* short, unique, verb-based */ }nopaque-find-api-endpoint: Description instructs agent to use this tool for specific questions{
name: "nopaque-find-api-endpoint",
// 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."
}{
"query": "authenticate"
}{}{}