MCP server for French (BOAMP) + EU (TED) public procurement data via TenderAPI.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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`.
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.
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`.
| Argument | Type | Description |
|---|---|---|
| tender_id* | string | 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. |
{
"type": "object",
"title": "get_tenderArguments",
"required": [
"tender_id"
],
"properties": {
"tender_id": {
"type": "string",
"title": "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."
}
}
}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 inclut une veille par email, envoyée chaque lundi (rythme : `last_7d`). La veille quotidienne (rythme : `last_24h`), Teams, webhook et plusieurs veilles relèvent de l'offre Pro, 15 €/mois. 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`.
| Argument | Type | Description |
|---|---|---|
| siret | any | SIRET d'un acheteur précis, pour ne suivre que lui. |
| country | any | Codes pays ISO à 2 lettres, ex. ['FR']. Seul critère géographique qui porte sur les DEUX sources (BOAMP et TED). |
| regions | any | 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). |
| keywords | any | 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. |
| cpv_codes | any | 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. |
| budget_max | any | Montant maximum en euros. |
| budget_min | any | Montant minimum en euros. |
| departments | any | Numéros de départements, ex. ['75', '06', '2A']. Le nom écrit en toutes lettres est refusé. |
| match_cpv_family | boolean | Élargit les codes CPV à leur famille (2 premiers chiffres) au lieu du code exact. |
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
| Argument | Type | Description |
|---|---|---|
| cpv | any | 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. |
| page |
{
"type": "object",
"title": "preview_alertsArguments",
"properties": {
"siret": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Siret",
"default": null,
"description": "SIRET d'un acheteur précis, pour ne suivre que lui."
},
"country": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Country",
"default": null,
"description": "Codes pays ISO à 2 lettres, ex. ['FR']. Seul critère géographique qui porte sur les DEUX sources (BOAMP et TED)."
},
"regions": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Regions",
"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)."
},
"keywords": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Keywords",
"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."
},
"cpv_codes": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Cpv Codes",
"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."
},
"budget_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Budget Max",
"default": null,
"description": "Montant maximum en euros."
},
"budget_min": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Budget Min",
"default": null,
"description": "Montant minimum en euros."
},
"departments": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Departments",
"default": null,
"description": "Numéros de départements, ex. ['75', '06', '2A']. Le nom écrit en toutes lettres est refusé."
},
"match_cpv_family": {
"type": "boolean",
"title": "Match Cpv Family",
"default": false,
"description": "Élargit les codes CPV à leur famille (2 premiers chiffres) au lieu du code exact."
}
}
}| integer |
| Numéro de page, à partir de 1. |
| sort | any | 'date' (antéchronologique, défaut), 'relevance' (classement BM25) ou 'deadline' (date limite la plus proche d'abord, avis sans date limite en dernier). 'relevance' n'a de sens qu'avec un keyword et est refusé sans lui. 'deadline' se combine avec status='open' ou deadline_after, sinon la liste commence par des avis clos depuis des années. |
| region | any | 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. |
| source | any | 'boamp' (avis français) ou 'ted' (avis européens). Sans valeur, les deux. |
| status | any | '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. |
| country | any | 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. |
| keyword | any | 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"'. |
| page_size | integer | 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. |
| budget_max | any | Montant maximum en euros. |
| budget_min | any | Montant minimum en euros. Les avis sans budget renseigné sont écartés, sauf include_null_budget=true. |
| cpv_family | any | Préfixe CPV à 2 chiffres, ex. '72' = toute l'informatique, '45' = travaux. |
| department | any | Code de département, ex. '35', '2A', '974'. Plusieurs valeurs séparées par des virgules. |
| buyer_siret | any | SIRET de l'acheteur, 14 chiffres exactement (l'établissement, pas l'entreprise). |
| descripteur | any | Code descripteur BOAMP (nomenclature DILA), alternative au CPV côté français. |
| buyer_keyword | any | Fragment du nom de l'acheteur, 3 caractères minimum, ex. 'metropole', 'CHU'. |
| contract_type | any | 'services', 'works' ou 'supplies'. Les formes françaises 'travaux' et 'fournitures' sont acceptées comme alias. |
| deadline_after | any | Date limite de remise postérieure à cette date ISO (AAAA-MM-JJ). |
| procedure_type | any | Type de procédure, ex. 'open', 'restricted', 'negotiated'. Valeur inconnue = erreur listant les valeurs acceptées. |
| deadline_before | any | Date limite de remise antérieure à cette date ISO (AAAA-MM-JJ). |
| published_after | any | Publié après cette date ISO (AAAA-MM-JJ). C'est le filtre d'une veille quotidienne. |
| include_planning | boolean | Inclure les avis de pré-information (marchés simplement envisagés, non encore ouverts). Exclus par défaut. |
| published_before | any | Publié avant cette date ISO (AAAA-MM-JJ). |
| include_null_budget | boolean | Garder les avis dont le budget n'est pas renseigné malgré un filtre de montant. Beaucoup d'avis BOAMP n'annoncent aucun montant. |
| include_null_deadline | boolean | Garder les avis sans date limite malgré un filtre de date limite. Sans cela, un filtre deadline_* les écarte silencieusement. |
{
"type": "object",
"title": "search_tendersArguments",
"properties": {
"cpv": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Cpv",
"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."
},
"page": {
"type": "integer",
"title": "Page",
"default": 1,
"description": "Numéro de page, à partir de 1."
},
"sort": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Sort",
"default": null,
"description": "'date' (antéchronologique, défaut), 'relevance' (classement BM25) ou 'deadline' (date limite la plus proche d'abord, avis sans date limite en dernier). 'relevance' n'a de sens qu'avec un keyword et est refusé sans lui. 'deadline' se combine avec status='open' ou deadline_after, sinon la liste commence par des avis clos depuis des années."
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Region",
"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."
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source",
"default": null,
"description": "'boamp' (avis français) ou 'ted' (avis européens). Sans valeur, les deux."
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Status",
"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."
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Country",
"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."
},
"keyword": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Keyword",
"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\"'."
},
"page_size": {
"type": "integer",
"title": "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."
},
"budget_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Budget Max",
"default": null,
"description": "Montant maximum en euros."
},
"budget_min": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Budget Min",
"default": null,
"description": "Montant minimum en euros. Les avis sans budget renseigné sont écartés, sauf include_null_budget=true."
},
"cpv_family": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Cpv Family",
"default": null,
"description": "Préfixe CPV à 2 chiffres, ex. '72' = toute l'informatique, '45' = travaux."
},
"department": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Department",
"default": null,
"description": "Code de département, ex. '35', '2A', '974'. Plusieurs valeurs séparées par des virgules."
},
"buyer_siret": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Buyer Siret",
"default": null,
"description": "SIRET de l'acheteur, 14 chiffres exactement (l'établissement, pas l'entreprise)."
},
"descripteur": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Descripteur",
"default": null,
"description": "Code descripteur BOAMP (nomenclature DILA), alternative au CPV côté français."
},
"buyer_keyword": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Buyer Keyword",
"default": null,
"description": "Fragment du nom de l'acheteur, 3 caractères minimum, ex. 'metropole', 'CHU'."
},
"contract_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Contract Type",
"default": null,
"description": "'services', 'works' ou 'supplies'. Les formes françaises 'travaux' et 'fournitures' sont acceptées comme alias."
},
"deadline_after": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Deadline After",
"default": null,
"description": "Date limite de remise postérieure à cette date ISO (AAAA-MM-JJ)."
},
"procedure_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Procedure Type",
"default": null,
"description": "Type de procédure, ex. 'open', 'restricted', 'negotiated'. Valeur inconnue = erreur listant les valeurs acceptées."
},
"deadline_before": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Deadline Before",
"default": null,
"description": "Date limite de remise antérieure à cette date ISO (AAAA-MM-JJ)."
},
"published_after": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Published After",
"default": null,
"description": "Publié après cette date ISO (AAAA-MM-JJ). C'est le filtre d'une veille quotidienne."
},
"include_planning": {
"type": "boolean",
"title": "Include Planning",
"default": false,
"description": "Inclure les avis de pré-information (marchés simplement envisagés, non encore ouverts). Exclus par défaut."
},
"published_before": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Published Before",
"default": null,
"description": "Publié avant cette date ISO (AAAA-MM-JJ)."
},
"include_null_budget": {
"type": "boolean",
"title": "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."
},
"include_null_deadline": {
"type": "boolean",
"title": "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."
}
}
}