Skip to main content
Glama

Upcoming public inquiries

upcoming_public_inquiries
Read-onlyIdempotent

Traffic Commissioner public inquiries listed for companies (date, time, venue, legal grounds and the official notice), from the weekly Applications and Decisions and Notices and Proceedings, optionally for one traffic area. Inquiries for sole traders and partnerships are counted, not named. Being called to an inquiry is not a finding against the operator.

Input Schema

NameRequiredDescriptionDefault
areaNoTraffic area: slug (e.g. 'scotland', 'north-west-of-england'), letter (B, C, D, F, G, H, K, M) or name

Output Schema

NameRequiredDescriptionDefault
dataYes
sourceYesData source(s) the result is built from
licenceYesLicence of the source data
file_dateYesDate of the DVSA operator licence file the data describes (null before the first import)
source_urlYesWhere the primary source dataset is published
attributionYesAttribution text to show with the data
markdown_urlYesMarkdown version of the canonical page
retrieved_atYesWhen this response was generated (ISO timestamp)
canonical_urlYesThe human-readable HaulierScope page for this result

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.5/5.0
Behavior4/5

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

Annotations already cover the safety profile (readOnly, idempotent, non-destructive, closed-world), but the description adds genuinely non-obvious behavior: sole traders and partnerships are counted rather than named, and being called to an inquiry is not a finding against the operator. Those are interpretive facts the schema and annotations cannot convey.

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

Conciseness4/5

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

Three sentences, each front-loaded and purposeful: what is listed, the scope modifier, then two caveats. Nothing is padded, though the returned-field enumeration is partly redundant given the output schema exists.

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?

With an output schema present, return values need not be spelled out, and the description still covers source, scope, and important interpretation caveats. It is complete enough for correct invocation; only the missing relationship to tc_decisions leaves a small gap.

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?

Schema coverage is 100% and the single 'area' parameter is fully documented in the schema, including accepted forms. The description only restates that area is optional ('optionally for one traffic area') without adding syntax or constraint detail, so the baseline 3 applies.

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 names a specific resource (Traffic Commissioner public inquiries) with an explicit verb sense ('listed for companies'), and enumerates the fields returned (date, time, venue, legal grounds, official notice) plus the source publications. It is clear what the tool does, but it never distinguishes itself from the adjacent sibling tc_decisions, which an agent could plausibly confuse with this.

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?

There is no explicit when-to-use or when-not-to-use guidance, and no sibling is named as an alternative. The only usage signal is 'optionally for one traffic area', which is a scoping detail rather than routing guidance, so the agent must infer when this beats tc_decisions or search.

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