Assistants

MCP Libris Translate

The MCP server lets an assistant read your library, prepare context and control jobs with your account’s permissions.

Connection

Create an automation token in My account › API tokens. MCP comes with the Studio and Pro plans: with another licence, the call answers 402 with the code automation_not_licensed. Choose the required scopes.
In your MCP client, choose a remote HTTP server at https://libris.example/mcp, replacing the example with your installation’s HTTPS address.
Supply Authorization: Bearer with the secret from your client’s secure storage. Initialize the connection, then request tools/list.

The transport accepts JSON-RPC on POST /mcp and returns JSON. Its announced protocol version is 2025-06-18. It exposes no GET SSE stream, MCP resources or prompts. A 405 on GET /mcp therefore does not mean that POST is unavailable.

json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-06-18",
    "capabilities": {},
    "clientInfo": { "name": "demo-client", "version": "1.0" }
  }
}

A deliberate workflow

Import the book through the interface or REST API first: this MCP catalogue has no file-upload tool.

Ask the assistant to list books, read the selected book and call estimate_job before start_job. Identifiers must come from earlier responses. Follow progress with list_jobs; use control_job for pause, resume, cancel or retry. Jobs call models and can incur charges.

Two tools ask for more than the scope that opens them. propagate_term only previews by default: it counts passages, occurrences and chapters, sets human corrections apart and shows up to five examples; writing needs the same call with dry_run=false and confirm=true. control_series starts, suspends, resumes or cancels a whole series, and its start action requires pipeline:start on top of jobs:control — a token that can stop a series must not be able to bill one.

Deletions require confirm=true: confirm the affected object before authorizing them. Use shelve_book to archive. export_book returns TXT or Markdown and may truncate long output; request a chapter range for long books and use the interface or REST for EPUB.

Tool catalogue

Every call remains subject to token scopes and the account’s effective access. The catalogue announced by your installation is authoritative.

Tool	Scope	Purpose
`list_books`	`library:read`	List accessible books
`get_book`	`library:read`	Read a book and its state
`list_chapters`	`library:read`	List book chapters
`book_quality`	`library:read`	Read quality signals
`configure_book`	`library:write`	Change book settings
`shelve_book`	`library:write`	Archive or restore a book
`delete_book`	`library:delete`	Permanently delete a book
`list_series`	`series:read`	List series
`get_series`	`series:read`	Read a series
`create_series`	`library:write`	Create a series
`update_series`	`library:write`	Change series settings
`attach_volume`	`library:write`	Attach or detach a volume
`series_consistency`	`series:read`	Audit series consistency
`delete_series`	`library:delete`	Delete a series
`list_terms`	`library:read`	Read book or series terminology
`add_term`	`library:write`	Add a terminology choice
`edit_term`	`library:write`	Edit a book term
`propagate_term`	`library:write`	Propagate a term, preview first
`delete_term`	`library:delete`	Delete a book term
`read_bible`	`library:read`	Read the Book Bible of a book or a series
`estimate_job`	`library:read`	Estimate analysis, translation or review
`start_job`	`pipeline:start`	Start asynchronous model work
`list_jobs`	`jobs:read`	Read job progress
`control_job`	`jobs:control`	Pause, resume, cancel or retry
`control_series`	`jobs:control`	Start, suspend or resume a series
`export_book`	`results:read`	Read translated TXT or Markdown
`list_providers`	`content:write`	List accessible model providers
`licence_status`	`library:read`	Read licence and allowance status

Refusals and limits

A refused tool call may return isError=true inside the MCP result: read that field, not only the HTTP status. Revoking the token removes access. Token budgets, rate limits, licence guards and job pauses still apply.

Tokens and budgets · API REST · MCP technical reference