Skip to main content
Glama

get_tender

Read-onlyIdempotent

[GET /v1/tenders/:id — $0.02] Full tender detail by id: buyer, CPVs, deadline, estimated value, all awards/lots with winners, plus provenance (source + TED url).

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
idYesnumeric id from search results
client_keyNoPrepaid credit balance key: when set, paid calls first try to debit this account instead of requiring a per-call proof.
payment_tokenNoPayment proof: dev mode → single-use token from POST /v1/dev-faucet; x402 mode → base64 payment payload (the PAYMENT-SIGNATURE / X-PAYMENT header value)

TDQS

A4.3/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, and destructiveHint=false, so the safety profile is covered. The description adds useful context beyond annotations: it is a paid call ($0.02) and it enumerates the provenance and award fields, giving agents a clear picture of the returned data without an output schema.

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?

A single front-loaded sentence packs endpoint, pricing, core function, and a detailed field list without redundant words. The HTTP verb and cost are placed at the very start for quick scanning.

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?

No output schema exists, but the description compensates by listing the major response groups (buyer, CPVs, deadline, value, awards/lots, winners, provenance source/TED URL). With parameters documented in the schema and safety covered by annotations, nothing essential is missing for an agent to invoke this tool correctly.

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 the schema fully documents id, client_key, and payment_token. The description only restates that the tool fetches 'by id' and does not deepen meaning beyond the schema, so the baseline of 3 is appropriate.

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?

The description opens with the endpoint and 'Full tender detail by id', then enumerates the payload (buyer, CPVs, deadline, estimated value, awards/lots, provenance). This clearly names a specific verb/resource and distinguishes it from sibling list/search tools like search_tenders and get_company_awards.

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

Usage Guidelines4/5

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

The phrase 'by id' makes the precondition explicit and implies this tool is for retrieving complete records once an identifier is known, rather than for discovery or search. It does not explicitly name alternatives or exclusion rules, so it lacks the full when-not-to guidance of a 5.

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.1/5.0
Disambiguation5/5

Each tool maps to a distinct resource or action: billing balance, credit purchase, company profile/awards/opportunities, tender search/detail, renewals, buyer history, and research brief. The only possible overlap is research versus raw query tools, but the descriptions clearly separate a high-level brief from raw rows.

Naming Consistency3/5

Most tools follow a readable get_<resource> pattern, but billing_get_balance, billing_purchase_credits, search_tenders, and research deviate with namespace prefixes, a different verb, and a bare noun. The naming is not chaotic, but the conventions are mixed.

Tool Count5/5

With 11 tools, the server is well-scoped for a procurement-intelligence API: search, detail views, company and buyer analytics, renewal signals, research, pricing, and billing support. Each tool has a clear place and there are no obvious redundant tools.

Completeness5/5

The tool set covers the full core workflow: search for tenders, get full tender detail, explore company and buyer profiles, retrieve opportunities and renewals, generate research briefs, and manage billing. Ids returned by searh feed into detail tools, and no exposed data type appears to be a dead end.

Resources