x402-xml-validate
XML Validate: XML Validate
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| xml | No | Xml to process | |
| text | No | Text to process | |
| input | No | Input to process |
XML Validate: XML Validate
| Name | Required | Description | Default |
|---|---|---|---|
| xml | No | Xml to process | |
| text | No | Text to process | |
| input | No | Input to process |
Changes observed during successful MCP inspections.
Input schema / properties / textAdded value: +{
+ "description": "Text to process",
+ "type": "string"
+}Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden, and it discloses nothing: not whether the tool throws or returns a boolean on invalid XML, not whether network access occurs for schema resolution, not what errors look like. A single tautological phrase is all the agent gets for a validation tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Very short, but for the wrong reason: the two halves are a verbatim duplication of each other and carry no information. Brevity here reflects under-specification rather than efficient front-loading.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no annotations, no output schema, and three ambiguous input parameters, the description should explain validation semantics and result shape. It supplies none of that, leaving the tool effectively uncallable with confidence.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Three parameters (xml, text, input) are described only as "Xml to process", "Text to process", "Input to process" — interchangeable filler that gives no basis for choosing among them. Although schema description coverage is nominally 100%, the descriptions are effectively content-free, so the schema is not doing the heavy lifting the coverage number implies, and the description adds nothing to disambiguate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
"XML Validate: XML Validate" merely restates the tool name in title form. It does not say what is being validated (well-formedness? schema? DTD?), what a result looks like, or how it differs from siblings like x402-xml-pretty, x402-xml-json, or x402-schema-validate.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No when-to-use guidance, no prerequisites, no mention of alternatives. Given a family of adjacent XML/validation tools (x402-xml-convert, x402-xml-path, x402-validate), the agent is left to guess which one applies.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.