apply_analysis_revision
ChatGPTSave the exact server-prepared analysis and chapter guidance only after the project owner has reviewed its before/after preview and explicitly approved this revision ID. Available before translation begins. Refuses stale source, glossary, or analysis. Does not start translation or change manuscript text or glossary. Repeating an already applied proposal does not write twice.
decide_naturalizer_suggestions
ChatGPTApply or reject one or many explicitly reviewed Naturalizer suggestions. Supply their IDs and exact before/after snippets from get_naturalizer_suggestions. Pending suggestions only. Applied replacements must still match exactly once in the current paragraph. Processes sequentially, reports every result, records edits in Studio history. Editor access required; only after all automatic processing.
get_analysis_revision
ChatGPTRead a prepared analysis revision or check its status. Preparation may take several minutes; do not poll repeatedly in one turn. When ready, fetch all nextOffset pages and show concrete before/after changes, including any revised chapter guidance. Ask for explicit approval of this proposal. Reading or preparing a proposal never applies it.
get_book_analysis
ChatGPTRead the stored book analysis and section guidance. Optional paragraphIndex narrows guidance to the passage, including its refined chapter directives and fingerprint. Counts refer to ORIGINAL paragraphs, including before translation.
get_coherence_elements
ChatGPTRead the latest ThreadWeaver blueprint with occurrence counts and active glossary bindings. A blueprint is a recurrence map, not a completed target-language audit. Private target candidates are not returned.
get_coherence_occurrences
ChatGPTRead occurrences of one ThreadWeaver element with live source/final translation paragraphs. Inspect these to validate coherence. Stored resolved status alone is not proof of validation.
get_edit_history
ChatGPTRead existing Studio text-change history for an accessible project, optionally one paragraph. Returns full before/after text, actor ID, time and history ID. Paginate with nextCursor. History does not store editorial rationales or the affected pass, so neither is inferred. To undo a specific edit, read the current final paragraph, show the proposed reversal for approval, preview it, then use replace_translation_text with the current revision; never blindly overwrite later edits.
get_glossary
ChatGPTRead active, binding project glossary rows separately from unactivated AI suggestions. Suggestions alone never establish terminology authority.
get_naturalizer_suggestions
ChatGPTRead Naturalizer before/after suggestions, explanations, tradeoffs, council votes, and status. Does not run Naturalizer. Read associated original/translation paragraphs before recommending a decision.
get_paragraphs
ChatGPTRead original paragraphs and their translation. Default reads the latest available pass, explicitly labelled; supply pass to read one specific pass. The final pass includes subsequent editorial changes. Zero-based indices; at most 40 paragraphs.
get_profile
ChatGPTIdentify the connected BookTranslate account.
get_project
ChatGPTGet project progress, readiness, and recent preparation/translation/review operations. Final translation completion is distinct from automatic review readiness.
list_projects
ChatGPTList projects this account owns or collaborates on. Public visibility alone does not grant MCP access. Paginated.
prepare_analysis_revision
ChatGPTQueue a BookTranslate AI analysis revision only when the project owner explicitly asks for a correction. Before calling, read get_book_analysis and relevant original passages; use its current revision as expectedRevision. Describe the requested interpretation correction, not replacement field values. Give paragraphIndex for one existing section; omit it only for a whole-book correction. Indices are zero-based. Preparation uses AI resources but does not change the current analysis, glossary, manuscript, or translation. Check the returned proposal with get_analysis_revision after preparation.
preview_translation_edits
ChatGPTDry-run a batch of up to 20 exact translation replacements without changing any text, history, or suggestion state. Read get_paragraphs first. Supply expectedText or the returned expectedRevision for each edit. Simulates items in order, including sequential edits to the same paragraph; invalid items are skipped as in a real batch. Returns per-item validation and full before/after proposals for user approval. The preview does not reserve text; saving revalidates everything. Owner/editor access and the same readiness gates as saving are required. No model calls.
remove_glossary_terms
ChatGPTDeactivate/delete explicitly chosen active glossary terms. Supply IDs and exact current term/translation from get_glossary. Owner only. No manuscript text is changed.
replace_translation_text
ChatGPTSave only replacements the user explicitly approved after seeing concrete before/after proposals. Read get_paragraphs first and supply expectedRevision from its final-pass translation, or the complete current paragraph as expectedText. If both are supplied both must match. before must match exactly once; for a whole-paragraph replacement, use the complete current paragraph as before. Empty before is allowed only for an empty paragraph. Use preview_translation_edits or dryRun=true to validate a batch without writing anything; saving always rechecks. after is literal text, including dollar signs; it may be empty for an explicitly approved deletion. Edits apply sequentially; stale or ambiguous items are refused independently. Every actual text change and its full before/after history record commit together in Studio. Owner or editor only, after translation and automatic processing finish. Does not call AI or alter the original manuscript.
search_manuscript
ChatGPTSearch a literal term in original, translation, or both. Default translation pass is the final pass; specify an earlier pass during translation. Returns bounded snippets and indices for full reads. Pagination uses afterIndex; hasMore means the search is incomplete.
set_glossary_terms
ChatGPTAdd, update, or activate explicitly chosen glossary terms, one or many. Read get_glossary first. For existing entries pass id AND exact previousTranslation to prevent overwriting a concurrent decision. A new term must have no existing normalized source identity. Owner only; disabled while processing. Does not rewrite existing manuscript text.