Skip to main content
Glama

WATR Software Oracle — estándar de arquitectura por rule_id

list_domains

Mapa del corpus: dominios, temas y los rule_id de cada uno, con su stance.

Input Schema

NameRequiredDescriptionDefault

No arguments

Output Schema

NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are supplied, so the description carries the full burden of behavioral disclosure, and it only describes the payload's contents. It says nothing about read-only safety, corpus size, whether the full taxonomy is returned at once, or any auth/rate constraints. A single tool with zero annotations can be fully covered in one more clause, and this description doesn't do it.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single front-loaded clause with no filler, and the enumeration of returned entities is packed into one short sentence. The only structural weakness is that it is a noun phrase fragment with no leading verb, which makes it read as a label rather than an instruction.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is simple — no parameters, and an output schema exists — so the description doesn't need to explain return values, though it does anyway. What remains missing is positioning against the four sibling tools, which matters a lot for a zero-arg discovery tool that an agent must choose deliberately.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool takes zero parameters, so the schema already fully specifies the input surface and 100% coverage means there is nothing for the description to add. Baseline 4 is arguably earned, but the description also recasts the output fields (domains, topics, rule_id, stance) without adding syntactic meaning; a 3 reflects an adequate but non-contributing parameter story.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names the resource precisely: a map of the corpus covering domains, topics, each topic's rule_id, and stance. An agent can infer this is an index/overview listing rather than a fetch of a single rule. It stops short of an explicit verb (e.g., 'list') and never names the sibling it is not, so it doesn't reach a 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no when-to-use guidance at all — nothing says to call this first to discover valid rule_ids before calling get_rule, nor any exclusion against search_practices or review_code. The only implicit signal is that this tool takes no arguments, which slightly suggests an entry-point/browse call.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources