Agents IA : interroger le catalogue

Les outils

• Rechercher des sorties mesloisirs_search_experiences

  Trouve des sorties et activités de loisirs réelles en France (escape game, canyoning, spa, atelier, visite, restaurant insolite…) autour d'un lieu, depuis le catalogue MesLoisirs (17 000 adresses vérifiées). Lieu OBLIGATOIRE : `city` (nom de commune) ou `latitude`+`longitude`. Filtres : `activity` (nom ou slug, voir mesloisirs_list_activities), `q` (mots-clés), `audience` (solo, couple, family, friends, group), `interests` (axes : playful, unusual, adrenaline, food, cultural, wellbeing, terroir, nature, nautique, premium, rainy, heat), `ages` (âges des participants), `budget_max` (€ par personne, signal de tri, jamais un filtre), `radius_km` (défaut 30, max 100). Chaque résultat porte l'URL de sa fiche et un bloc `reservation` (comment réserver). Jamais d'email ni de téléphone. Lecture seule.

• Détail d'une sortie mesloisirs_get_experience

  Détail complet d'une sortie MesLoisirs trouvée par mesloisirs_search_experiences : description entière, tarifs (formules) et options, prochaines dates s'il s'agit d'un événement, atouts vérifiés, et le bloc `reservation` (comment réserver : lien, place de marché, sur la fiche, office de tourisme). Paramètre : `id` (numérique) ou `slug` (fin de l'URL /xp/{slug}). Jamais d'email ni de téléphone : renvoyez vers `url`. Lecture seule.

• Activités du catalogue mesloisirs_list_activities

  Liste les activités du catalogue MesLoisirs (escape game, canyoning, spa, œnologie, parc d'attractions…) avec leur slug à passer en `activity` à mesloisirs_search_experiences, le nombre d'adresses publiées en France, l'âge minimum, les publics et les envies qu'elles servent le mieux. Filtre optionnel `q` (mot du titre). À appeler quand l'activité demandée ne tombe pas sur un nom évident. Lecture seule.

Exemple d'appel

Un escape game près de Rennes, pour une sortie en famille avec un enfant de 8 ans :

POST https://mesloisirs.fr/mcp/search
Content-Type: application/json
Accept: application/json, text/event-stream

{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
 "params": {"name": "mesloisirs_search_experiences",
            "arguments": {"city": "Rennes", "activity": "escape game",
                          "audience": "family", "ages": [8, 40]}}}

Chaque résultat porte `url` (la fiche), `distance_km`, `prix` quand le tarif est connu, et un bloc `reservation` dont `mode` vaut `lien` (réserver sur le site du prestataire), `place_de_marche` (réserver chez un tiers nommé), `sur_la_fiche` (téléphone et formulaire sur la fiche) ou `office_de_tourisme` (accès libre).

Les règles

• Lecture seule : aucun outil n'écrit, ne réserve ni ne paie.
• Ni l'email ni le téléphone d'un prestataire ne sont servis. La fiche les porte, avec un formulaire pour lui écrire.
• Une recherche exige un lieu (nom de commune ou coordonnées) ; sans lieu, l'outil le demande au lieu de deviner.
• 20 résultats par page au plus, 5 pages au plus : ce serveur n'est pas un export du catalogue.
• 30 appels par minute et par adresse, 300 pour tout le site. Un refus (429) dit combien de secondes attendre : respectez-le, une recherche suffit par question.
• Citez l'URL de la fiche dans vos réponses, et MesLoisirs comme source. N'inventez ni tarif, ni horaire, ni disponibilité : si le serveur ne les donne pas, dites-le.

Brancher un assistant

• Claude : Paramètres › Connecteurs › Ajouter un connecteur personnalisé, avec l'adresse du serveur. Aucune clé à saisir.
• ChatGPT : en mode développeur, ajouter un serveur MCP distant avec la même adresse.
• Muse et les autres agents personnels : connecteur personnalisé sur l'adresse du serveur (streamable HTTP, sans authentification).
• Registre MCP officiel : le serveur y est déclaré sous le nom fr.mesloisirs/recherche.

Données, confidentialité, contact

Les données viennent du catalogue MesLoisirs : fiches vérifiées, décrites à partir du site officiel de chaque prestataire. Chaque appel est journalisé 60 jours (outil, logiciel client, nombre de résultats, empreinte d'adresse non réversible), jamais le texte de la requête.

Politique de confidentialité · Conditions d'utilisation · Nous écrire