Tools

Tools

Reference. For players, Game Masters, and builders who want to know what the server can do. No prerequisites — this page describes the tools; you don't need a running server to read it. You'll walk away with a complete catalog of every tool the base holonovel server registers, grouped by function.

The holonovel server registers 30 tools, 38 resources, and 5 prompts. Each tool is an action-discriminator: one tool name, with an action parameter that selects what it does. So where the old surface exposed create_character, set_lore_entry, and spec_health as separate tools, today those are manage_character (action: create), manage_lore (action: set), and manage_session (action: health). Installed ruleset packages register their own tools at runtime under a <slug>_ prefix (for example mothership_search_rules), so those aren't listed here — run manage_session (action: discover) or manage_ruleset (action: list) to see the live set for your server. Resources and prompts are summarized at the end.

Each entry names the tool, its actions, and what it does. Most mutation actions are Game Master-gated and read actions are badge-filtered — see Badges for the full access matrix.

Badges and workflow

Tool	What it does
set_badge	Switch your active role: player, game master, observer, or editor. Always callable.
respond_decision	Answer a pending workflow decision, such as confirming a campaign's end.
manage_history	undo reverts the most recent change, restoring the prior snapshot; redo re-applies the most recently undone change.

Characters

Tool	Actions	What it does
manage_character	create, stage, import, sheet, set_active, personality, voice, signal, remove, roster_remove, roster_list	Create characters step-by-step or quick-create, manage the persistent roster, render sheets, set the active character, and send player signals.

NPCs

Tool	Actions	What it does
manage_npc	create, update, remove, list, get	Manage named NPCs — stats, disposition, personality, and voice (Game Master only).

World model

Tool	Actions	What it does
manage_world	create_room, update_room, remove_room, create_thing, update_thing, remove_thing, create_exit, remove_exit, convert	Build and edit the world model's rooms, things, and exits, or populate an empty world from hybrid text assertions (Game Master only).
run_command	execute, resolve, suggest	Run a parser command — go, look, take, open, and more — resolve spatial intent without mutating state, or map intent to actions.

Combat

Tool	Actions	What it does
manage_combat	init, advance, end, add_participant, remove_participant, status	Run the combat lifecycle — initiative, turns, outcomes, and mid-encounter participant changes (Game Master only).
manage_condition	apply, remove, list	Apply and track mechanical or narrative conditions on characters and NPCs.
manage_countdown	set, advance, remove, list	Manage countdown timers — round and narrative types, decrement or increment direction (Game Master only).

Scene and narrative

Tool	Actions	What it does
manage_scene	set, directive, presence, autonomy, choices, oracle	Set scene description and type, standing directives, party presence, autonomy sliders, structured choices, and Ask-the-Oracle resolution.

Factions, vows, and relationships

Tool	Actions	What it does
manage_faction	create, update, remove, list	Track factions with goals, resources, and progress clocks (Game Master only).
manage_vow	set, milestone, resolve, forsake, list	Track narrative vows, quests, and obligations with milestone progress (Game Master only).
manage_relationship	set, get	Set and read directed relationships between entities (Game Master only).

Lore

Tool	Actions	What it does
manage_lore	set, update, remove, toggle, group, suggest, list, get, export, import, set_secret, reveal, secret_list, knowledge	Manage keyword-triggered lore entries and secrets, group them, toggle them, and export or import lorebooks (Game Master only).

Story journal

Tool	Actions	What it does
manage_story	record, update, remove, list, promote	Record decisions, revelations, bonds, and consequences, and promote them to lore (Game Master only).

Notes

Tool	Actions	What it does
manage_note	set, remove, list, set_server, remove_server, list_server	Manage key-value notes — Novel-scoped per badge, or server-level notes that span every campaign.

Codex

Tool	Actions	What it does
manage_codex	set, list, get, capture, import, delete	Maintain the cross-Novel codex library — NPCs, factions, rooms, spells, adventures, voice profiles — and import entries into the active Novel.

Novel lifecycle

Tool	Actions	What it does
manage_novel	create, resume, switch, end, export, import, rename, description, list, archive, unarchive, info, genre, clone, branch, save_context, get_context, checkpoint_set, checkpoint_list, checkpoint_restore, checkpoint_remove	Manage the campaign save file — create, resume, switch, clone, branch, export/import, archive, and checkpoint.

Adventures

Tool	Actions	What it does
manage_adventure	generate, generate_encounter, load, list	Generate adventure scaffolds and encounters, load indexed adventure modules, and list the catalog.

Rulesets

Tool	Actions	What it does
manage_ruleset	search, install, remove, list, bind, roll	Search the active ruleset's index, install or remove ruleset packages, bind the Novel to a ruleset, and roll on generation tables.

Synthesis

Tool	Actions	What it does
manage_synthesis	run, revert, list, activate, deactivate, toggle, toggle_action, player_add, player_remove, player_list	Run and manage the optional enrichment workflow — community GM advice, lore templates, and action patterns — across three independently removable tiers.

Session and health

Tool	Actions	What it does
manage_session	recap, verbosity, briefing_order, compress, health, subscribe, discover, category, event, history	Summarize the session, set output verbosity, reorder the badge briefing, compress the audit log, report spec_health, subscribe to event notifications, and discover or read the event log.

Belief, identity, and causal state

Tool	Actions	What it does
manage_belief	list, get, evidence, admit, retract, conflicts, reconcile	Per-entity evidence and reconciled belief stances.
manage_identity	stage, accept, reject, list, snapshot, bootstrap	Roster-tier character identity — staged candidates, accepted facets, and a versioned kernel.
manage_causal	propose, admit, reject, list, state, ingress	Objective-state transition validation and the transition ledger.

Corpus, index, and graph

Tool	Actions	What it does
manage_corpus	register, list, get, route, grant, deny, access, consume, acquisitions	Cold reference material and per-entity knowledge acquisition.
manage_index	build, status, list, search, relations	Derived offline semantic index; advisory ranking only.
manage_graph	build, status, get, nodes, edges, neighbors	Derived JSON knowledge-graph projection; read-only.

Agents and perception

Tool	Actions	What it does
manage_agent	create, list, get, start, advance, complete, fail, cancel	Durable NPC and agent task and action lifecycle.
manage_perception	record, list, for_entity, for_event	Per-entity perception ledger — observed, not believed.

Base capabilities

Tool	Actions	What it does
resolve_fate	roll, aspect, fate_point, stress	Roll Fudge dice (4dF), manage aspects, spend and refresh Fate points, and track stress and consequences.
resolve_ironsworn	momentum, move, progress	Track Ironsworn momentum, resolve moves against two challenge dice, and manage progress tracks.
resolve_forged	action_roll, stress, downtime	Resolve Forged in the Dark action rolls with position and effect, mark stress and trauma, and run downtime recovery and indulgence.

Prompts

The server ships five prompts, surfaced in your client's prompt list:

• intro — welcome and getting started.
• badge_briefing — the current badge's full briefing: scene, lore, signals, and turn handoff.
• session_zero — a guided agreement on tone, safety, and the crew before play.
• novel_setup — a three-step wizard: characters, story source, session zero.
• run_workflow — maps a natural-language intent to the right tool.

Resources

The server registers 38 resource surfaces for direct lookup — from novel://current and entity://{id} through room://{id}, npc://{id}, lore://{key}, world://map, audit://novel, codex://{id}, the guidance:// and synthesis:// surfaces, and the four MCP Apps UI surfaces (ui://character-sheet, ui://codex, ui://lore, ui://novel) added for MCP Apps clients. These are read-only views into campaign state; the tools above are how you change it.

Source: holonovel server source (holonovel/src/index.ts), spec §5 (server surfaces).

See also

• Home — the wiki front page
• What Holonovel Is — why the engine enforces and the AI narrates
• Badges — the four badges and what each can do

Last updated: 2026-10-12.