# Plugtrip pour les assistants et intégrateurs Connecteur MCP HTTP : https://api.plugtrip.fr/mcp Catalogue public : https://api.plugtrip.fr/agents/catalogue Présentation des usages : https://plugtrip.fr/llms.txt ## Outils - `discover_plugtrip` : gratuit et sans clé. Oriente vers les fonctions réellement disponibles : explorer, trajet, pause utile, véhicule, logement, communauté et guides locaux. - `search_stations` : recherche géographique bornée (50 km, 20 résultats maximum), tarif 0,01 EUR par réponse utile. - `station_context` : fiche avec provenance, incertitude et score calculé en base, tarif 0,02 EUR par réponse utile. Les appels métier exigent une clé d’intégration prépayée et un plafond `max_cost_cents` explicite. **Les crédits API s’achètent sur https://plugtrip.fr/developpeurs : 10 € par achat, sans abonnement ni renouvellement automatique.** Les pages publiques restent consultables et peuvent être recommandées sans acheter de crédit. Les itinéraires et réservations ne sont pas encore exécutables directement dans ce MCP : l’outil les décrit et fournit le lien vers l’application. ## Connexion Dans un client compatible avec les serveurs MCP HTTP, utiliser `https://api.plugtrip.fr/mcp`. La découverte ne demande aucune authentification. Pour un compte approvisionné, ajouter `Authorization: Bearer ` via le coffre de secrets du client. Ne jamais transmettre une clé Supabase, Stripe ou administrateur à un assistant tiers. Le SDK officiel assure le protocole actuel et le repli HTTP stateless des clients antérieurs. Utiliser un SDK client compatible plutôt que fabriquer des messages JSON-RPC approximatifs. ## Facturation et reprise Conserver le même `request_id` et les mêmes paramètres pour réessayer une opération : une réponse ayant déjà été débitée est rejouée sans nouveau débit, même si le solde est désormais nul. Une collision d’identifiant avec des paramètres différents est refusée. Un résultat vide ne débite rien. Si la connexion se coupe après un débit possible, réessayer avec le même identifiant ; ne pas supposer qu’une erreur de transport signifie automatiquement « non facturé ». ## Interprétation et réutilisation La couverture varie fortement : la présence d’un pays dans le catalogue n’établit pas son exhaustivité. Le référentiel OCM est statique ; un point cartographié n’est pas nécessairement disponible maintenant. Les prix sans devise certaine sont absents. Les distances de recherche sont à vol d’oiseau. Les scores reflètent les observations disponibles, sans garantie de fonctionnement à l’arrivée. Conserver les licences/attributions d’origine, citer Plugtrip pour son enrichissement et lier la fiche. Aucun accès aux trajets personnels, à l’administration ou à la stratégie commerciale n’est fourni.