Integration

MCP server integration

Narrarium exposes a local stdio MCP server for repo mutations and a public HTTP MCP surface for setup and research. This page is generated from the actual MCP source files, so the tool list reflects the implementation.

Local stdio MCP

Use for canon creation, chapter and scene work, assets, renames, validation, resumes, evaluations, and EPUB export.

npx narrarium-mcp-server

Public HTTP MCP

Use for setup guidance, repository spec help, and Wikipedia research. Intended for `/mcp` and `/health` deployment on Vercel.

https://narrarium.space/mcp

Health: https://narrarium.space/health

OpenCode config

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "narrarium": {
      "type": "local",
      "command": ["node", "packages/mcp-server/dist/index.js"],
      "enabled": true,
      "timeout": 15000
    }
  }
}

Local MCP tools

Guided flows

Tool	Description
`chapter_wizard`	Return the Narrarium chapter checklist so the agent can gather the right details before creating a chapter.
`character_wizard`	Return the Narrarium character creation checklist so the agent can gather the right information before creating a character file.
`faction_wizard`	Return the Narrarium faction creation checklist so the agent can gather the right details before creating a faction file.
`item_wizard`	Return the Narrarium item creation checklist so the agent can gather the right details before creating an item file.
`location_wizard`	Return the Narrarium location creation checklist so the agent can gather the right details before creating a location file.
`paragraph_wizard`	Return the Narrarium paragraph or scene checklist so the agent can gather the right details before creating a paragraph file.
`secret_wizard`	Return the Narrarium secret creation checklist so the agent can gather the right details before creating a secret file.
`start_wizard`	Start a multi-step guided wizard session for creating canon files or chapter structures. Use this when the user has not provided all required details yet.
`timeline_event_wizard`	Return the Narrarium timeline event checklist so the agent can gather the right details before creating a timeline event file.
`wizard_answer`	Answer the current prompt in a running wizard session and receive the next guided question.
`wizard_cancel`	Cancel a wizard session and discard its in-memory answers.
`wizard_finalize`	Finalize a wizard session and write the corresponding file or folder into the local book repository.
`wizard_status`	Inspect the current state of a wizard session, including collected fields and the next question.

Creation and assets

Tool	Description
`create_asset_prompt`	Create an asset prompt markdown file in the canonical assets tree for a book, entity, chapter, or paragraph image.
`create_chapter`	Create a chapter folder, chapter metadata file, and paired resume and evaluation files in the local book repository.
`create_character`	Create a rich character file using the Narrarium character wizard fields. Use this instead of the generic entity tool when the user is adding a real story character.
`create_entity`	Create a canonical entity markdown file inside the local book repository. Use this for quick stubs, items, locations, factions, secrets, and timeline events. Prefer create_character for full story characters.
`create_faction`	Create a rich faction file with mission, ideology, methods, alliances, and optional historical research support.
`create_item`	Create a rich item file with appearance, purpose, significance, ownership, and optional historical research support.
`create_location`	Create a rich location file with atmosphere, story function, landmarks, risks, and optional historical research support.
`create_paragraph`	Create a numbered paragraph or scene markdown file inside an existing chapter folder.
`create_secret`	Create a rich secret file with stakes, holders, protection, reveal strategy, and spoiler thresholds.
`create_timeline_event`	Create a timeline event file with participants, significance, consequences, and optional factual research support.
`generate_asset_image`	Generate an image for a canonical subject, save it into the assets tree, and keep the asset prompt metadata in sync.
`init_book_repo`	Create the local Narrarium repository structure for a book project, including folders, guidelines, summaries, evaluations, and reusable skills.
`register_asset`	Copy an existing image into the canonical assets tree and create its matching prompt metadata file.

Maintenance and output

Tool	Description
`evaluate_book`	Refresh the total evaluation scaffold for the whole book and optionally refresh chapter evaluations too.
`evaluate_chapter`	Refresh the deterministic evaluation scaffold for a chapter so the agent can review pacing, continuity, and revision targets.
`export_epub`	Export the current book repository into an EPUB file from the ordered chapter and paragraph markdown files.
`sync_all_resumes`	Refresh every chapter resume and the total book resume in one pass.
`sync_resume`	Refresh a chapter resume or the total book resume from the current repository state without calling another model.
`validate_book`	Validate Narrarium frontmatter and file placement rules inside the local book repository.

Search and continuity

Tool	Description
`list_related_canon`	List canon files that reference or mention a given id or query, useful before writing scenes or revising continuity.
`search_book`	Search the local book repository across canon, chapters, notes, summaries, and research before drafting or editing.

Updates and renames

Tool	Description
`rename_chapter`	Rename a chapter title or number, move its folder, and move any matching chapter or paragraph asset folders if present.
`rename_entity`	Rename an entity in a safe way: update its slug and id, move its markdown file, and move any matching asset folder if present.
`rename_paragraph`	Rename a paragraph or scene title or number, move its markdown file, and move any matching paragraph asset folder if present.
`update_chapter`	Update an existing chapter metadata file and optional chapter notes body. Use this for summary, POV, tags, and chapter notes changes without touching chapter numbering or folder naming.
`update_entity`	Update an existing entity file by patching frontmatter and optionally replacing or appending markdown body content. Use rename_entity when the slug, id, or asset folder must move.
`update_paragraph`	Update an existing paragraph or scene markdown file. Use this for summary, viewpoint, tags, and body revisions without renumbering or renaming the file.

Setup and research

Tool	Description
`repository_spec`	Return the Narrarium repository model and canon rules so clients can understand the book framework structure.
`setup_framework`	Return the exact npx commands and setup steps to bootstrap a new Narrarium project from scratch.
`wikipedia_page`	Fetch a Wikipedia page summary and optionally save it into research/wikipedia inside the local book repository.
`wikipedia_search`	Search English or Italian Wikipedia for historical or factual research before adding canon to the book repository.

Public HTTP MCP tools

Tool	Description
`repository_spec`	Return the Narrarium repository model and canon rules so clients can understand the book framework structure.
`setup_framework`	Return the exact npx commands and setup steps to bootstrap a new Narrarium project from scratch.
`wikipedia_page`	Fetch a Wikipedia page summary for setup or factual research.
`wikipedia_search`	Search English or Italian Wikipedia for historical or factual research.

Tool lists are parsed from packages/mcp-server/src/index.ts and packages/mcp-server/src/public-http-server.ts.