Tavern

[Tavern]

Tavern MCP server

Your tabletop RPG campaigns, as tools. Tavern keeps a TTRPG group's campaign in one place: dated sessions with everybody's notes, a wiki of the people, places and things in them, maps with pins, character sheets with live hit points and spell slots, a combat tracker, and each player's private notes. This server lets Claude, Cursor, VS Code or any MCP client work on all of it, acting as you at the tables you already sit at.

This repository holds the listing only: this README, the registry entry, the Gemini CLI extension manifest and the icon. The server is hosted by Tavern, so there is nothing to install or run.

What you can ask it

• "Recap Thursday's session from everybody's notes."
• "Start a wiki page for the ferryman at Hollowmere and link him in tonight's notes."
• "Ilsa takes 9 and she's prone."
• "Which threads from the last three sessions have we dropped?"
• "Set up a fight: the party against the three toll-bridge bandits."
• "What has my character got left?"

You need a free Tavern account and a campaign. Sign up at gettavern.app/signin.

Connect it

Claude

In Settings, under Connectors, add a custom connector and paste https://gettavern.app/mcp. Claude opens a Tavern page asking you to approve it.

Claude Code

claude mcp add --transport http tavern https://gettavern.app/mcp

Then run /mcp inside a session to sign in.

Cursor

Add it to ~/.cursor/mcp.json. Cursor asks you to sign in the first time it connects.

{  "mcpServers": {    "tavern": {      "url": "https://gettavern.app/mcp"    }  }}

VS Code

Add it to .vscode/mcp.json in a workspace, or to your user settings.

{  "servers": {    "tavern": {      "type": "http",      "url": "https://gettavern.app/mcp"    }  }}

Gemini CLI

This repository is a Gemini CLI extension. Install it, then run /mcp auth tavern inside Gemini CLI to sign in.

gemini extensions install https://github.com/jakehandy/tavern-mcp

Anything else

Any client that speaks Streamable HTTP finds the sign-in on its own. A client that only takes a header can send a personal API key instead (make one in Tavern under Settings, API and assistants):

{  "url": "https://gettavern.app/mcp",  "headers": { "Authorization": "Bearer tvn_your_key" }}

Signing in

The first time a client connects, the server answers 401 with a pointer to its sign-in, and the client opens Tavern's own consent page. You sign in there, see what the app is asking for, and may grant less than it asked.

• OAuth 2.1 for public clients: PKCE (S256), no client secret. A client registers itself, either through dynamic client registration (RFC 7591) or by being its own Client ID Metadata Document. Access tokens last an hour; refresh tokens rotate on every use.
• Scopes stack: read, then write, then delete. A client only sees the tools its scopes allow.
• Metadata: /.well-known/oauth-protected-resource/mcp and /.well-known/oauth-authorization-server. The full story is at gettavern.app/auth.md.
• Revoking: every key and connected app is listed under Settings, API and assistants, with when it was last used, and goes the moment you remove it.

A connected app is you and no more. It reaches the tables you sit at with the seat you hold at each, so a player's connection can't do the GM's job, and nobody's private notes are served to anyone but their author.

Tools

117 tools in fourteen groups as of November 2026. The server is the source of truth: your client lists exactly the tools your sign-in allows, and gettavern.app/developers always shows the current catalog with every argument. Every tool carries a title and read-only or destructive hints.

Campaigns are named by slug, sessions by their play date (YYYY-MM-DD), and wiki pages and characters by slug. Start with list_campaigns.

To load fewer tools, add ?toolsets= to the address with any of the group keys (account, campaigns, sessions, wiki, notes, messages, map, characters, builder, combat, lorekeeper, memorial, dice, updates) or the preset core. For example https://gettavern.app/mcp?toolsets=core,characters.

You

Who the credential is, your public profile, your invitations and feedback.

Campaigns and seats

Make a table, fill its seats, change its look, leave one.

Session journal

Play dates and the notes everybody writes on them.

Campaign wiki

Pages for every person, place and thing, their history, and search across the lot.

My Notes

Your own sealed notes, and everything you have written at a table.

Messages

Direct conversations between the people at one table, and the GM's thread to all of them.

Map

The table's maps and the pins on them, shared and private.

Characters

Sheets, hit points, conditions, spell slots, items, homebrew and companions.

Character builder

Make a character from scratch, or design the sheet itself.

Combat Tracker

Run a battle: the roster, initiative, turns, health and the summary.

Lorekeeper

Hand a session's notes to Lorekeeper and watch the write-up land.

Memorial Pages

Close the book on a campaign and read its memorial.

Dice

Roll any dice on the server, and choose how your dice look in the app.

Notifications and progress

What's new at your tables, and how far you've come.

Also available as a REST API

The same catalog is a REST API at https://gettavern.app/api/v1, described at /openapi.json and in prose at /api-docs.md.

curl https://gettavern.app/api/v1/campaigns -H "Authorization: Bearer tvn_your_key"

Links

• Developers: gettavern.app/developers
• Privacy Policy: gettavern.app/privacy
• Terms of Service: gettavern.app/terms
• Support: [email protected]

License

The files in this repository are MIT licensed (see LICENSE). The Tavern name and mark are not covered by it. The Tavern service itself is governed by its Terms of Service.