Skip to main content
Glama

UK property & area data

UK Postcodes: Validate postcode

uk-postcodes__validate
Read-onlyIdempotent

Whether a string is a valid, live UK postcode. Free within the daily allowance, then $0.001 USDC per call via x402.

Input Schema

NameRequiredDescriptionDefault
postcodeYesUK postcode

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.8/5.0
Behavior4/5

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

Annotations already declare readOnly, idempotent, openWorld, and non-destructive, so the safety profile is covered. The description adds genuinely non-obvious behavior: the tool checks 'live' postcode data (not just syntax) and has an explicit pricing/allowance model. It omits whether input is normalized or trimmed, but the pricing disclosure is real value beyond the annotations.

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?

Two tight sentences: the semantic meaning ('valid, live') is front-loaded, and the cost model follows. Nothing extraneous.

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 single-parameter, boolean-style validation tool with an output schema present, the description covers purpose, semantics ('live'), and cost. Return values need not be explained since an output schema exists. Minor gap: no statement about input normalization or expected postcode format.

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?

One parameter with 100% schema description coverage, so the schema already documents it. The description adds only 'a string' as the input type, which is a marginal restatement of the schema's `type: string`. Baseline 3 is appropriate.

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?

States a specific check (validity of a UK postcode string) with the added qualifier 'live', which distinguishes it from a pure format check. It is clearly distinguishable from lookup/autocomplete siblings by implication, though no sibling is named explicitly.

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?

Usage is implied: this is the pre-flight check you run before feeding a postcode to lookup, reverse, or nearest. The cost condition ('free within the daily allowance, then $0.001 USDC') gives practical context for when to call. However, no alternative is named and no when-not guidance is given (e.g., 'use lookup if you also need location data').

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