Skip to main content
Glama

tenderapi-mcp

by io.github.IDNSIDNS

Server Details

MCP server for French (BOAMP) + EU (TED) public procurement data via TenderAPI.

If you are the author of this connector, you can claim ownership with GitHub, an HTTP challenge, or a DNS record. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Last Tested
Transport
Streamable HTTP
URL
Repository
IDNSIDNS/tenderapi-mcp
GitHub Stars
0
Server Listing
tenderapi-mcp

Available Tools

3 tools
get_tenderA
Read-onlyIdempotent
Inspect

Récupère la fiche complète d'un appel d'offres par son identifiant.

À utiliser après `search_tenders` pour obtenir le détail d'un avis
(description intégrale, documents, contacts, champs bruts).

Les avis BOAMP les plus succincts n'ont ni description ni CPV : `source_url`
renvoie alors vers l'avis d'origine.

Accès anonyme et gratuit, limité à 30 appels par jour et par IP ; la réponse
indique le solde restant dans sa clé `quota`.
ParametersJSON Schema
NameRequiredDescriptionDefault
tender_idYesL'entier du champ `id` renvoyé par search_tenders, ex. '3780679'. Ni le `source_id` (« 26-79926 »), ni l'URL de l'avis.

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

A4.7/5.0
Behavior5/5

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

Annotations already declare readOnlyHint=true, idempotentHint=true, and destructiveHint=false, so safety is covered. The description adds genuinely valuable behavioral context beyond annotations: anonymous access, a 30-calls-per-day-per-IP limit, that the response includes a `quota` key, and that some notices lack description/CPV with `source_url` as fallback. No contradictions with 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?

The description is concise at four sentences, each earning its place: purpose, usage context, edge case, and rate-limit disclosure. It is front-loaded with the main action and avoids redundant phrasing.

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?

The description fully covers the tool's role in the workflow, limitations, quota information, and edge cases. Since an output schema exists, return values do not need to be described. The combination of annotations, schema, and description leaves no significant gaps for an agent to select and invoke the 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% – the schema already thoroughly explains `tender_id` (the `id` field from search_tenders, excluding `source_id` and URL). The tool description does not add extra parameter meaning, so with high coverage, the baseline score 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 a specific verb and resource: 'Récupère la fiche complète d'un appel d'offres par son identifiant' (retrieves the complete record of a call for tenders by its identifier). It also distinguishes from the sibling tool by stating it is used 'après search_tenders' to obtain the detail, making the purpose unambiguous.

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?

Explicit usage guidance is provided: 'À utiliser après search_tenders pour obtenir le détail' tells the agent exactly when to invoke this tool and its relationship to the search tool. It also clarifies an edge case (BOAMP notices without description/CPV) and mentions the rate limit, giving complete context for invocation.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

preview_alertsA
Read-onlyIdempotent
Inspect

Montre ce qu'une veille automatique AURAIT livré avec ces critères, sans rien créer.

À utiliser quand quelqu'un veut « être prévenu » des marchés qui le concernent,
plutôt que de chercher une fois. `search_tenders` répond à « qu'y a-t-il
aujourd'hui » ; cet outil répond à « qu'est-ce que je recevrais, et à quel
rythme », ce qui est la vraie question de quelqu'un qui envisage de s'abonner.

RIEN N'EST ENREGISTRÉ, aucune alerte n'est envoyée, aucun compte n'est créé.
C'est une simulation en lecture seule, utilisable sans clé.

COMMENT S'EN SERVIR, dans cet ordre :
1. Composez les critères à partir du besoin exprimé, puis appelez cet outil.
2. Présentez `last_30d` (le rythme réel) et `sample` (ce que ça donne concrètement).
   Ne présentez pas `count` seul : c'est un stock d'avis ouverts, pas un débit.
3. LISEZ `per_criterion` AVANT de conclure. Il dit ce que chaque filtre retire.
   Un critère qui divise le résultat par trois est presque toujours une erreur de
   cadrage, pas une intention — c'est le défaut le plus fréquent des veilles, et
   il est invisible sans ce chiffre. Proposez la correction, puis re-testez.
4. Si le rythme est nul ou dérisoire, élargissez et rappelez l'outil. Deux ou trois
   itérations valent mieux qu'un profil enregistré au jugé.

POUR RECEVOIR CES ALERTES POUR DE VRAI, l'utilisateur doit avoir un compte : une
clé gratuite s'obtient en 30 secondes sur https://tenderapi.fr/?via=mcp et donne l'accès
API. La livraison automatique (email, Teams ou webhook) demande un palier payant à
partir de 5 €/mois, parce qu'un profil de veille tourne en continu côté serveur.
Dites-le tel quel, sans insister : le chiffre du point 2 argumente tout seul s'il
est bon, et s'il est mauvais mieux vaut le dire que vendre.

Accès anonyme et gratuit, limité à 30 appels par jour et par IP ; la réponse
indique le solde restant dans sa clé `quota`.
ParametersJSON Schema
NameRequiredDescriptionDefault
siretNoSIRET d'un acheteur précis, pour ne suivre que lui.
countryNoCodes pays ISO à 2 lettres, ex. ['FR']. Seul critère géographique qui porte sur les DEUX sources (BOAMP et TED).
regionsNoRégions françaises, ex. ['bretagne', 'ile-de-france']. Les formes usuelles (« Bretagne », « Île-de-France », « PACA ») sont normalisées, et une région inconnue est refusée avec une suggestion — elle ne rend jamais zéro en silence. ⚠️ Les régions n'existent que sur le BOAMP : un profil qui n'a que des régions ne verra aucun avis européen (TED).
keywordsNoMots-clés. Chaque entrée exige que TOUS ses mots soient présents dans le même avis. Préférez plusieurs entrées courtes à une longue.
cpv_codesNoCodes CPV exacts à 8 chiffres. ⚠️ Environ 40 % des avis BOAMP arrivent SANS aucun CPV : un CPV combiné en ET avec un mot-clé écarte silencieusement ces avis-là. `per_criterion` chiffre exactement ce que ça coûte — regardez-le.
budget_maxNoMontant maximum en euros.
budget_minNoMontant minimum en euros.
departmentsNoNuméros de départements, ex. ['75', '06', '2A']. Le nom écrit en toutes lettres est refusé.
match_cpv_familyNoÉlargit les codes CPV à leur famille (2 premiers chiffres) au lieu du code exact.

Output Schema

ParametersJSON Schema
NameRequiredDescription
countNoAvis actuellement ouverts correspondant à ces critères.
quotaNoSolde du palier anonyme : {restant, plafond}.
sampleNoTitres des 5 premiers avis correspondants — de quoi montrer concrètement ce qui arriverait.
last_7dNoArrivés dans les 7 derniers jours.
last_24hNoParmi eux, ceux arrivés en 24 h : ce que le prochain envoi quotidien contiendrait.
last_30dNoArrivés dans les 30 derniers jours. C'EST LE CHIFFRE À PRÉSENTER : le meilleur estimateur du rythme d'alertes. `count` mesure un stock, pas un rythme — un profil peut porter des centaines d'avis ouverts et ne rien livrer pendant des jours.
per_criterionNoCe que CHAQUE critère coûte, mesuré en le retirant seul. Les critères se combinent en ET, donc chacun ne fait que rétrécir. `count_without` et `last_30d_without` disent ce que le profil rendrait sans ce critère-là. Un écart énorme signale un filtre trop serré — c'est la lecture la plus utile de cet outil. Vide si le profil n'a qu'un seul critère.

TDQS

A4.6/5.0
Behavior5/5

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

Annotations (readOnlyHint=true, destructivetint=false, idempotentHint=true, openWorldHint=true) already cover the safety profile, and the description reinforces without contradicting ('RIEN N'EST ENREGISTRÉ', 'simulation en lecture seule, utilisable sans clé'). It adds genuine context beyond annotations: 30 calls/day/IP rate limit, quota key in the response, non-side-effect confirmation, and the BOAMP/TED source caveat for regions.

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 description is longer than typical, but it is front-loaded with purpose and organized into clear sections (purpose, when-to-use, safety, numbered usage steps, pricing, access limits). Every section earns its place, though the nested operational instructions are somewhat verbose and could be tightened.

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?

For a 9-parameter simulation tool with an output schema, the description is complete: purpose, sibling differentiation, behavioral scope, result-interpretation guidance (present last_30d and sample, not count alone; read per_criterion), iteration advice, account/pricing context, and rate limits. Nothing an agent needs to invoke and present results 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% with already-rich parameter descriptions (e.g., the CPV 40%-sans-CPV caveat, region normalization behavior), so the schema carries the heavy lifting. The description itself adds no parameter-level detail — it references output fields (last_30d, sample, count, per_criterion) rather than input semantics. Baseline 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 opening sentence states a specific verb and resource: 'Montre ce qu'une veille automatique AURAIT livré avec ces critères, sans rien crér' — a preview/simulation of alert results. It explicitly differentiates from the sibling search_tenders ('qu'y a-t-il aujourd'hui' vs. 'qu'est-ce que je recevrais'), so an agent can route correctly without opening schemas.

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?

Provides explicit when-to-use context ('À utilisr quand quelqu'un veut « être prévenu »... plutôt que de chercher une fois'), naes the alternative (search_tenders) and the condition that selects it, and gives a 4-step numbered workflow including when to retest with broader criteria. Nothing is left to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_tendersA
Read-onlyIdempotent
Inspect

Recherche des appels d'offres publics français (BOAMP) et européens (TED).

Environ 3 millions d'avis, mis à jour plusieurs fois par jour. Accès anonyme et
gratuit, limité à 30 appels par jour et par IP ; chaque réponse indique le solde
restant dans sa clé `quota`.

Cinq pièges, tous rencontrés en production :
1. Filtrez toujours. Sans aucun filtre la recherche porte sur tout le stock depuis
   2015, avis clos compris. Posez au minimum un `keyword`, un `cpv_family`,
   un `country` ou un `status`.
2. `keyword` cherche une sous-chaîne et exige que TOUS les mots soient présents
   dans le même avis. « défibrillateur cabinet » ne rend rien ; cherchez un seul
   mot, puis affinez.
3. Le mot-clé balaie le titre ET la description, noms d'acheteurs compris. Un terme
   métier qui est aussi un toponyme sur-capte donc beaucoup : « littoral » remonte
   une maintenance de portes au « GHT Somme Littoral Sud ». Quand un mot est ambigu,
   préférez un code CPV, ou une expression que ne peut pas porter un nom de lieu.
4. Les avis TED sont indexés dans leur langue de publication : pour couvrir un
   marché européen, interrogez le terme dans chaque langue utile, ou passez par
   le code CPV, qui lui est indépendant de la langue.
5. Environ 40 % des avis BOAMP arrivent sans aucun code CPV : un filtre CPV seul
   les laisse de côté. Croisez avec `keyword` quand la couverture compte.

Chaque paramètre est décrit dans le schéma d'entrée ; les valeurs invalides rendent
une erreur qui liste les valeurs acceptées, et cette erreur ne consomme pas de quota.

Les attributions (qui a gagné, pour quel montant) et le winner intelligence
ne sont PAS disponibles ici : ils demandent une clé. Voir https://tenderapi.fr/?via=mcp
ParametersJSON Schema
NameRequiredDescriptionDefault
cpvNoCode CPV exact à 8 chiffres, ex. '72000000' pour les services informatiques. Environ 40 % des avis BOAMP n'ont aucun CPV : un filtre CPV seul les écarte.
pageNoNuméro de page, à partir de 1.
sortNo'date' (antéchronologique, défaut) ou 'relevance' (classement BM25). 'relevance' n'a de sens qu'avec un keyword et est refusé sans lui.
regionNoRégion française en slug, ex. 'bretagne', 'ile-de-france', 'occitanie'. Une valeur inconnue rend une erreur qui suggère le slug le plus proche.
sourceNo'boamp' (avis français) ou 'ted' (avis européens). Sans valeur, les deux.
statusNo'open' (date limite non dépassée, évaluée à l'instant de la requête) ou 'closed'. ⚠️ SANS ce filtre la recherche porte sur tout le stock depuis 2015, avis clos compris (~2,9 millions) : posez 'open' si vous cherchez des avis auxquels il est encore possible de répondre.
countryNoCode pays ISO à 2 lettres, ex. 'FR', 'DE', 'ES'. Utile pour ne garder que le français ('FR') ou cibler un pays sur le corpus TED.
keywordNoRecherche plein texte sur titre et description, insensible aux accents. TOUS les mots doivent figurer dans le même avis : préférez un seul mot puis affinez. L'opérateur OR de FTS5 est accepté, ex. 'BIM OR "maquette numerique"'.
page_sizeNoNombre d'avis par page, 10 par défaut, plafonné à 20 en anonyme. Un avis pèse environ 1 300 caractères : montez à 20 seulement si vous comptez les lire tous.
budget_maxNoMontant maximum en euros.
budget_minNoMontant minimum en euros. Les avis sans budget renseigné sont écartés, sauf include_null_budget=true.
cpv_familyNoPréfixe CPV à 2 chiffres, ex. '72' = toute l'informatique, '45' = travaux.
departmentNoCode de département, ex. '35', '2A', '974'. Plusieurs valeurs séparées par des virgules.
buyer_siretNoSIRET de l'acheteur, 14 chiffres exactement (l'établissement, pas l'entreprise).
descripteurNoCode descripteur BOAMP (nomenclature DILA), alternative au CPV côté français.
buyer_keywordNoFragment du nom de l'acheteur, 3 caractères minimum, ex. 'metropole', 'CHU'.
contract_typeNo'services', 'works' ou 'supplies'. Les formes françaises 'travaux' et 'fournitures' sont acceptées comme alias.
deadline_afterNoDate limite de remise postérieure à cette date ISO (AAAA-MM-JJ).
procedure_typeNoType de procédure, ex. 'open', 'restricted', 'negotiated'. Valeur inconnue = erreur listant les valeurs acceptées.
deadline_beforeNoDate limite de remise antérieure à cette date ISO (AAAA-MM-JJ).
published_afterNoPublié après cette date ISO (AAAA-MM-JJ). C'est le filtre d'une veille quotidienne.
include_planningNoInclure les avis de pré-information (marchés simplement envisagés, non encore ouverts). Exclus par défaut.
published_beforeNoPublié avant cette date ISO (AAAA-MM-JJ).
include_null_budgetNoGarder les avis dont le budget n'est pas renseigné malgré un filtre de montant. Beaucoup d'avis BOAMP n'annoncent aucun montant.
include_null_deadlineNoGarder les avis sans date limite malgré un filtre de date limite. Sans cela, un filtre deadline_* les écarte silencieusement.

Output Schema

ParametersJSON Schema
NameRequiredDescription
hintNoExplication des raisons pour lesquelles la requête rend peu ou pas de résultats, et comment la corriger. Souvent renseigné sur un total de 0 : LISEZ-LE avant de conclure qu'il n'existe aucun avis, et reformulez en conséquence.
pageNoPage rendue.
quotaNoSolde du palier anonyme : {restant, plafond}. Surveillez-le plutôt que de découvrir le plafond en le heurtant.
totalNoNombre total d'avis correspondant aux filtres, toutes pages confondues.
resultsNoLes avis. Champs utiles : id (entier, à passer à get_tender), title, buyer_name, deadline, budget_max, region, source, source_url.
warningNoAvertissement sur l'interprétation des résultats (filtre ignoré, jeu tronqué).
page_sizeNoNombre d'avis par page.
client_updateNoNotice de mise à jour, uniquement pour le paquet pip `tenderapi-mcp`. Sans objet pour ce serveur hébergé, qui n'a rien à installer.

TDQS

A4.5/5.0
Behavior5/5

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

Annotations already cover the safety profile (readOnlyHint, openWorldHint, idempotentHint, destructiveHint=false), so the description's job is to add non-obvious behavior — and it excels: the 30-call/day/IP quota with a `quota` balance returned in each response, several-times-daily updates, invalid values returning errors that list accepted values without consuming quota, and the stock-search-over-everything default. No contradiction with 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?

The description is long, but every section earns its place: purpose and corpus first, then quota constraints, then five numbered pitfalls, error behavior, and scope exclusions. The numbered list is scannable, and the most critical rule (always filter) is front-loaded as pitfall 1. Each pitfall prevents a costly, silently-bad search, so the density is justified rather than redundant.

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?

For a tool with 25 parameters, two data sources, language-indexing quirks, and rate limits, the description is remarkably complete: it covers update cadence, anonymous access, quota semantics, error behavior, multilingual search, CPV coverage gaps, and feature exclusions. An output schema exists, so return-value documentation is not required of the description. Nothing an agent needs to call 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 the baseline is 3 and the schema fully documents all 25 parameters. The description adds some reinforcement value — pitfall 1 mandates at least one of keyword/cpv_family/country/status, and pitfall 5 reiterates the CPV coverage gap — plus the general statement that invalid values produce errors listing accepted values. This is useful emphasis, but it introduces no substantive parameter meaning beyond the schema.

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 opening sentence states a precise verb and resource: 'Recherche des appels d'offres publics français (BOAMP) et européens (TED)', naming both data sources and the corpus scale (~3M avis). It further delineates scope by explicitly listing what is NOT available ('Les attributions... et le winner intelligence ne sont PAS disponibles ici'), clearly distinguishing this search tool from the sibling get_tender.

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 five production pitfalls provide exceptionally concrete guidance on how to query correctly: always impose at least one filter, use single keywords because all words must match, prefer CPV codes for ambiguous terms, query TED in each relevant language, and combine CPV with keyword due to the 40% missing-CPV gap. It also states when the tool is appropriate (anonymous, quota-limited access) and what requires a key instead. However, it never explicitly names or routes to the siblings get_tender and preview_alerts, so when-vs-alternative guidance is implied rather than explicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 1 tool update
    • Addedpreview_alerts
  2. 2 tool updates
    • Changedget_tender1 field changed
      • addedInput schema / properties / tender_id / description
        Added value: +"L'entier du champ `id` renvoyé par search_tenders, ex. '3780679'. Ni le `source_id` (« 26-79926 »), ni l'URL de l'avis."
    • Changedsearch_tenders29 fields changed
      • addedInput schema / properties / budget_max / description
        Added value: +"Montant maximum en euros."
      • addedInput schema / properties / budget_min / description
        Added value: +"Montant minimum en euros. Les avis sans budget renseigné sont écartés, sauf include_null_budget=true."
      • addedInput schema / properties / buyer_keyword / description
        Added value: +"Fragment du nom de l'acheteur, 3 caractères minimum, ex. 'metropole', 'CHU'."
      • addedInput schema / properties / buyer_siret / description
        Added value: +"SIRET de l'acheteur, 14 chiffres exactement (l'établissement, pas l'entreprise)."
      • addedInput schema / properties / contract_type / description
        Added value: +"'services', 'works' ou 'supplies'. Les formes françaises 'travaux' et 'fournitures' sont acceptées comme alias."
      • addedInput schema / properties / country / description
        Added value: +"Code pays ISO à 2 lettres, ex. 'FR', 'DE', 'ES'. Utile pour ne garder que le français ('FR') ou cibler un pays sur le corpus TED."
      • addedInput schema / properties / cpv / description
        Added value: +"Code CPV exact à 8 chiffres, ex. '72000000' pour les services informatiques. Environ 40 % des avis BOAMP n'ont aucun CPV : un filtre CPV seul les écarte."
      • addedInput schema / properties / cpv_family / description
        Added value: +"Préfixe CPV à 2 chiffres, ex. '72' = toute l'informatique, '45' = travaux."
      • addedInput schema / properties / deadline_after / description
        Added value: +"Date limite de remise postérieure à cette date ISO (AAAA-MM-JJ)."
      • addedInput schema / properties / deadline_before / description
        Added value: +"Date limite de remise antérieure à cette date ISO (AAAA-MM-JJ)."
      • addedInput schema / properties / department / description
        Added value: +"Code de département, ex. '35', '2A', '974'. Plusieurs valeurs séparées par des virgules."
      • addedInput schema / properties / descripteur / description
        Added value: +"Code descripteur BOAMP (nomenclature DILA), alternative au CPV côté français."
      • addedInput schema / properties / include_null_budget / description
        Added value: +"Garder les avis dont le budget n'est pas renseigné malgré un filtre de montant. Beaucoup d'avis BOAMP n'annoncent aucun montant."
      • addedInput schema / properties / include_null_deadline / description
        Added value: +"Garder les avis sans date limite malgré un filtre de date limite. Sans cela, un filtre deadline_* les écarte silencieusement."
      • addedInput schema / properties / include_planning / description
        Added value: +"Inclure les avis de pré-information (marchés simplement envisagés, non encore ouverts). Exclus par défaut."
      • addedInput schema / properties / keyword / description
        Added value: +"Recherche plein texte sur titre et description, insensible aux accents. TOUS les mots doivent figurer dans le même avis : préférez un seul mot puis affinez. L'opérateur OR de FTS5 est accepté, ex. 'BIM OR \"maquette numerique\"'."
      • addedInput schema / properties / page / description
        Added value: +"Numéro de page, à partir de 1."
      • changedInput schema / properties / page_size / default
        Previous value: -20New value: +10
      • addedInput schema / properties / page_size / description
        Added value: +"Nombre d'avis par page, 10 par défaut, plafonné à 20 en anonyme. Un avis pèse environ 1 300 caractères : montez à 20 seulement si vous comptez les lire tous."
      • addedInput schema / properties / procedure_type / description
        Added value: +"Type de procédure, ex. 'open', 'restricted', 'negotiated'. Valeur inconnue = erreur listant les valeurs acceptées."
      • addedInput schema / properties / published_after / description
        Added value: +"Publié après cette date ISO (AAAA-MM-JJ). C'est le filtre d'une veille quotidienne."
      • addedInput schema / properties / published_before / description
        Added value: +"Publié avant cette date ISO (AAAA-MM-JJ)."
      • addedInput schema / properties / region / description
        Added value: +"Région française en slug, ex. 'bretagne', 'ile-de-france', 'occitanie'. Une valeur inconnue rend une erreur qui suggère le slug le plus proche."
      • addedInput schema / properties / sort / description
        Added value: +"'date' (antéchronologique, défaut) ou 'relevance' (classement BM25). 'relevance' n'a de sens qu'avec un keyword et est refusé sans lui."
      • addedInput schema / properties / source / description
        Added value: +"'boamp' (avis français) ou 'ted' (avis européens). Sans valeur, les deux."
      • addedInput schema / properties / status / description
        Added value: +"'open' (date limite non dépassée, évaluée à l'instant de la requête) ou 'closed'. ⚠️ SANS ce filtre la recherche porte sur tout le stock depuis 2015, avis clos compris (~2,9 millions) : posez 'open' si vous cherchez des avis auxquels il est encore possible de répondre."
      • addedOutput schema / description
        Added value: +"Enveloppe d'une page de resultats. Sert d'outputSchema : il etait declare mais\nvide (`additionalProperties: true`), donc l'agent ne savait pas ou regarder.\n\n⚠️ Le SDK VALIDE la valeur rendue contre ce modele puis la RE-SERIALISE depuis lui\n(func_metadata.py:129). D'ou deux precautions, sans lesquelles un simple ajout de\nchamp cote API casserait tous les appels :\n· `extra=allow` — les champs non declares traversent au lieu d'etre effaces ;\n· tous les champs optionnels — un champ qui disparait ne fait pas echouer l'appel.\nLe detail d'un avis reste volontairement `dict` : sa forme appartient a l'API, la\nfiger ici reviendrait a maintenir deux fois le meme schema."
      • addedOutput schema / properties
        Added value: +{
+  "client_update": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null,
+    "description": "Notice de mise à jour, uniquement pour le paquet pip `tenderapi-mcp`. Sans objet pour ce serveur hébergé, qui n'a rien à installer.",
+    "title": "Client Update"
+  },
+  "hint": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null,
+    "description": "Explication des raisons pour lesquelles la requête rend peu ou pas de résultats, et comment la corriger. Souvent renseigné sur un total de 0 : LISEZ-LE avant de conclure qu'il n'existe aucun avis, et reformulez en conséquence.",
+    "title": "Hint"
+  },
+  "page": {
+    "anyOf": [
+      {
+        "type": "integer"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null,
+    "description": "Page rendue.",
+    "title": "Page"
+  },
+  "page_size": {
+    "anyOf": [
+      {
+        "type": "integer"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null,
+    "description": "Nombre d'avis par page.",
+    "title": "Page Size"
+  },
+  "quota": {
+    "anyOf": [
+      {
+        "additionalProperties": true,
+        "type": "object"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null,
+    "description": "Solde du palier anonyme : {restant, plafond}. Surveillez-le plutôt que de découvrir le plafond en le heurtant.",
+    "title": "Quota"
+  },
+  "results": {
+    "description": "Les avis. Champs utiles : id (entier, à passer à get_tender), title, buyer_name, deadline, budget_max, region, source, source_url.",
+    "items": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "title": "Results",
+    "type": "array"
+  },
+  "total": {
+    "anyOf": [
+      {
+        "type": "integer"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null,
+    "description": "Nombre total d'avis correspondant aux filtres, toutes pages confondues.",
+    "title": "Total"
+  },
+  "warning": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null,
+    "description": "Avertissement sur l'interprétation des résultats (filtre ignoré, jeu tronqué).",
+    "title": "Warning"
+  }
+}
      • changedOutput schema / title
        Previous value: -"search_tendersDictOutput"New value: +"TenderSearchPage"
  3. 2 tool updates
    • First observedget_tender
    • First observedsearch_tenders

Frequently Asked Questions

Discussions

No comments yet. Be the first to start the discussion!

Login with GitHub to comment

Related MCP Connectors

Related MCP Servers

  • swiss-procurement-mcp

    malkreide
    A
    license
    A
    quality
    A
    maintenance
    MCP server providing read access to Swiss public procurement data via the official simap.ch API, covering all cantons and the Confederation with intraday updates. It enables searching tenders, awards, construction codes, and procurement offices through natural language queries.
    9
    MIT
Try in Browser
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A4.7/5.0
Disambiguation5/5

Each tool targets a distinct operation: searching across tenders, retrieving one tender's full detail, and simulating an alert delivery. The descriptions clearly separate one-shot search from recurring alert preview, so there is little risk of misselection.

Naming Consistency5/5

All tool names follow a consistent verb_noun snake_case pattern: get_tender, search_tenders, preview_alerts. The verbs clearly express the action and the nouns are appropriate, creating a predictable naming scheme.

Tool Count5/5

With only three tools, the server is tightly scoped to its read-only tender search and alert preview purpose. Each tool adds a distinct capability and none feel redundant or missing.

Completeness4/5

The core search-and-retrieve workflow is well covered, and preview_alerts adds useful simulation. However, there is no tool to actually create or manage real alerts, and award/winner data is explicitly unavailable, leaving minor but documented gaps.

Resources