Skip to main content
Glama
guest-suite-mcp

guest-suite-mcp

by GMartigny

guest-suite-mcp

Serveur MCP pour envoyer des demandes d'avis à Guest Suite depuis Claude (ou tout client MCP), via l'Experience API.

Une seule instance hébergée sur Vercel sert tout le monde : chaque utilisateur fournit son propre token Guest Suite, que le serveur utilise pour appeler Guest Suite sans jamais l'enregistrer.

Outils

Outil

Rôle

list_locations

Liste les établissements accessibles avec votre token et leur externalLocationId.

request_review

Crée le contact (ou réutilise l'existant pour le même e-mail / téléphone / établissement), puis lui rattache une expérience, ce qui déclenche la demande d'avis. Deux appels le même jour pour le même contact renvoient l'expérience existante.

update_contact

Modifie un contact déjà envoyé (prénom, nom, langue, données complémentaires). Seuls les champs passés sont modifiés ; null efface un champ.

update_experience

Modifie les données complémentaires d'une expérience déjà envoyée.

Related MCP server: GetExperience MCP Server

Utilisation

Il vous faut un token de l'Experience API (fourni par votre contact technique Guest Suite) et l'identifiant de votre établissement (externalLocationId). Si vous ne le connaissez pas, configurez d'abord le serveur sans ?location= et appelez l'outil list_locations.

Configuration du client MCP :

  • URL : https://<instance>.vercel.app/mcp (option : ?location=<votre-externalLocationId> pour l'établissement par défaut)

  • En-tête : X-AUTH-TOKEN: <votre-token> (ou Authorization: Bearer <votre-token>)

Le token n'est accepté que dans un en-tête, jamais dans l'URL.

  • claude.ai : Réglages → Connecteurs → Ajouter un connecteur personnalisé, avec l'URL ci-dessus et l'en-tête X-AUTH-TOKEN.

  • Claude Code :

claude mcp add --transport http guest-suite https://<instance>.vercel.app/mcp --header "X-AUTH-TOKEN: <votre-token>"

location est facultatif : sans lui, passez externalLocationId à chaque appel de request_review.

Sécurité

  • Le token voyage uniquement dans un en-tête HTTPS : il n'apparaît pas dans les URL ni dans les journaux d'accès.

  • Ce serveur ne stocke rien et ne journalise pas les tokens. Si vous préférez ne pas faire transiter votre token par une instance tierce, déployez la vôtre (ci-dessous).

Déployer sa propre instance

Deploy with Vercel

Aucune variable d'environnement n'est requise. Optionnel : GUEST_SUITE_API_URL pour viser une autre URL de l'API (par défaut https://experience.guest-suite.com).

Développement

npm install
npm test

Le point d'entrée Vercel est api/mcp.js (transport Streamable HTTP, sans session) ; les outils sont définis dans lib/mcp-server.js et le client Guest Suite dans lib/guest-suite.js.

Licence

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Exposes the Wealthbox CRM API to MCP-enabled clients, enabling operations on contacts, tasks, events, notes, opportunities, projects, workflows, and more.
      51
      32 npm
      4
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables MCP clients to search hotel availability, validate rates, create and retrieve bookings, simulate or execute cancellations, and browse destinations and hotel content through the Hotelbeds Booking and Content APIs. Includes a surface-and-reconfirm booking flow that re-validates live prices with a tolerance before confirming.
      9
      MIT