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

VerifiedSTDIODesktop only

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

  1. Open Holonovel in the dashboard and add it to a workspace.
  2. 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

sh
npx -y holonovel

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

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

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:

VariablePurpose
TTRPG_DATA_DIRState directory (default: the per-user data location)
TTRPG_NOVELNovel to activate at startup
TTRPG_SEEDDeterministic PRNG seed
TTRPG_RULESETSRuleset slugs to load eagerly
TTRPG_RULESET_DIRSRuleset install directories
TTRPG_NPC_AUTONOMY, TTRPG_NPC_MINDNPC autonomy behaviors
TTRPG_WORLD_REACTIVITYWorld-in-Motion reactivity (default on)
TTRPG_NARRATION_VALIDATIONNarration grounding validation
TTRPG_GUIDANCE_PROFILEfull or lean guidance

Development

sh
npm run typecheck          # TypeScript type checkingnpm run test:all           # verification harnesses

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

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

15
  1. v2026.11.19LatestNov 19, 2026
  2. v2026.11.8Nov 11, 2026
  3. v2026.11.7Nov 7, 2026
  4. v2026.10.31Nov 1, 2026
  5. v2026.10.26Oct 29, 2026
  6. v2026.10.25Oct 25, 2026
  7. v2026.10.22Oct 22, 2026
  8. v2026.10.12Oct 12, 2026
  9. v2026.10.9Oct 9, 2026
  10. v2026.10.3Oct 3, 2026
  11. v2026.9.30Sep 30, 2026
  12. v2026.9.29Sep 30, 2026
  13. v2026.9.28Sep 28, 2026
  14. v2026.9.27Sep 27, 2026
  15. 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