Tavern MCP server
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
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.
Server address |
|
Transport | Streamable HTTP (remote, stateless) |
Sign-in | OAuth 2.1 with PKCE, or a personal API key |
Registry name |
|
Docs |
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.
Related MCP server: foundry-cli
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/mcpThen 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-mcpAnything 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, thenwrite, thendelete. A client only sees the tools its scopes allow.Metadata:
/.well-known/oauth-protected-resource/mcpand/.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.
Tool | What it does | Scope |
| Who am I | read |
| List my campaigns | read |
| Answer an invitation | write |
| Get my profile settings | read |
| Change my profile settings | write |
| Get my subscription | read |
| Read a public profile | read |
| Send feedback | write |
| List my feedback | read |
Campaigns and seats
Make a table, fill its seats, change its look, leave one.
Tool | What it does | Scope |
| Create a campaign | write |
| Get a campaign | read |
| Change a campaign's look (GM only) | write |
| List the seats | read |
| Add a seat (owner only) | write |
| Remove a seat (owner only) | delete |
| Get my seat | read |
| Change my seat | write |
| Leave a campaign | delete |
Session journal
Play dates and the notes everybody writes on them.
Tool | What it does | Scope |
| List sessions | read |
| Read a session | read |
| Log a session (GM only) | write |
| Rename or move a session (GM only) | write |
| Add a note to a session | write |
| Edit a session note | write |
| Delete a session note | delete |
Campaign wiki
Pages for every person, place and thing, their history, and search across the lot.
Tool | What it does | Scope |
| List wiki pages | read |
| Read a wiki page | read |
| Read a page's history | read |
| Create a wiki page | write |
| Edit a wiki page | write |
| Delete a wiki page (GM only) | delete |
| Mark a page as somebody's character | write |
| Search a campaign | read |
My Notes
Your own sealed notes, and everything you have written at a table.
Tool | What it does | Scope |
| List my private notes | read |
| Write a private note | write |
| Edit a private note | write |
| Delete a private note | delete |
| Read a private note's history | read |
| Everything I wrote here | read |
Messages
Direct conversations between the people at one table, and the GM's thread to all of them.
Tool | What it does | Scope |
| List my conversations | read |
| Start a conversation | write |
| Read a conversation | read |
| Send a message | write |
| Mark a conversation read | write |
| Delete a message | delete |
Map
The table's maps and the pins on them, shared and private.
Tool | What it does | Scope |
| List maps | read |
| List a map's pins | read |
| List my private pins | read |
| Drop a pin | write |
| Move or edit a pin | write |
| Delete a pin | delete |
| Rename or reorder a map (GM only) | write |
| Take a map down (GM only) | delete |
Characters
Sheets, hit points, conditions, spell slots, items, homebrew and companions.
Tool | What it does | Scope |
| List characters | read |
| Read a character | read |
| The party at a glance (GM only) | read |
| Change hit points, conditions or slots | write |
| Replace what has been spent | write |
| Add a character from Beyond | write |
| Sync a character from Beyond | write |
| Show or hide a character on the Master HUD (GM only) | write |
| Make a character my primary (holder only) | write |
| Mark a character as fallen | write |
| Bring a character back | write |
| Delete a character | delete |
| Hand a character to a seat (GM only) | write |
| Set a character's portrait | write |
| Add a custom item | write |
| Edit a custom item | write |
| Delete a custom item | delete |
| Add a homebrew card | write |
| Edit a homebrew card | write |
| Delete a homebrew card | delete |
| Add a companion | write |
| Edit a companion | write |
| Change a companion's hit points | write |
| Delete a companion | delete |
Character builder
Make a character from scratch, or design the sheet itself.
Tool | What it does | Scope |
| Make a character here | write |
| Edit a character made here | write |
| List my half-made characters | read |
| Start a character draft | write |
| Read a character draft | read |
| Save a character draft | write |
| Finish a character draft | write |
| Throw a draft away | delete |
| List the table's sheet designs | read |
| Keep a sheet design at the table | write |
| Take a sheet design off the table | delete |
Combat Tracker
Run a battle: the roster, initiative, turns, health and the summary.
Tool | What it does | Scope |
| Who can join a battle (GM only) | read |
| List battles (GM only) | read |
| Set up a battle (GM only) | write |
| Read a battle (GM only) | read |
| Rename a battle or set the turn (GM only) | write |
| Put somebody in a battle (GM only) | write |
| Change somebody in a battle (GM only) | write |
| Damage or heal somebody in a battle (GM only) | write |
| Take somebody out of a battle (GM only) | delete |
| Start a battle (GM only) | write |
| Next turn (GM only) | write |
| End a battle (GM only) | write |
| Delete a battle (GM only) | delete |
Lorekeeper
Hand a session's notes to Lorekeeper and watch the write-up land.
Tool | What it does | Scope |
| Lorekeeper's queue (GM only) | read |
| Hand session notes to Lorekeeper (GM only) | write |
| Take notes back from Lorekeeper (GM only) | delete |
Memorial Pages
Close the book on a campaign and read its memorial.
Tool | What it does | Scope |
| Read a campaign's memorial | read |
| Complete a campaign (GM only) | write |
| Reopen a campaign (GM only) | write |
| Share or hide the memorial (GM only) | write |
Dice
Roll any dice on the server, and choose how your dice look in the app.
Tool | What it does | Scope |
| Roll dice | read |
| My dice style | read |
| Change my dice style | write |
Notifications and progress
What's new at your tables, and how far you've come.
Tool | What it does | Scope |
| List my notifications | read |
| Count unread notifications | read |
| Mark notifications read | write |
| Clear a notification | delete |
| My Tavern Level and achievements | read |
| Every achievement | read |
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: support@gettavern.app
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.
This server cannot be deployed
Maintenance
Related MCP Connectors
Access your Kazkar TTRPG world — campaigns, chronicles, transcripts, lore — in any MCP client.
MCP server for Argo RPG Platform — connects AI assistants to campaign data via OAuth2
Manage your tabletop RPG campaign from any MCP client: worlds, sessions, quests, lore, recaps.
Official remote MCP server for Archivist AI TTRPG campaign memory: characters, sessions, and more.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to act as RPG Game Masters by managing campaign state including characters, inventory, quests, and logs through MCP tools. Supports campaign mutations and provides both MCP and HTTP API access to RPG session data.2-
- FlicenseAqualityDmaintenanceMCP server for managing Foundry VTT journal content (entries, categories, pages) and listing actors, enabling AI-assisted world-building via natural language commands.11-
- AlicenseNot gradedqualityCmaintenanceEnables MCP-compatible clients to read D&D Beyond characters, campaigns, and game reference data, with optional opt-in tools for session tracking and character building.MIT
- FlicenseAqualityAmaintenanceEnables MCP-capable AI assistants to work with a Foundry VTT world by reading and writing journals, scenes, compendiums, actors, combat, and more, subject to Gamemaster permissions and undoable changes.152-