Skip to main content
Glama

settlement-engine

Describe this service

describe_agent
Destructive

FREE: actions, invariants S1–S10 and limits.

Input Schema

NameRequiredDescriptionDefault

No arguments

Output Schema

NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

C2.8/5.0
Behavior2/5

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

Annotations declare readOnlyHint=false, destructiveHint=true and openWorldHint=true, which is surprising for a describe tool; the description neither confirms nor explains this safety profile. It adds only the 'FREE' and content-scope hints, and says nothing about side effects or whether the call mutates state, so it does little work beyond the structured fields.

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

Conciseness3/5

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

It is certainly short, but it is a telegraphic noun phrase rather than a front-loaded sentence, and 'FREE:' plus the S1–S10 range reads as shorthand an outside agent may not decode. Brevity here borders on under-specification rather than efficient structure.

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?

Complexity is low (no parameters, an output schema exists so return values need no explanation), which limits what the description must cover. Still, it never states the tool describes the service itself, and it leaves the destructive/openWorld annotations unexplained for a call that appears to be pure introspection.

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

Parameters4/5

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

The tool takes zero parameters, so per the baseline the schema carries the full parameter burden and the description is not expected to add syntax details. No gap exists here.

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

Purpose3/5

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

The fragment 'actions, invariants S1–S10 and limits' does hint at what the tool returns — service metadata — but there is no verb and no statement that this is a self-description of the service. Compared with siblings like get_contract or period_status, the scope is only inferable from the name and title, not from the description itself.

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?

'FREE' implies the call costs nothing, which weakly encourages calling it, but there is no guidance on when to prefer this over siblings such as explain or get_contract, and no exclusions or prerequisites. An agent must guess its place in the workflow.

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.