
Holonovel
io.github.flukeatzerocoolPublished by GitHub account flukeatzerocoolv2026.11.19Updated Nov 19, 2026
Holonovel MCP server: world-model base for tabletop RPG play (rooms, parser, narrative tools).
Overview
Holonovel's local MCP server; no sign-in required; STDIO.
No AI overview yet: these facts come from the registry entry and the server itself.
Installation
In SourceWeft
- Open Holonovel in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
holonovel
The Holodeck for your rulebooks — rules enforced, worlds remembered.
A world-model MCP server for tabletop RPG play: rooms, things, exits, a parser command layer, and narrative tools, with out-of-the-box mechanics from Fate, Ironsworn, and Blades in the Dark (Fudge dice, momentum, and stress tracks — no ruleset required). Install it, then drop in any number of ruleset packages; each loads alongside the base and never modifies it.
Requirements
- Node.js 22+
Install
A fresh install is playable without a rulebook: the server seeds Torre
Nosferatu, a tutorial Novel, and open_session resumes it in one call. Set
TTRPG_STARTER_NOVEL=off to start with an empty world instead.
From a source checkout, run npm install and npm run start while developing;
for a non-development run, npm run build && node dist/index.js.
MCP client configuration
Data
A Novel is a structured save file with atomic saves, per-badge undo/redo
snapshots, and an append-only audit log. By default the state directory is the
operating system's user-data location: ~/.local/share/holonovel on Linux,
~/Library/Application Support/holonovel on macOS, or
%LOCALAPPDATA%\holonovel on Windows. Set TTRPG_DATA_DIR to override it. An
existing .holonovel-state/ beside the server is honored for compatibility.
Campaign data and installed packages live under the state directory, outside
the server tree, so updating holonovel never touches them. A container or hosted
deploy keeps that directory inside the container — point TTRPG_DATA_DIR at a
mounted volume to keep campaigns across restarts.
Tool surface
The host exposes 37 action-discriminator tools covering persisted entity
types, the parser command layer, and base-mechanics resolvers. Retired tool
aliases are hidden from the default listing. Every tool carries all four MCP
mutation-class hints and a three-clause description (see AGENTS.md for the
full surface and the tool-definition authoring standard).
Categories:
- Badges & Workflow — badge switching, workflow response, undo/redo
- Characters & Cast — player characters, NPCs, identity, beliefs
- World & Scene — world model, scene framing, perception, causal state
- Narrative — story journal, lore, notes, vows, factions, countdowns
- Session — recap, health, discovery, event log, audit
- Mechanics — Fate, Ironsworn, and Forged in the Dark resolvers
- Content — adventures, codex, ruleset packages, synthesis
Configuration
Behavioral switches read from the environment; every switch is inert by default. Common values:
Development
Tests are tsx harnesses under scripts/ (there is no test/ directory).
License
Canonical origin: git.gay/flukeatzerocool/Holonovel.
Holonovel is MIT-licensed. See LICENSE.md. Built from:
- D&D 5e SRD v5.2.1 (CC BY 4.0, Wizards of the Coast)
- Graham Nelson's Inform (Artistic License 2.0, Graham Nelson)
- if-craft-corpus (CC BY 4.0, pvliesdonk)
- dmcp (MIT, Shawn Rushefsky)
- lonelog (CC BY-SA 4.0, zeruhur)
- BitD SRD (CC BY 3.0, John Harper)
- Ironsworn: Starforged SRD (CC BY 4.0, Shawn Tomkin)
- Sly Flourish Lazy GM Resource Document (CC BY 4.0, Mike Shea)
- The Alexandrian (CC BY 4.0, Justin Alexander)
- Dungeon World SRD (CC BY 3.0, Sage LaTorra, Adam Koebel)
- Fate SRD (CC BY 3.0, Evil Hat Productions)
- Ironsworn SRD (CC BY 4.0, Shawn Tomkin)
- COF — Character Open File (CC BY 4.0 / CC0 1.0, Yann Souetre)
License texts: CC BY 4.0, CC BY 3.0, CC BY-SA 4.0, CC0 1.0, MIT, Artistic 2.0.
Upstream sources: D&D 5e SRD, Inform, if-craft-corpus, dmcp, lonelog, BitD SRD, Starforged SRD, Lazy GM, The Alexandrian, Dungeon World SRD, Fate SRD, Ironsworn SRD, COF.
RSS. Last updated: 2026-11-17.
Source: holonovel/README.md at commit 1af336f
Tools
0Version history
15- v2026.11.19LatestNov 19, 2026
- v2026.11.8Nov 11, 2026
- v2026.11.7Nov 7, 2026
- v2026.10.31Nov 1, 2026
- v2026.10.26Oct 29, 2026
- v2026.10.25Oct 25, 2026
- v2026.10.22Oct 22, 2026
- v2026.10.12Oct 12, 2026
- v2026.10.9Oct 9, 2026
- v2026.10.3Oct 3, 2026
- v2026.9.30Sep 30, 2026
- v2026.9.29Sep 30, 2026
- v2026.9.28Sep 28, 2026
- v2026.9.27Sep 27, 2026
- v2026.9.7Sep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts