# Tavern

> Tavern is a freemium MCP server for games and play. Remote MCP server for a tabletop RPG campaign's journal, wiki, maps, sheets and combat. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, API
- **Website:** https://gettavern.app/developers
- **Repository:** https://github.com/jakehandy/tavern-mcp
- **MCP Registry name:** io.github.jakehandy/tavern
- **Categories:** games and play
- **Listing updated:** 2026-11-14

## About

The tools cover 117 operations across 14 areas of the Tavern app: dated session notes, a wiki of people, places and things, maps with pins, character sheets with live hit points and spell slots, a combat tracker, and each player's private notes. Examples from its docs include recapping a session from everyone's notes, starting a wiki page and linking it in tonight's notes, applying damage to temporary hit points before real ones, and listing story threads left open.

A connected app acts as you and no more: it reaches only the tables you sit at, with the seat you hold at each, so a player's connection cannot do the GM's job and private notes stay with their owner. Sign-in is OAuth 2.1 with PKCE, where you can grant less than the app asks for, or a personal API key. Scopes stack from read to write to delete, and a client sees only the tools its scopes allow.

The server is hosted at gettavern.app/mcp, so there is nothing to install. You need a free Tavern account and a campaign.

## Features

- **Session journal:** Read and write dated sessions and everyone's notes.
- **Campaign wiki:** Create and link pages for people, places and things.
- **Character sheets:** Read and update hit points, spell slots, conditions and equipment.
- **Combat tracker:** Start battles, add seats and enemies, and wait for initiative.
- **Stacked scopes:** Read, write and delete scopes limit which tools a client sees.
- **Seat-based access:** A connection has the same access as your seat at each table.

## Good for

- Recap last session from everybody's notes
- Create a wiki page for a new NPC and link it
- Apply damage and conditions to a character
- List plot threads the group dropped
- Set up a combat encounter

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gettavern.app/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tavern": {
      "serverUrl": "https://gettavern.app/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tavern": {
      "type": "http",
      "url": "https://gettavern.app/mcp"
    }
  }
}
```

## Tools

- `whoami`: Show the account this credential acts as and what it may do
- `list_campaigns`: List campaigns you own or hold a seat at, and pending invitations
- `respond_to_invitation`: Accept or decline a seat offered to you
- `get_profile_settings`: Get your public profile's handle and visible parts
- `update_profile_settings`: Rename your handle or show and hide profile parts
- `get_subscription`: Get your subscription details

## FAQ

### Do I need an account?

Yes, a free Tavern account and a campaign.

### How do I sign in?

OAuth 2.1 with PKCE through Tavern's consent page, or a personal API key from Settings, API and assistants.

### Can a player's assistant act as the GM?

No. A connected app reaches the tables you sit at with the seat you hold at each.

### Is there an ordinary API too?

Yes. The docs say every part of Tavern is available over REST as well as MCP.

### Is Tavern free?

Tavern has a free plan, with paid plans for more usage or features.

### How do I add Tavern to Claude Code?

Run this command in your terminal: claude mcp add --transport http tavern https://gettavern.app/mcp

### What are the best alternatives to Tavern?

The closest alternatives to Tavern are AvatarSay — Fictional Character & Talking Video MCP, VfxSmith, Born Then, Haze City and Vectoroids.

## Alternatives

- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [Born Then](https://ai-powered.com/mcp/born-then): Born Then is a free MCP server for education and exams.
- [Haze City](https://ai-powered.com/mcp/haze-city): Haze City is an open-source MCP server for games and play.
- [Vectoroids](https://ai-powered.com/mcp/vectoroids): Vectoroids is a free MCP server for games and play.
- [Vector Abyss](https://ai-powered.com/mcp/vector-abyss): Vector Abyss is a free MCP server for knowledge and memory.
- [Vector Alienspace](https://ai-powered.com/mcp/vector-alienspace): Vector Alienspace is a free MCP server for knowledge and memory.
- [Vector Defence](https://ai-powered.com/mcp/vector-defence): Vector Defence is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/tavern
