tenderapi-mcp
MCP server for French (BOAMP) + EU (TED) public procurement data via TenderAPI.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (3)
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains URL to non-standard domainen search_tenders
- MEDIUMTool description contains URL to non-standard domainen preview_alerts
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"tenderapi-mcp": {
"command": "uvx",
"args": [
"tenderapi-mcp"
]
}
}
}Paquetes ejecutables
0.8.0stdioPuntos de conexión remotos
https://tenderapi.fr/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (3)
🟢search_tenders(cpv, cpv_family, descripteur, keyword, region, ...)
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
Esquema de entrada
{
"type": "object",
"properties": {
"cpv": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "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.",
"title": "Cpv"
},
"cpv_family": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Préfixe CPV à 2 chiffres, ex. '72' = toute l'informatique, '45' = travaux.",
"title": "Cpv Family"
},
"descripteur": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Code descripteur BOAMP (nomenclature DILA), alternative au CPV côté français.",
"title": "Descripteur"
},
"keyword": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "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\"'.",
"title": "Keyword"
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "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.",
"title": "Region"
},
"department": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Code de département, ex. '35', '2A', '974'. Plusieurs valeurs séparées par des virgules.",
"title": "Department"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "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.",
"title": "Country"
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "'boamp' (avis français) ou 'ted' (avis européens). Sans valeur, les deux.",
"title": "Source"
},
"include_planning": {
"default": false,
"description": "Inclure les avis de pré-information (marchés simplement envisagés, non encore ouverts). Exclus par défaut.",
"title": "Include Planning",
"type": "boolean"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "'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.",
"title": "Status"
},
"procedure_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Type de procédure, ex. 'open', 'restricted', 'negotiated'. Valeur inconnue = erreur listant les valeurs acceptées.",
"title": "Procedure Type"
},
"contract_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "'services', 'works' ou 'supplies'. Les formes françaises 'travaux' et 'fournitures' sont acceptées comme alias.",
"title": "Contract Type"
},
"buyer_siret": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "SIRET de l'acheteur, 14 chiffres exactement (l'établissement, pas l'entreprise).",
"title": "Buyer Siret"
},
"buyer_keyword": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Fragment du nom de l'acheteur, 3 caractères minimum, ex. 'metropole', 'CHU'.",
"title": "Buyer Keyword"
},
"budget_min": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Montant minimum en euros. Les avis sans budget renseigné sont écartés, sauf include_null_budget=true.",
"title": "Budget Min"
},
"budget_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Montant maximum en euros.",
"title": "Budget Max"
},
"include_null_budget": {
"default": false,
"description": "Garder les avis dont le budget n'est pas renseigné malgré un filtre de montant. Beaucoup d'avis BOAMP n'annoncent aucun montant.",
"title": "Include Null Budget",
"type": "boolean"
},
"deadline_after": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Date limite de remise postérieure à cette date ISO (AAAA-MM-JJ).",
"title": "Deadline After"
},
"deadline_before": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Date limite de remise antérieure à cette date ISO (AAAA-MM-JJ).",
"title": "Deadline Before"
},
"include_null_deadline": {
"default": false,
"description": "Garder les avis sans date limite malgré un filtre de date limite. Sans cela, un filtre deadline_* les écarte silencieusement.",
"title": "Include Null Deadline",
"type": "boolean"
},
"published_after": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Publié après cette date ISO (AAAA-MM-JJ). C'est le filtre d'une veille quotidienne.",
"title": "Published After"
},
"published_before": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Publié avant cette date ISO (AAAA-MM-JJ).",
"title": "Published Before"
},
"sort": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "'date' (antéchronologique, défaut) ou 'relevance' (classement BM25). 'relevance' n'a de sens qu'avec un keyword et est refusé sans lui.",
"title": "Sort"
},
"page": {
"default": 1,
"description": "Numéro de page, à partir de 1.",
"title": "Page",
"type": "integer"
},
"page_size": {
"default": 10,
"description": "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.",
"title": "Page Size",
"type": "integer"
}
},
"title": "search_tendersArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"total": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Nombre total d'avis correspondant aux filtres, toutes pages confondues.",
"title": "Total"
},
"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"
},
"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"
},
"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"
},
"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"
},
"warning": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Avertissement sur l'interprétation des résultats (filtre ignoré, jeu tronqué).",
"title": "Warning"
},
"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"
}
},
"additionalProperties": true,
"description": "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.",
"title": "TenderSearchPage"
}🟢get_tender(tender_id)
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`.
Esquema de entrada
{
"type": "object",
"properties": {
"tender_id": {
"description": "L'entier du champ `id` renvoyé par search_tenders, ex. '3780679'. La référence de l'éditeur est acceptée aussi : `source_id` BOAMP « 26-79926 » ou TED « 510250-2026 ». Pas l'URL de l'avis.",
"title": "Tender Id",
"type": "string"
}
},
"required": [
"tender_id"
],
"title": "get_tenderArguments"
}Esquema de salida
{
"type": "object",
"additionalProperties": true,
"title": "get_tenderDictOutput"
}🟢preview_alerts(keywords, cpv_codes, match_cpv_family, regions, departments, ...)
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`.
Esquema de entrada
{
"type": "object",
"properties": {
"keywords": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Mots-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.",
"title": "Keywords"
},
"cpv_codes": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Codes 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.",
"title": "Cpv Codes"
},
"match_cpv_family": {
"default": false,
"description": "Élargit les codes CPV à leur famille (2 premiers chiffres) au lieu du code exact.",
"title": "Match Cpv Family",
"type": "boolean"
},
"regions": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Ré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).",
"title": "Regions"
},
"departments": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Numéros de départements, ex. ['75', '06', '2A']. Le nom écrit en toutes lettres est refusé.",
"title": "Departments"
},
"country": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Codes pays ISO à 2 lettres, ex. ['FR']. Seul critère géographique qui porte sur les DEUX sources (BOAMP et TED).",
"title": "Country"
},
"siret": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "SIRET d'un acheteur précis, pour ne suivre que lui.",
"title": "Siret"
},
"budget_min": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Montant minimum en euros.",
"title": "Budget Min"
},
"budget_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Montant maximum en euros.",
"title": "Budget Max"
}
},
"title": "preview_alertsArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Avis actuellement ouverts correspondant à ces critères.",
"title": "Count"
},
"last_24h": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Parmi eux, ceux arrivés en 24 h : ce que le prochain envoi quotidien contiendrait.",
"title": "Last 24H"
},
"last_7d": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Arrivés dans les 7 derniers jours.",
"title": "Last 7D"
},
"last_30d": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Arrivé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.",
"title": "Last 30D"
},
"sample": {
"description": "Titres des 5 premiers avis correspondants — de quoi montrer concrètement ce qui arriverait.",
"items": {
"type": "string"
},
"title": "Sample",
"type": "array"
},
"per_criterion": {
"description": "Ce 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.",
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Per Criterion",
"type": "array"
},
"quota": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Solde du palier anonyme : {restant, plafond}.",
"title": "Quota"
}
},
"additionalProperties": true,
"description": "Ce qu'une veille AURAIT livré. Mêmes précautions que `TenderSearchPage` :\n`extra=allow` et tous les champs optionnels, pour qu'un ajout côté API ne casse\npas l'appel (le SDK valide puis re-sérialise depuis ce modèle).",
"title": "AlertPreview"
}Comunidad
Evidencia