# Holonovel

> Holonovel is an open-source MCP server for games and play. Run tabletop RPG worlds with rooms, a parser and Fate, Ironsworn and Blades rules. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Repository:** https://github.com/flukeatzerocool/holonovel/tree/HEAD/holonovel
- **MCP Registry name:** io.github.flukeatzerocool/holonovel
- **Categories:** [games and play](https://ai-powered.com/categories/games-and-play)
- **Listing updated:** 2026-11-18

## About

State is the point: worlds are kept as structured save files called Novels, with atomic saves, per-badge undo and redo snapshots and an append-only audit log, stored in your user-data folder or wherever TTRPG_DATA_DIR points. A fresh install is playable immediately, seeding a tutorial Novel called Torre Nosferatu that open_session resumes in one call.

The server exposes 36 action-based tools grouped into badges and workflow, characters and cast, world and scene, narrative, session, mechanics and content. Built-in mechanics cover Fate dice, Ironsworn momentum and Blades in the Dark stress, and further ruleset packages load beside the base without modifying it. Switches control NPC autonomy, world reactivity, narration grounding validation and deterministic seeding.

It requires Node.js 22 or newer and is MIT licensed. The README credits a long list of SRDs and open resources, including Fate, Ironsworn, Blades in the Dark and Dungeon World.

## Features

- **Persistent worlds:** Novels save rooms, things, exits and story state with undo and redo.
- **Parser command layer:** Text-adventure style commands over the world model.
- **Built-in mechanics:** Fate dice, Ironsworn momentum and Blades stress tracks.
- **Ruleset packages:** Install extra rulesets alongside the base.
- **Tutorial included:** A starter Novel is seeded on first run.
- **NPC and world switches:** Optional autonomy and reactivity behaviours.

## Good for

- Run a solo or GM-assisted tabletop session with an AI
- Keep a campaign's world and cast consistent across sessions
- Resolve Fate or Ironsworn rolls through tools
- Add a rulebook as a package and play it

## Install

### Claude Code (Terminal)

```sh
claude mcp add holonovel -- npx -y holonovel
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "holonovel": {
      "command": "npx",
      "args": [
        "-y",
        "holonovel"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "holonovel": {
      "command": "npx",
      "args": [
        "-y",
        "holonovel"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "holonovel": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "holonovel"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "holonovel": {
      "command": "npx",
      "args": [
        "-y",
        "holonovel"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "holonovel": {
      "command": "npx",
      "args": [
        "-y",
        "holonovel"
      ]
    }
  }
}
```

## Tools

- `open_session`: Resume or open a session and the active Novel.

## FAQ

### Do I need a rulebook?

No, the base works without one and starts with a tutorial.

### Where is campaign data stored?

In the OS user-data folder, or the path in TTRPG_DATA_DIR.

### How many tools are there?

36 action-discriminator tools.

### What does it need?

Node.js 22 or newer.

### Is Holonovel free?

Yes. Holonovel is open source, so you can use and self-host it for free.

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

Run this command in your terminal: claude mcp add holonovel -- npx -y holonovel

### What are the best alternatives to Holonovel?

The closest alternatives to Holonovel are Digimon, Disney, Clash Royale, 82-0 Dream MCP and 27-0 MCP.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Digimon](https://ai-powered.com/mcp/digimon): Digimon is a freemium MCP server for games and play.
- [Disney](https://ai-powered.com/mcp/disney): Disney is a freemium MCP server for games and play.
- [Clash Royale](https://ai-powered.com/mcp/clash-royale): Clash Royale is a freemium MCP server for games and play.
- [82-0 Dream MCP](https://ai-powered.com/mcp/82-0-dream-mcp): 82-0 Dream MCP is a free MCP server for games and play.
- [27-0 MCP](https://ai-powered.com/mcp/27-0-mcp-2): 27-0 MCP is a free MCP server for games and play.
- [Wynncraft](https://ai-powered.com/mcp/wynncraft): Wynncraft is a freemium MCP server for games and play.
- [Gamechalk Score Keeper](https://ai-powered.com/mcp/gamechalk-score-keeper): Gamechalk Score Keeper is an MCP server for games and play.
- [OSRS Calc MCP](https://ai-powered.com/mcp/osrs-calc-mcp): OSRS Calc MCP is an open-source MCP server for games and play.

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