Skip to main content
Glama

MRVN DE Open Data MCP

tender_search_notices

Search/filter German public procurement notices by keyword, CPV, Bundesland, type, buyer, value, published date, or submission deadline. [German public procurement (oeffentlichevergabe.de, CC0)]

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
qNoKeywords (all must match)
toNo
cpvNoComma-separated CPV codes or prefixes
fromNo
landNoComma-separated Bundesland codes (BW,BY,…)
sortNo
typeNo
buyerNo
limitNo
fieldsNo
offsetNo
categoryNo
end_afterNoSubmission deadline on/after
max_valueNo
min_valueNo
end_beforeNoSubmission deadline on/before
postal_prefixNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.5/5.0
Behavior3/5

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

No annotations are provided, so the description carries the full burden. It discloses the upstream source and CC0 license status, which is real added context, and 'search' implies a read-only operation. However, it says nothing about rate limits, pagination behavior (offset/limit), or result size caps, which matter for a 17-parameter query tool.

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?

Two sentences, front-loaded with the verb and resource; no filler. The bracketed provenance/license note earns its place as context, though the facet enumeration mildly restates schema property names.

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

Completeness2/5

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

For a 17-parameter tool with no annotations, no output schema, and 29% schema coverage, the description is thin: it does not describe what a result looks like, does not explain the full/compact 'fields' choice or pagination via limit/offset, and leaves several filters (sort, category, postal_prefix) unexplained anywhere.

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 only 29%, so the description must compensate. It does map the ambiguous parameters usefully (value -> min_value/max_value, published date -> from/to, submission deadline -> end_after/end_before), which the schema leaves undocumented. It adds nothing for sort, limit, offset, fields, category, or postal_prefix, so the compensation is partial.

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?

States a specific verb (search/filter) plus the exact resource (German public procurement notices) and enumerates the filterable facets, which naturally distinguishes it from tender_get_notice (single-record retrieval) and tender_get_stats. An agent can identify its role without opening the schema.

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 facet list implies when the tool is useful (broad discovery of notices), but there is no explicit when-to-use/when-not guidance and no routing to siblings such as tender_get_notice for a known ID or tender_get_stats for aggregates. Usage is inferred rather than stated.

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.