escriptorium

Manage eScriptorium documents, transcriptions, OCR jobs, and archives through its MCP server.

Updated Sep 16, 2026
One-click install
npx skills add https://github.com/penica/escriptorium-mcp --skill escriptorium-penica
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: escriptorium
Source: https://github.com/penica/escriptorium-mcp/tree/main/skills/escriptorium
Command: npx skills add https://github.com/penica/escriptorium-mcp --skill escriptorium-penica

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working with eScriptorium's large API surface for manuscript transcription projects is error-prone: wrong ID types, destructive bulk operations, and ambiguous job states can corrupt data or misreport results. This Skill guides an AI through the eScriptorium MCP server's 176 tools with correct semantics for documents, pages, transcriptions, segmentation, training, and exports. ## Core Features & Use Cases - Document and transcription management: Search, create, move, and tag projects, documents, and pages; correct line transcriptions and segmentation geometry with the right record IDs. - OCR, training, and alignment: Submit segmentation/recognition jobs, train models from ground-truth layers or virtual collections, align reference witnesses, and interpret task reports without confusing queued with completed. - Export and archiving: Produce ALTO/PAGE XML, text, or JSON archives, download generated exports with checksum verification, and acquire full scan registers to NAS storage. - Use Case: A digital humanities researcher asks the AI to correct transcription errors on specific manuscript pages, retrain a recognition model on the corrected ground truth, and export the finished document as a PAGE XML archive. ## Quick Start Use the escriptorium skill to list my eScriptorium projects and show the transcription layers of my most recent document.

Frequently Asked Questions about escriptorium

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I correct transcriptions in eScriptorium through the MCP server?

Read the page's lines and transcription records first, then use create_line_transcription with a segmented line ID and layer ID, or update_line_transcription with the line transcription record ID. The record ID differs from the line ID, so always resolve it from prior reads.

How do I run OCR or train a model in eScriptorium?

Submit jobs with explicit page IDs and a model whose job type matches: 1 for segmentation, 2 for recognition. Training needs a ground-truth layer plus a starting model or new model name; a successful submission only means queued, so inspect task reports before reporting completion.

Does this skill work without an eScriptorium MCP server connection?

No. The skill only directs use of the connected escriptorium MCP tools and does not install or authenticate the server. If the connection is unavailable, it reports that prerequisite instead of attempting transcription work.

What export formats does eScriptorium support through these tools?

Use export_transcriptions for direct text or JSON of a single layer, and request_server_export for native ALTO/PAGE XML, text, or JSON document archives with optional images, annotations, and metadata. OpenITI and TEI formats require server-side enablement.

Why did my eScriptorium bulk update only partially apply?

Bulk line and text operations are non-atomic and can partially apply on failure. After any failure, re-read the affected records before retrying, and pause concurrent writers since preflight membership checks are not locks.

Can I use this skill for handwriting transcription without eScriptorium?

No. The skill is scoped to eScriptorium workflows through its MCP server and is not intended for general handwriting transcription without an eScriptorium connection. For standalone OCR of images, a different tool would be required.