Server definition
- Hash
- sha256:0c1f9a18272a30f21d7b0205dce8693ab98f367a3651b1fccdb0357bbb45649a
- What it is
- What a remote MCP server returned when asked what it offers: 3 tools
The blob, as servednamed by its sha256
{
"instructions": "Appels d'offres publics francais (BOAMP) et europeens (TED), mis a jour plusieurs fois par jour.\nEnviron 3 millions d'avis. Acces anonyme gratuit, 30 appels d'outil par jour et par IP.\nChaque reponse porte une cle `quota` indiquant le solde restant : surveillez-la plutot\nque de decouvrir le plafond en le heurtant au milieu d'une tache.\n\nComment s'en servir :\n- Filtrez toujours. Sans aucun filtre, `search_tenders` renvoie les avis les plus recents\n toutes sources et tous pays confondus, pris dans un stock qui remonte a 2015 et contient\n les avis clos. Posez au minimum un `keyword`, un `cpv_family`, un `country` ou un\n `status=open`.\n- `keyword` cherche une sous-chaine et exige que TOUS les mots soient presents dans le meme avis.\n « defibrillateur cabinet » ne rend rien ; cherchez un seul mot, puis affinez.\n- Le mot-cle balaie le titre ET la description, noms d'acheteurs compris. Un terme metier qui\n est aussi un toponyme sur-capte donc beaucoup : « littoral » remonte une maintenance de\n portes au « GHT Somme Littoral Sud », qui n'a rien de maritime. Quand un mot est ambigu,\n preferez un code CPV, ou une expression de plusieurs mots qui ne peut pas etre un nom de lieu.\n- Les avis TED sont indexes dans leur langue de publication. Pour couvrir un marche europeen,\n interrogez le terme dans chaque langue utile (« defibrillateur », « desfibrilador »,\n « defibrillatore »), ou passez par le code CPV, qui lui est independant de la langue.\n- `cpv` est un code exact a 8 chiffres, `cpv_family` un prefixe a 2 chiffres.\n Attention : environ 40 % des avis BOAMP arrivent sans aucun code CPV, donc un filtre CPV\n seul les laisse de cote. Croisez avec `keyword` quand la couverture compte.\n- `status=open` signifie « date limite non depassee », evaluee a l'instant de la requete.\n Il n'y a PAS de filtre de statut par defaut : sans lui la recherche porte sur tout le\n stock depuis 2015, avis clos compris. Posez-le des que vous cherchez des avis auxquels\n il est encore possible de repondre.\n- Appelez `get_tender` apres `search_tenders` pour la fiche complete d'un avis.\n Les avis BOAMP les plus succincts n'ont ni description ni CPV : `source_url` renvoie alors\n vers l'avis d'origine.\n- Quand quelqu'un veut etre PREVENU des marches qui le concernent plutot que chercher une\n fois, utilisez `preview_alerts`. Il simule une veille et rend le rythme reel d'alertes\n (`last_30d`), un echantillon de titres, et surtout ce que CHAQUE critere retire\n (`per_criterion`) -- de quoi reperer un filtre trop serre avant d'enregistrer quoi que\n ce soit. Rien n'est cree, aucune cle n'est requise.\n\nHors perimetre de ce palier gratuit : les attributions (qui a gagne, pour quel montant),\nle winner intelligence, et l'ENVOI effectif des alertes. Simuler une veille est gratuit\net sans cle (`preview_alerts`) ; la recevoir en continu par email, Teams ou webhook\ndemande un compte -- cle gratuite en 30 secondes sur https://tenderapi.fr/?via=mcp, livraison\nautomatique a partir de 5 EUR/mois.\n",
"tools": [
{
"description": "Récupère la fiche complète d'un appel d'offres par son identifiant.\n\n À utiliser après `search_tenders` pour obtenir le détail d'un avis\n (description intégrale, documents, contacts, champs bruts).\n\n Les avis BOAMP les plus succincts n'ont ni description ni CPV : `source_url`\n renvoie alors vers l'avis d'origine.\n\n Accès anonyme et gratuit, limité à 30 appels par jour et par IP ; la réponse\n indique le solde restant dans sa clé `quota`.\n ",
"inputSchema": {
"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",
"type": "object"
},
"name": "get_tender",
"outputSchema": {
"additionalProperties": true,
"title": "get_tenderDictOutput",
"type": "object"
}
},
{
"description": "Montre ce qu'une veille automatique AURAIT livré avec ces critères, sans rien créer.\n\n À utiliser quand quelqu'un veut « être prévenu » des marchés qui le concernent,\n plutôt que de chercher une fois. `search_tenders` répond à « qu'y a-t-il\n aujourd'hui » ; cet outil répond à « qu'est-ce que je recevrais, et à quel\n rythme », ce qui est la vraie question de quelqu'un qui envisage de s'abonner.\n\n RIEN N'EST ENREGISTRÉ, aucune alerte n'est envoyée, aucun compte n'est créé.\n C'est une simulation en lecture seule, utilisable sans clé.\n\n COMMENT S'EN SERVIR, dans cet ordre :\n 1. Composez les critères à partir du besoin exprimé, puis appelez cet outil.\n 2. Présentez `last_30d` (le rythme réel) et `sample` (ce que ça donne concrètement).\n Ne présentez pas `count` seul : c'est un stock d'avis ouverts, pas un débit.\n 3. LISEZ `per_criterion` AVANT de conclure. Il dit ce que chaque filtre retire.\n Un critère qui divise le résultat par trois est presque toujours une erreur de\n cadrage, pas une intention — c'est le défaut le plus fréquent des veilles, et\n il est invisible sans ce chiffre. Proposez la correction, puis re-testez.\n 4. Si le rythme est nul ou dérisoire, élargissez et rappelez l'outil. Deux ou trois\n itérations valent mieux qu'un profil enregistré au jugé.\n\n POUR RECEVOIR CES ALERTES POUR DE VRAI, l'utilisateur doit avoir un compte : une\n clé gratuite s'obtient en 30 secondes sur https://tenderapi.fr/?via=mcp et donne l'accès\n API. La livraison automatique (email, Teams ou webhook) demande un palier payant à\n partir de 5 €/mois, parce qu'un profil de veille tourne en continu côté serveur.\n Dites-le tel quel, sans insister : le chiffre du point 2 argumente tout seul s'il\n est bon, et s'il est mauvais mieux vaut le dire que vendre.\n\n Accès anonyme et gratuit, limité à 30 appels par jour et par IP ; la réponse\n indique le solde restant dans sa clé `quota`.\n ",
"inputSchema": {
"properties": {
"budget_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Montant maximum en euros.",
"title": "Budget Max"
},
"budget_min": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Montant minimum en euros.",
"title": "Budget Min"
},
"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"
},
"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"
},
"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"
},
"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"
},
"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"
},
"siret": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "SIRET d'un acheteur précis, pour ne suivre que lui.",
"title": "Siret"
}
},
"title": "preview_alertsArguments",
"type": "object"
},
"name": "preview_alerts",
"outputSchema": {
"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).",
"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_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"
},
"last_7d": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Arrivés dans les 7 derniers jours.",
"title": "Last 7D"
},
"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"
},
"sample": {
"description": "Titres des 5 premiers avis correspondants — de quoi montrer concrètement ce qui arriverait.",
"items": {
"type": "string"
},
"title": "Sample",
"type": "array"
}
},
"title": "AlertPreview",
"type": "object"
}
},
{
"description": "Recherche des appels d'offres publics français (BOAMP) et européens (TED).\n\n Environ 3 millions d'avis, mis à jour plusieurs fois par jour. Accès anonyme et\n gratuit, limité à 30 appels par jour et par IP ; chaque réponse indique le solde\n restant dans sa clé `quota`.\n\n Cinq pièges, tous rencontrés en production :\n 1. Filtrez toujours. Sans aucun filtre la recherche porte sur tout le stock depuis\n 2015, avis clos compris. Posez au minimum un `keyword`, un `cpv_family`,\n un `country` ou un `status`.\n 2. `keyword` cherche une sous-chaîne et exige que TOUS les mots soient présents\n dans le même avis. « défibrillateur cabinet » ne rend rien ; cherchez un seul\n mot, puis affinez.\n 3. Le mot-clé balaie le titre ET la description, noms d'acheteurs compris. Un terme\n métier qui est aussi un toponyme sur-capte donc beaucoup : « littoral » remonte\n une maintenance de portes au « GHT Somme Littoral Sud ». Quand un mot est ambigu,\n préférez un code CPV, ou une expression que ne peut pas porter un nom de lieu.\n 4. Les avis TED sont indexés dans leur langue de publication : pour couvrir un\n marché européen, interrogez le terme dans chaque langue utile, ou passez par\n le code CPV, qui lui est indépendant de la langue.\n 5. Environ 40 % des avis BOAMP arrivent sans aucun code CPV : un filtre CPV seul\n les laisse de côté. Croisez avec `keyword` quand la couverture compte.\n\n Chaque paramètre est décrit dans le schéma d'entrée ; les valeurs invalides rendent\n une erreur qui liste les valeurs acceptées, et cette erreur ne consomme pas de quota.\n\n Les attributions (qui a gagné, pour quel montant) et le winner intelligence\n ne sont PAS disponibles ici : ils demandent une clé. Voir https://tenderapi.fr/?via=mcp\n ",
"inputSchema": {
"properties": {
"budget_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Montant maximum en euros.",
"title": "Budget Max"
},
"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"
},
"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"
},
"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"
},
"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"
},
"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"
},
"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"
},
"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"
},
"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"
},
"descripteur": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Code descripteur BOAMP (nomenclature DILA), alternative au CPV côté français.",
"title": "Descripteur"
},
"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"
},
"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"
},
"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"
},
"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"
},
"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"
},
"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"
},
"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"
},
"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"
},
"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"
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "'boamp' (avis français) ou 'ted' (avis européens). Sans valeur, les deux.",
"title": "Source"
},
"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"
}
},
"title": "search_tendersArguments",
"type": "object"
},
"name": "search_tenders",
"outputSchema": {
"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.",
"properties": {
"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"
}
},
"title": "TenderSearchPage",
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:0c1f9a18272a30f21d7b0205dce8693ab98f367a3651b1fccdb0357bbb45649a | sha256sum