Skip to content
MCP server

Holonovel

Run tabletop RPG worlds with rooms, a parser and Fate, Ironsworn and Blades rules

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
2026.11.8
Listing updated
today

Similar MCP servers

About Holonovel

Holonovel is an open-source MCP server for games and play. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add holonovel -- npx -y holonovel

Add to claude_desktop_config.json

{
  "mcpServers": {
    "holonovel": {
      "command": "npx",
      "args": [
        "-y",
        "holonovel"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "holonovel": {
      "command": "npx",
      "args": [
        "-y",
        "holonovel"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

open_session
Resume or open a session and the active Novel.

What it does

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

Pricing

Open source

MIT licence

Holonovel 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.

How AIPoweredBot checks servers