G Guest

What g-guest MCP server does

The g-guest MCP server exposes G-Guest's booking system to MCP-compatible assistants. It supports reservations at real local businesses, including restaurant tables, appointments, and class places. An assistant can search for bookable businesses, retrieve a business profile, inspect available times for a date and party size, and submit a reservation.

Bookings are real reservations handled by the venue through G-Guest. A successful booking is confirmed immediately and appears in the venue's own panel. The service does not require an API key or user account for reading or booking, but each booking must include the guest's name, phone number, and email address.

How it works

The hosted MCP endpoint is available at https://g-guest.app/api/mcp. It accepts streamable HTTP requests using JSON-RPC 2.0 over POST. Clients that support this transport can connect directly without installing a local package.

For clients that expect a command-based stdio server, the repository provides a small proxy installed and run with npx -y g-guest-mcp. The proxy forwards MCP requests to the hosted endpoint and returns the responses; booking rules, availability calculations, and reservation data remain in the G-Guest application rather than running locally.

The g-guest MCP server supports a language value on bookings using ISO 639-1 codes: en, nl, de, fr, es, it, id, or bg. English is used by default for booking pages, confirmations, reminders, and management pages.

Setup and configuration

A direct connection uses the hosted URL and requires no local installation or authentication. For a stdio client, configure the server with npx:

{
  "mcpServers": {
    "g-guest": {
      "command": "npx",
      "args": ["-y", "g-guest-mcp"]
    }
  }
}

Set GGUEST_MCP_URL when the proxy should forward requests to a different endpoint. The proxy obtains its tool definitions from the live service at startup. If it cannot reach the network, it uses the repository's generated tools.json fallback.

Tools and capabilities

The g-guest MCP server exposes these tools:

• search finds bookable businesses by name or slug.
• fetch returns one business's services, hours, and booking information.
• get_business retrieves the same business card using a slug.
• check_availability returns bookable times for a date and party size.
• create_booking creates a confirmed reservation.

The repository also provides a live endpoint that can be inspected with a JSON-RPC tools/list request. Demo venues named demo-studio and demo are available for testing; reservations made against them are still real but belong to the service's own businesses.

Limitations and notes

This repository contains the stdio forwarding proxy, not the booking engine. Availability decisions, slot calculations, guest records, and reservation handling remain inside G-Guest. The server exposes businesses that are G-Guest customers or trial users, and the venue's own names and content are not translated when a booking language is selected.