Beta · Members
MCP SERVER
Connect Tabletop Library to the AI assistant you already use — Claude, ChatGPT, Grok, and more. Once connected, it can search games, check availability, and book tables for you, acting securely as you.
Setup instructions
Tabletop Library runs a remote MCP server. Point any MCP-capable client at this URL over Streamable HTTP — wherever it asks for a “custom connector” or “MCP server URL,” paste:
https://www.tabletoplibrary.com/api/mcpThe first time you connect, you’ll sign in to Tabletop Library and approve the connection on our own screen. You need an active membership; if a client asks for an OAuth client ID or secret, leave it blank — we register your app automatically.
The tabs above have step-by-step instructions for the most popular apps.
Want to try it before wiring up an app? The official MCP Inspector shows every step of the connection:
npx @modelcontextprotocol/inspectorChoose transport Streamable HTTP, enter the URL, click Connect, sign in, then List Tools and try one.
What it can — and can’t — do
Your assistant connects with your permission and acts strictly on your behalf. Here’s the line, plainly:
It can
- ✓Search the game library and recommend what to play, tuned to your taste.
- ✓Check availability and book a table — solo, with named guests, or open to other members.
- ✓Coordinate a game night when you can’t pin a time yet.
- ✓Browse what’s coming up and join open tables or waitlists.
- ✓See and respond to your invitations, and manage your “looking for gamers” status.
- ✓Change or cancel your own reservations.
- ✓Tell you your membership status and when it renews.
It won’t
- ✕Touch anyone else’s account — it only ever acts as you, on your data.
- ✕Spend money. It can’t charge your card, buy or cancel a membership, redeem a gift, or change billing. For those it hands you a link to do it yourself.
- ✕Do anything irreversible without checking first — cancelling a booking or moving its time always asks you to confirm before it commits.
- ✕Stay connected against your wishes — disconnect it any time from your AI app’s settings.
Examples
Once connected, just talk to your assistant naturally — it knows when to reach into Tabletop Library. A few ideas to get started:
Discover games
- “What should I play tonight for 4 people — something not too heavy?”
- “Tell me about Brass: Birmingham.”
- “Do you have any good 2-player games in the library?”
Find & book a table
- “Is there a table free Saturday evening for Wingspan?”
- “Book a table for me and 3 friends to play Catan this Saturday at 7pm.”
- “Open it up to other members — 2 to 5 players, any experience level.”
Coordinate a game night
- “Set up a Terraforming Mars night sometime next week when everyone's free.”
- “I'm flexible on the day — collect everyone's availability and we'll lock it in.”
Manage your bookings
- “What reservations do I have coming up?”
- “Move my Saturday booking to 8pm.”
- “Cancel my Friday reservation.”
Join others & be social
- “What's happening at the library this week that I could join?”
- “Join that open Catan table on Saturday.”
- “Do I have any pending invites? Accept the one from Sarah.”
- “I'm free weeknights after 6 — mark me as looking for a group.”
Your account & the venue
- “Am I still an active member? When does my membership renew?”
- “What are your hours and where are you located?”
Prefer raw data? Take the whole catalogue.
If you’d rather point a script at a file than talk to an MCP server, every game in the collection is available as one JSON document. No sign-in, no key, no rate limit — just fetch it.
https://www.tabletoplibrary.com/api/catalogWhat’s in it
- ✓Every game with a page on this site — roughly 1,400 entries.
- ✓Its BoardGameGeek id, so you can join our shelf to their data.
- ✓Where it lives: the call number, the shelf, and whether it’s oversized or kept behind the desk.
- ✓Player count, play time, minimum age, and our 1–5 weight rating.
- ✓How many copies the club owns to lend — zero means we catalogue it but don’t lend it — and the shelf price if we also sell it.
What isn’t
- ✕BoardGameGeek’s descriptions, cover art, ratings and rankings — that’s their data to give you, and the id in the feed is how you ask them for it.
- ✕What’s free to play right this minute. The feed is cached by the hour and would lie about it; ask the assistant or check the site instead.
- ✕Anything about members, staff, orders or what anything cost us.
The feed is rebuilt hourly, and it’s deliberately marked unstable — we may add, rename or drop fields while we see what people do with it, so write something that tolerates a changed shape. If you’re building on it, tell us and we’ll warn you before anything moves.
Troubleshooting
- The connector links, but tools come back “unauthorized” or empty.
- The connection is member-only. Make sure you signed in as an active member (the same account you use here), not a different login. Lapsed or non-member accounts can connect but can’t run tools.
- It asks for an OAuth client ID or secret.
- Leave those fields empty. Tabletop Library registers your assistant automatically — you don’t need to paste any credentials.
- The connection won’t establish at all.
- Double-check the URL is exactly
https://www.tabletoplibrary.com/api/mcpand that your client supports custom / remote MCP connectors over Streamable HTTP. Some plans require Developer mode (ChatGPT) or a paid tier. - It asks me to confirm before cancelling or moving a booking.
- That’s on purpose. Anything that can’t be easily undone — cancelling, or changing a reservation’s time — asks you to confirm first. Just say yes and it’ll go through.
This is a new feature in beta. If something doesn’t work or you have ideas, let us know.