tenderapi-mcp

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

От сообществаРаботаетБез входаГлобальныйБесплатноТолько чтение

Что умеет

Какие данные видит

Нужен ли аккаунт

Не нужен: сервер работает без входа

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

Список инструментов сервера (3)

Технические названия из tools/list. Нужны только разработчикам.

search_tenders	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
get_tender	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`.
preview_alerts	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`.