Développeurs

Un seul serveur MCP pour les rendez-vous locaux.

OpenBookings parle le Model Context Protocol en Streamable HTTP. Pointez votre agent vers l’adresse ci-dessous : il pourra chercher des disponibilités près d’un lieu, en réserver une, retrouver une réservation et l’annuler. Aucune clé n’est nécessaire.

Point d’accès

openbookings.ai/mcp

Transport : Streamable HTTP, sans état. Chaque POST transporte un seul message JSON-RPC.

Outils

search_availability: Trouve les 3 meilleures disponibilités près d’une ville, d’un quartier ou d’un point. Accepte du texte libre en français ou en anglais pour le service et le moment. Chaque résultat a un opening_id.
book_slot: Bloque la disponibilité pendant l’écriture dans l’agenda de l’entreprise, puis la confirme. Envoyez une idempotency_key unique par tentative et réutilisez-la en cas de nouvel essai. Il faut un nom et un courriel ou un téléphone.
get_booking: Retourne une réservation à partir du code de confirmation et du courriel ou du téléphone utilisé.
cancel_booking: Annule une réservation avec le même code et les mêmes coordonnées. L’entreprise peut fixer un délai minimal avant l’heure du rendez-vous.

Comment fonctionne le classement

La recherche garde la première disponibilité de chaque entreprise, puis trie par heure de début par tranches de 15 minutes, ensuite par distance, puis par heure exacte. La recherche du site utilise le même classement : vos utilisateurs voient ce que voit votre agent.

Limites

Chaque adresse IP a droit à 60 requêtes par minute. Au-delà, le serveur répond HTTP 429 avec un en-tête Retry-After. Les recherches regardent au plus 14 jours à l’avance et retournent au plus 3 disponibilités.

Erreurs

Les erreurs d’outil reviennent comme un résultat avec isError et un corps JSON qui contient un code et un message. Les codes sont :

INVALID_INPUT
SLOT_NOT_FOUND
SLOT_UNAVAILABLE
NOT_BOOKABLE
INVALID_CUSTOMER
INVALID_PARTY_SIZE
IDEMPOTENCY_CONFLICT
BOOKING_NOT_FOUND
ALREADY_CANCELLED
TOO_LATE_TO_CANCEL
PROVIDER_ERROR

Essayez avec curl

curl -s https://openbookings.ai/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
    "name":"search_availability",
    "arguments":{"service":"haircut","city":"montreal","near":"Mile End",
                 "time_window":"saturday after 2pm"}}}'

{
  "mcpServers": {
    "openbookings": { "url": "https://openbookings.ai/mcp" }
  }
}

Les fiches marquées données d’exemple sont des entreprises inventées pour tester le parcours. Les réservations faites chez elles n’arrivent à aucune vraie entreprise.

Un résumé en texte brut pour les robots et les agents se trouve à /llms.txt.

Vous voulez l’utiliser vous-même? Ajoutez-le à votre appli d’IA →