url_consulta_json

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

No annotations are provided, so the description must carry behavioral disclosure alone. It does disclose the transformation (adding formato=json) and a meaningful constraint (the result is not embedded in the QR), but it is silent on whether a network request to AEAT is actually made, what is returned, or any auth requirement, leaving ambiguity for a service-querying 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?

A single sentence with the action front-loaded ('Añade formato=json a una URL...'), and the parenthetical constraint earns its place by preventing misuse. Nothing is padded.

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?

For a one-parameter tool with no output schema and no annotations, the description covers purpose and transformation but omits what the call returns (a modified URL vs. service data) and expected input format. Adequate but with clear gaps given structured fields carry none of the load.

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?

There is one parameter (url_qr) at 0% schema description coverage. The description identifies the input as 'una URL de QR', which matches the field name and adds a little meaning, but gives no format, encoding, or validation guidance for that string.

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?

States a concrete action on a concrete resource: it appends 'formato=json' to a QR URL so the AEAT service is queried in JSON. This goes beyond restating the name. It does not, however, explicitly name or contrast itself with siblings like verifactu_qr_url, so the agent must infer the split from the trailing parenthetical.

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?

Usage is only implied: the note '(no va dentro del QR)' tells the agent that the modified URL is for querying the service rather than for embedding in the QR, which hints at when to reach for this versus the QR-generating sibling. There is no explicit when-to-use/when-not statement or named alternative, so it stays at the implied level.

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