The MCP connector
MCP tool reference
Every tool a connected client can call, grouped by what it costs. Generated from Calliope's live tool definitions — the descriptions here are the same ones your client sees.
Calliope exposes 18 tools over MCP. They fall into three tiers by what the call costs us — and there is no tool of any tier that writes chapter prose, by design and forever. See Tools & tiers for the cost model, and the overview for why the body stays yours.
Return grounded manuscript data. No credits, no subscription — free to everyone.
list_books manuscript.read List books
List every book you own in Calliope — each with its id and title. Use a book's id as the bookId argument to the other tools to target it (they default to your first book otherwise). Free.
get_outline manuscript.read Get outline
Read a book's structure — its parts and chapters with titles, status, word counts, synopses (and whether each is stale), and targets, plus the goal and recent progress. Reads only your own books. Free. Omit bookId to use your first book.
get_chapter manuscript.read Get chapter
Read one chapter's prose (as plain text) plus its metadata — title, status, synopsis, word count, target. Reads only your own chapters. Free.
search_manuscript manuscript.read Search manuscript
Keyword search across the book's chapter prose and cast; returns matching chapters (with excerpts) and facts. Reads only your own book. Free. Omit bookId to use your first book.
list_facts map.read List facts (the map / cast)
Read the book's story map — characters, places, and other canon facts (name, aliases, attributes, summary, mention counts). Reads only your own book. Free. Omit bookId to use your first book.
get_fact map.read Get fact
Read one fact in full — its attributes and every place it is mentioned. Reads only your own facts. Free.
list_snippets snippets.read List snippets (marginalia)
Read the book's margin notes, to-dos, references, and research — optionally just one chapter's. Reads only your own book. Free. Omit bookId to use your first book.
Invoke Calliope's own AI. Metered against your credit balance (or your subscription allowance).
detect_entities ai.use Detect entities
Run Calliope's AI entity detection on a chapter — proposes characters/places/etc. to add to your map, grounded in your existing canon. Proposals only; writes nothing. SPENDS YOUR CREDITS.
check_consistency ai.use Check consistency
Run Calliope's AI consistency check on a chapter — surfaces contradictions and name drift against your canon. Read-only; writes nothing. SPENDS YOUR CREDITS.
generate_synopsis ai.use Generate synopsis
Generate a synopsis for a chapter with Calliope's AI. Returns the text only — it does NOT write it to the chapter (use a write tool, with a subscription, to save it). SPENDS YOUR CREDITS.
Persist into your canon. Available only with an active MCP subscription. Never chapter prose.
create_snippet snippets.write Create snippet
Add a margin note, reference, to-do, or research snippet — anchored to a chapter (or the book). Annotations live beside the prose, never in it. Requires an active MCP subscription.
update_snippet snippets.write Update snippet
Replace a snippet's content (e.g. tick off a to-do item, edit a note). Give its kind plus the new fields. Requires an active MCP subscription.
delete_snippet snippets.write Delete snippet
Remove one of your snippets. Requires an active MCP subscription.
create_fact map.write Create fact
Add a fact to the story map — a character, place, or any canon entity (name, kind, aliases, attributes, summary). Requires an active MCP subscription.
update_fact map.write Update fact
Edit a fact on the story map — its name, kind, aliases, attributes, or summary. Requires an active MCP subscription.
merge_facts map.write Merge facts
Merge two facts (e.g. duplicates) — keepId absorbs dropId's aliases and mentions, then dropId is removed. Both must be in the same book you own. Requires an active MCP subscription.
set_synopsis structure.write Set chapter synopsis
Save a chapter's synopsis (e.g. one your own LLM drafted). Writes the synopsis FIELD only — never the chapter prose. Requires an active MCP subscription.
set_chapter_status structure.write Set chapter status
Set a chapter's status: draft, revising, or done. Requires an active MCP subscription.
Notice what's not here. There is no write_chapter_prose
tool, and no prose.write scope to grant one. An MCP client can read every
word and tend everything around the prose — the Map, the marginalia, the structure —
but it can never write or edit a sentence of the body. If you want to script prose
changes with your own code, that's the
Writer API, not MCP.