Developer docs

MCP quickstart

Connect Claude, ChatGPT or VS Code to mcp.bookdineplay.com, sign in, find a venue and book a table by asking — about five minutes, no API key.

You will connect an AI assistant to BookDinePlay and book a table by asking for it. There is no API key and nothing to install: you sign in with your BookDinePlay account and the assistant gets exactly your permissions. You need an account (a guest account is enough) and an assistant that supports MCP.

1. Add the server

The server lives at one address:

https://mcp.bookdineplay.com

Add it as a custom connector or MCP server in your client; Connect your assistant has the click path for Claude and ChatGPT. For Claude Code and VS Code it is one command or one file:

Claude Code:

claude mcp add --transport http bookdineplay https://mcp.bookdineplay.com

Run /mcp inside claude, pick bookdineplay and authenticate. VS Code, in .vscode/mcp.json:

{
  "servers": {
    "bookdineplay": {
      "type": "http",
      "url": "https://mcp.bookdineplay.com"
    }
  }
}

Save it, run MCP: List Servers, start bookdineplay and sign in when asked.

2. Sign in

Your client opens a BookDinePlay sign-in page in the browser. Sign in with your account. A client asks for bookdineplay:read for tools that only read and bookdineplay:write for tools that change data; you may grant read only and still search and check availability.

3. Check who you are

Ask the assistant:

Who am I on BookDinePlay?

It calls the whoami tool and answers with your role and, for a venue operator, your venue and plan. A person without a venue is told so, which is correct for a guest.

4. Find a venue and check availability

Find a venue called The Neon Tap and show me tables for four tomorrow evening.

The assistant calls guest_venues_search for the venue's slug, then guest_availability for the free start times. Venues appear in the search only when their operator chose to be listed in the BookDinePlay app, and demo-sportsbar ("The Neon Tap") is a fictional demo venue you can always try.

5. Book it

Book the 7 pm table for Jana Berger, jana@example.com.

The assistant should repeat venue, date, time, party size and contact details and wait for your yes before it calls guest_create_booking. The answer carries the booking reference and status. The confirmation e-mail goes to the address you gave, and it holds the link to change or cancel the booking: the assistant never sees that link and cannot cancel for you.

If the call times out, the assistant retries with the same request_id, which returns the original booking instead of making a second one. A guest can make 10 bookings an hour through an assistant.

If you run a venue

Sign in with your operator account and the same server offers the console's work as tools. Try:

Give me today's briefing for my venue.

The prompt daily_briefing summarises today's bookings, unpaid deposits and the next arrivals, reading only. Anything hard to undo, such as cancelling a booking or refunding a deposit, first shows a preview and waits for your confirmation (Confirming changes).

Check that it worked

The reference from step 5 shows up in the venue's reservation list, and in the e-mail you received. For the demo venue there is nothing to clean up; a real booking you made while testing is cancelled with the link in its e-mail.

If it does not work

  • The client says it cannot register or authenticate. The server does not support dynamic client registration: a client that can only register itself on the fly is refused. Use one of the clients listed in Connect.
  • The assistant says it has no BookDinePlay tools. The connector is added but not enabled for this conversation; enable it from the tools menu.
  • A change is refused. The same rule as in the console: your role, your plan or a suspended account decides, and the message is the console's.
  • A tool answers that you hit a limit. Each person may make 120 tool calls a minute, 30 of which may change data. The message says how long to wait.

Next steps