Skip to main content
Glama

What AI implementation cost model computes

calculator_describe

The inputs this calculator takes (with units, ranges and defaults), the outputs it returns, and the assumptions and tables behind it.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. First observed

TDQS

A3.7/5.0
Behavior3/5

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

With no annotations, the description carries full burden. It transparently states what the tool returns at a high level (inputs, outputs, assumptions, tables) and it is safely implied to be non-mutating, but it does not explicitly say it performs no calculation or expose other behavioral traits such as read-only status or formatting of the description.

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

Conciseness5/5

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

One sentence, front-loaded with the subject, and every phrase contributes a distinct category of content. No redundancy or filler.

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

Completeness4/5

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

For a zero-parameter describe tool with no output schema, the description covers the essential content areas (inputs, outputs, assumptions, tables). It is slightly incomplete in not relating itself to calculate or clarifying that it is a read-only explanatory call, but the scope is simple enough that nothing critical is missing.

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?

There are zero parameters, so the schema fully documents the input surface and the baseline is 4. The description adds the content semantics of the tool without needing to document parameters.

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 identifies a clear verb (describe) and a specific resource (the calculator's inputs, outputs, assumptions, and tables). It is unambiguous that this is the informational companion to calculate, though it does not explicitly name that sibling or contrast itself with it.

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

Usage Guidelines3/5

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

The wording implies this tool should be used to inspect the calculator's model before or instead of running it, and the mention of inputs/outputs/assumptions gives a clear context. However, there is no explicit when-to-use or when-not-to-use statement, nor any named alternative.

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.

TDQS

A4.2/5.0
Disambiguation5/5

Each tool has a clearly distinct function: running the model, describing the model, explaining the enquiry flow, listing enquiry fields, and submitting an enquiry. While the calculator and enquiry tools share prefixes, their purposes do not overlap.

Naming Consistency3/5

Tool names are grouped by domain (calculator_*, enquiry_*) but the verb/noun ordering is inconsistent: calculate and submit_enquiry lead with verbs, while calculator_describe, enquiry_describe, and enquiry_fields lead with nouns. The naming is still readable and predictable enough.

Tool Count5/5

Five tools are well-scoped for a site offering a cost calculator and an enquiry submission flow. Each tool earns its place and there is no redundancy.

Completeness5/5

The tool surface fully covers the stated purpose: describe the calculator, run it, describe the enquiry flow, inspect the fields, and submit with a two-step consent/confirmation process. There are no obvious dead ends or missing operations for this domain.

Resources