Skip to main content
Glama

Check bid documents

check_bid_readiness
Read-only

Use this when the user wants to know what they're missing before bidding, for one tender or in general: registrations, certifications, insurance, policies and each country's own documents, such as Cyber Essentials in the UK, SAM.gov registration in the US or the DUME in France. A general check follows the user's home country. Returns what is held, missing or expiring. It gives readiness guidance, not legal advice. Not for Companies House look-ups or tax questions. Example: {"tender_reference":"003344-2026","documents_held":["cyber_essentials","iso_9001"]}

Input Schema

NameRequiredDescriptionDefault
sectorNoThe kind of work the company bids for, e.g. "construction", which changes the accreditations buyers expect.
countryNoThe country whose rules to check against, when the user names one, e.g. "Canada", "UK" or "Spain". Omit to use the user's home country. Each country has its own registrations, certificates and declarations, e.g. Central Digital Platform registration in the UK, the EEE in Germany or the Kbis in France.
documents_heldNoDocuments and certifications the user says they already have, e.g. ["cyber_essentials", "public_liability_insurance", "iso_9001"]. Add an expiry as "cyber_essentials:2026-11-30".
tender_referenceNoOptional tender to check against, e.g. "003344-2026". Omit for a general readiness check.

Output Schema

NameRequiredDescriptionDefault
foundNo
caveatNo
creditNo
tenderNoThe same facts as a search_tenders result.
coveredNo
summaryYes
checklistNo
nextStepsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.4/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true and destructiveHint=false, so safety is covered; the description still adds real context by disclosing the response shape (held/missing/expiring), the home-country fallback behavior, and the scope caveat 'readiness guidance, not legal advice'. It does not cover auth requirements or rate limits, so it stops short of a full 5.

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?

The trigger condition is front-loaded before the return description, exclusions and example. The first sentence is long and carries a list of country-specific examples that overlaps the schema's own country description, so it is slightly heavier than needed but still efficient.

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

Completeness5/5

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

With an output schema present and annotations covering the safety profile, the description only needs to supply the trigger, scope and routing caveats — all of which are present. Nothing an agent needs in order to select and invoke this tool correctly is missing.

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 description coverage is 100%, so all four parameters (including the sector enum and the country fallback rule) are already documented and the description largely restates them. Its country examples and the illustrative JSON add light invocation value, but not enough to exceed the baseline 3.

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

Purpose5/5

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

Specific verb+resource (check bid readiness for one tender or in general) with a stated output ('Returns what is held, missing or expiring'). It explicitly carves out what it is not for (Companies House look-ups, tax questions), which separates it from siblings like find_company and avoids collisions with the bid-drafting tools.

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

Usage Guidelines5/5

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

Opens with an explicit trigger ('Use this when the user wants to know what they're missing before bidding'), covers both modes (single tender vs general check) and states that a general check falls back to the home country. It also gives clear when-not guidance ('Not for Companies House look-ups or tax questions'), leaving little to inference.

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