accueil / serveurs / Recherche & Web / com.fulfiller/agentic-commerce-api
com.fulfiller/agentic-commerce-api
serveur MCP (Model Context Protocol) · agentic-commerce-api 0.1.3
Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur.
Est-ce que com.fulfiller/agentic-commerce-api est sûr ?
Au dernier audit MCP Hub, le serveur MCP « com.fulfiller/agentic-commerce-api » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.
Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.
Les 11 outils
- create_cart≈ 652 tokens
Crée un panier anonyme, éventuellement avec ses premières lignes (cotées à l’ajout, prix FIGÉ). Un panier n’est PAS une commande : rien n’est engagé, et le total est HT — hors TVA et hors port. Chaque ligne désigne le produit par son productId (rendu par search_products) ; le sku est facultatif. `unitPriceHt` et `lineTotalHt` sont promotion déduite. Renvoie le panier complet : n’appelez pas get_cart juste après.
Paramètres, retour & exemple (2)
Paramètreslines· array · optionnel
Lignes initiales (0 à 5). Un panier vide est légitime.idempotencyKey· string · optionnel
UUID optionnel. Rejouer le MÊME appel avec la même clé renvoie le panier déjà créé au lieu d’en créer un second : à utiliser si vous devez réessayer après une erreur.
Exemple d'appel{"name": "create_cart", "arguments": {"lines": [], "idempotencyKey": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - delete_cart≈ 154 tokens
Supprime DÉFINITIVEMENT un panier et toutes ses lignes. Irréversible. Pour retirer une seule ligne, utilisez update_cart avec `remove`.
Paramètres, retour & exemple (1)
ParamètrescartId· string · requis
Identifiant du panier (UUID) rendu par create_cart. C’est une CAPACITÉ : qui le détient accède au panier — ne le publiez pas hors de la conversation qui l’a créé.
Exemple d'appel{"name": "delete_cart", "arguments": {"cartId": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_cart≈ 293 tokens
Renvoie le panier tel que FIGÉ à l’ajout : aucune re-cotation à la lecture. `pricedAt` par ligne et `expiresAt` donnent l’âge des prix — au-delà, re-cotez avec quote_product. Sert à RELIRE un panier existant (plus tard dans la conversation, ou quand l’utilisateur demande à le revoir) : inutile juste après create_cart ou update_cart, qui renvoient déjà le panier complet.
Paramètres, retour & exemple (2)
ParamètrescartId· string · requis
Identifiant du panier (UUID) rendu par create_cart. C’est une CAPACITÉ : qui le détient accède au panier — ne le publiez pas hors de la conversation qui l’a créé.display· boolean · optionnel
Afficher la carte du panier à l’utilisateur, dans les clients qui affichent les interfaces MCP Apps. `false` pour un appel intermédiaire qu’il n’a pas besoin de voir (vérifier avant de répondre) ; omis ou `true` dès qu’il doit voir le résultat. Sans effet sur le résultat lui-même.
Exemple d'appel{"name": "get_cart", "arguments": {"cartId": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_product_configuration≈ 233 tokens
Renvoie les options configurables d’un produit (quantités, délais, valeurs, tailles) et leurs valeurs disponibles. À appeler AVANT validate_selection ou quote_product : chez Fulfiller, un produit n’est pas un SKU à prix figé mais un espace de configuration. `presets` : configurations prêtes à l’emploi, cotables telles quelles via `selection.preset`. Les dépendances entre options (une finition qui exige le recto verso…) n’y figurent pas : validate_selection les révèle (`enabledOptions`).
Paramètres, retour & exemple (1)
ParamètresproductId· integer · requis
Identifiant rendu par search_products.
Exemple d'appel{"name": "get_product_configuration", "arguments": {"productId": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_product_details≈ 354 tokens
Fiche PIM d’un produit : descriptions, points clés, questions fréquentes, contraintes de fichier (fond perdu, résolution, marges, mode colorimétrique) et ressources (visuels, gabarits, consignes techniques). À utiliser pour DÉCRIRE un produit ou aider à préparer un fichier. Ne renvoie aucun prix — pour coter, passez par quote_product ; un prix écrit dans les textes de la fiche (« Dès 14.5 € ») est souvent périmé, ne l’annoncez pas. Les vidéos sont dans `videos`, pas dans `images`. Fournissez exactement un argument (`productId`, `sku` ou `url`). Les champs absents ne sont pas renseignés au PIM ; la FAQ est rare.
Paramètres, retour & exemple (3)
Paramètressku· string · optionnel
SKU exact, tel que rendu par search_products ou resolve_product.url· string · optionnel
URL d’une fiche produit de www.fulfiller.com (http, sans www ou relative acceptées). Une page catégorie est refusée : cherchez alors avec search_products.productId· integer · optionnel
Identifiant rendu par search_products (alias : `zeloomProductId`).
Exemple d'appel{"name": "get_product_details", "arguments": {"sku": "texte", "url": "texte", "productId": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - quote_by_quantity≈ 462 tokens
Grille de devis pour plusieurs paliers de quantité en UN appel — la bonne façon de répondre à « combien pour 100, 250, 500 ? ». Prix de chaque palier : `devis.finalPriceHt` (promotion déduite). Même règle que quote_product, palier par palier : hors plage → erreur localisée sans invalider les autres ; hors du pas → coté au palier commandable le plus proche, que `quotedQuantity` indique (le prix porte sur cette quantité, pas sur le palier demandé).
Paramètres, retour & exemple (3)
ParamètresproductId· integer · requis
Identifiant rendu par search_products.selection· object · requis
Sélection d’options : même forme et mêmes règles que `selection` de quote_product (codes ou libellés, défauts du produit, `preset`, tailles).quantities· array · requis
Paliers de quantité à coter (1 à 20).
Exemple d'appel{"name": "quote_by_quantity", "arguments": {"productId": 1, "selection": {}, "quantities": []}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - quote_product≈ 974 tokens
Devis RÉEL pour une sélection : prix HT calculé par le moteur de tarification (jamais lu dans une table de SKU), devise, délai, promotion. C’est le seul prix ferme. Le prix à annoncer est `devis.finalPriceHt` (promotion déduite) ; `devis.priceHt` est le prix catalogue, BARRÉ quand `devis.promo` est présent. Pour dire à l’utilisateur ce qui est coté, citez `summary` (libellés lisibles). Si `requiresReview` vaut `true`, le prix porte sur la sélection décrite par `summary`, pas sur la demande : les lignes dont le `status` n’est ni AS_REQUESTED ni DEFAULT disent ce qui a changé.
Paramètres, retour & exemple (2)
ParamètresproductId· integer · requis
Identifiant rendu par search_products.selection· object · requis
Sélection d’options. Une option non précisée prend la valeur de la préselection par défaut du produit (`preselections` de get_product_configuration), comme sur le site ; `{"options": []}` cote donc la configuration par défaut. La résolution est TOLÉRANTE : code ou libellé, sans souci de casse ni d’accents ; une valeur partielle est retenue si une SEULE valeur la contient (« vinyle » → « Impression sur vinyle adhésif contrecollé », « A5 » → « 14,8 x 21 cm (A5) »), ou par ses mesures (« 148x210 mm ») ; parmi plusieurs, la plus proche est retenue et signalée, ou la SEULE compatible avec le reste de la sélection (« soft touch » sur une carte recto verso). Ce qui n’est pas retenu tel quel est signalé dans `alerts` et dans `summary`.
Exemple d'appel{"name": "quote_product", "arguments": {"productId": 1, "selection": {}}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - resolve_product≈ 277 tokens
Convertit une identité EXACTE en identité complète (productId, sku, nom, url) : `sku` (lisible dans le JSON-LD d’une page produit), `url` de la page, ou `productId`. À PRÉFÉRER à search_products dès que vous tenez l’un des trois — la recherche est approximative, celle-ci ne l’est pas. Fournissez exactement un argument.
Paramètres, retour & exemple (3)
Paramètressku· string · optionnel
SKU exact (ex. « POSTER_PHOTO_SUR_MESURE »).url· string · optionnel
URL d’une fiche produit de www.fulfiller.com (http, sans www ou relative acceptées). Une page catégorie est refusée : cherchez alors avec search_products.productId· integer · optionnel
Identifiant rendu par search_products (alias : `zeloomProductId`).
Exemple d'appel{"name": "resolve_product", "arguments": {"sku": "texte", "url": "texte", "productId": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - search_products≈ 433 tokens
Recherche plein-texte dans le catalogue Fulfiller et renvoie des produits COTABLES (productId, sku, url, et le prix d’appel du site quand il en affiche un). Point d’entrée obligatoire : les autres outils travaillent sur le productId renvoyé ici. `startingPrice` est le prix d’appel AFFICHÉ par le site : indicatif, parfois périmé ou propre à une configuration, ni plancher garanti ni prix ferme — seul quote_product l’est. Sa base (TOTAL, UNIT, PER_SQUARE_METER) change d’un produit à l’autre : ne comparez jamais deux bases différentes. Pour le citer, utilisez `startingPrice.displayLabel`. Un résultat peut lister dans `alsoListedAs` d’autres fiches du site qui vendent le MÊME produit : ne les présentez pas comme des produits distincts.
Paramètres, retour & exemple (2)
Paramètresq· string · requis
Un ou deux mots produit en français (ex. « carte de visite », « bâche publicitaire »), pas une phrase : le moteur exige TOUS les mots. Une phrase qui ne trouve rien est réessayée une fois sans ses mots de contexte (`relaxedQuery` le signale). Les dimensions (« 300x100 »), les mesures (« 350g », « 1 000 ex ») et une quantité en tête de requête (« 500 cartes ») sont ignorées : elles se précisent à la cotation. Il faut au moins un mot de 3 lettres ou plus : une requête sans mot exploitable (« ab », « 50 ») est refusée.limit· integer · optionnel
Nombre de résultats souhaité (1 à 24).
Exemple d'appel{"name": "search_products", "arguments": {"q": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - update_cart≈ 702 tokens
Applique, DANS CET ORDRE : retraits (`remove`), changements de quantité (`update`, sans re-cotation), puis ajouts (`add`, cotés). Renvoie le panier complet après application : n’appelez pas get_cart juste après.
Paramètres, retour & exemple (4)
Paramètresadd· array · optionnel
Nouvelles lignes, cotées à l’ajout.cartId· string · requis
Identifiant du panier (UUID) rendu par create_cart. C’est une CAPACITÉ : qui le détient accède au panier — ne le publiez pas hors de la conversation qui l’a créé.remove· array · optionnel
`lineId` des lignes à retirer.update· array · optionnel
Nouveau nombre de LOTS pour des lignes existantes (prix unitaire figé inchangé).
Exemple d'appel{"name": "update_cart", "arguments": {"cartId": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - validate_selection≈ 437 tokens
Résout une sélection tolérante en codes canoniques et vérifie sa COMMANDABILITÉ, sans renvoyer de prix. Sert à corriger une sélection avant de la coter. `summary` décrit en clair la sélection retenue, et son `status` dit pour chaque option si la valeur est celle demandée, un défaut, ou un changement. `requiresReview` à `true` : la sélection retenue diffère de celle demandée, `alerts` dit pourquoi. `enabledOptions` liste, pour chaque option, les valeurs activables AVEC cette sélection : c’est là que se lisent les dépendances entre options.
Paramètres, retour & exemple (2)
ParamètresproductId· integer · requis
Identifiant rendu par search_products.selection· object · requis
Sélection d’options : même forme et mêmes règles que `selection` de quote_product (codes ou libellés, défauts du produit, `preset`, tailles).
Exemple d'appel{"name": "validate_selection", "arguments": {"productId": 1, "selection": {}}}Exemple de retour{"content": [{"type": "text", "text": "…"}]}
C'est votre serveur ?
Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».