tenderapi-mcp

{'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."}}}

{'type': 'object', 'title': 'get_tenderDictOutput', 'additionalProperties': True}

{'type': 'object', 'title': 'preview_alertsArguments', 'properties': {'siret': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Siret', 'default': None, 'description': "SIRET d'un acheteur précis, pour ne suivre que lui."}, 'country': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'title': 'Country', 'default': None, 'description': "Codes pays ISO Ã\xa0 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': None, 'description': "Régions françaises, ex. ['bretagne', 'ile-de-france']. Les formes usuelles (« Bretagne », « Ã\x8ele-de-France », « PACA ») sont normalisées, et une région inconnue est refusée avec une suggestion â\x80\x94 elle ne rend jamais zéro en silence. â\x9a\xa0ï¸\x8f 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': None, '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 Ã\xa0 une longue.'}, 'cpv_codes': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'title': 'Cpv Codes', 'default': None, 'description': 'Codes CPV exacts Ã\xa0 8 chiffres. â\x9a\xa0ï¸\x8f Environ 40 % des avis BOAMP arrivent SANS aucun CPV : un CPV combiné en ET avec un mot-clé écarte silencieusement ces avis-lÃ\xa0. `per_criterion` chiffre exactement ce que ça coûte â\x80\x94 regardez-le.'}, 'budget_max': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Budget Max', 'default': None, 'description': 'Montant maximum en euros.'}, 'budget_min': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Budget Min', 'default': None, 'description': 'Montant minimum en euros.'}, 'departments': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'title': 'Departments', 'default': None, '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': 'Ã\x89largit les codes CPV Ã\xa0 leur famille (2 premiers chiffres) au lieu du code exact.'}}}

{'type': 'object', 'title': 'AlertPreview', 'properties': {'count': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Count', 'default': None, 'description': 'Avis actuellement ouverts correspondant Ã\xa0 ces critères.'}, 'quota': {'anyOf': [{'type': 'object', 'additionalProperties': True}, {'type': 'null'}], 'title': 'Quota', 'default': None, 'description': 'Solde du palier anonyme : {restant, plafond}.'}, 'sample': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Sample', 'description': 'Titres des 5 premiers avis correspondants â\x80\x94 de quoi montrer concrètement ce qui arriverait.'}, 'last_7d': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Last 7D', 'default': None, 'description': 'Arrivés dans les 7 derniers jours.'}, 'last_24h': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Last 24H', 'default': None, 'description': 'Parmi eux, ceux arrivés en 24 h : ce que le prochain envoi quotidien contiendrait.'}, 'last_30d': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Last 30D', 'default': None, 'description': "Arrivés dans les 30 derniers jours. C'EST LE CHIFFRE Ã\x80 PRÃ\x89SENTER : le meilleur estimateur du rythme d'alertes. `count` mesure un stock, pas un rythme â\x80\x94 un profil peut porter des centaines d'avis ouverts et ne rien livrer pendant des jours."}, 'per_criterion': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'title': '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Ã\xa0. Un écart énorme signale un filtre trop serré â\x80\x94 c'est la lecture la plus utile de cet outil. Vide si le profil n'a qu'un seul critère."}}, '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).", 'additionalProperties': True}

{'type': 'object', 'title': 'search_tendersArguments', 'properties': {'cpv': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Cpv', 'default': None, 'description': "Code CPV exact Ã\xa0 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, Ã\xa0 partir de 1.'}, 'sort': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Sort', 'default': None, 'description': "'date' (antéchronologique, défaut) ou 'relevance' (classement BM25). 'relevance' n'a de sens qu'avec un keyword et est refusé sans lui."}, 'region': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Region', 'default': None, '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': None, 'description': "'boamp' (avis français) ou 'ted' (avis européens). Sans valeur, les deux."}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Status', 'default': None, 'description': "'open' (date limite non dépassée, évaluée Ã\xa0 l'instant de la requête) ou 'closed'. â\x9a\xa0ï¸\x8f 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': None, 'description': "Code pays ISO Ã\xa0 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': None, '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é Ã\xa0 20 en anonyme. Un avis pèse environ 1 300 caractères : montez Ã\xa0 20 seulement si vous comptez les lire tous."}, 'budget_max': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Budget Max', 'default': None, 'description': 'Montant maximum en euros.'}, 'budget_min': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Budget Min', 'default': None, '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': None, 'description': "Préfixe CPV Ã\xa0 2 chiffres, ex. '72' = toute l'informatique, '45' = travaux."}, 'department': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Department', 'default': None, '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': None, 'description': "SIRET de l'acheteur, 14 chiffres exactement (l'établissement, pas l'entreprise)."}, 'descripteur': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Descripteur', 'default': None, 'description': 'Code descripteur BOAMP (nomenclature DILA), alternative au CPV côté français.'}, 'buyer_keyword': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Buyer Keyword', 'default': None, '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': None, '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': None, 'description': 'Date limite de remise postérieure Ã\xa0 cette date ISO (AAAA-MM-JJ).'}, 'procedure_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Procedure Type', 'default': None, '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': None, 'description': 'Date limite de remise antérieure Ã\xa0 cette date ISO (AAAA-MM-JJ).'}, 'published_after': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Published After', 'default': None, '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': None, '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.'}}}

{'type': 'object', 'title': 'TenderSearchPage', 'properties': {'hint': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Hint', 'default': None, '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."}, 'page': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Page', 'default': None, 'description': 'Page rendue.'}, 'quota': {'anyOf': [{'type': 'object', 'additionalProperties': True}, {'type': 'null'}], 'title': 'Quota', 'default': None, 'description': 'Solde du palier anonyme : {restant, plafond}. Surveillez-le plutôt que de découvrir le plafond en le heurtant.'}, 'total': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Total', 'default': None, 'description': "Nombre total d'avis correspondant aux filtres, toutes pages confondues."}, 'results': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'title': 'Results', 'description': 'Les avis. Champs utiles : id (entier, Ã\xa0 passer Ã\xa0 get_tender), title, buyer_name, deadline, budget_max, region, source, source_url.'}, 'warning': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Warning', 'default': None, 'description': "Avertissement sur l'interprétation des résultats (filtre ignoré, jeu tronqué)."}, 'page_size': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Page Size', 'default': None, 'description': "Nombre d'avis par page."}, 'client_update': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Client Update', 'default': None, 'description': "Notice de mise Ã\xa0 jour, uniquement pour le paquet pip `tenderapi-mcp`. Sans objet pour ce serveur hébergé, qui n'a rien Ã\xa0 installer."}}, '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â\x9a\xa0ï¸\x8f 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` â\x80\x94 les champs non declares traversent au lieu d'etre effaces ;\n· tous les champs optionnels â\x80\x94 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.", 'additionalProperties': True}