Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

io.github.lazyants/transkribus

NPM · @LAZYANTS/TRANSKRIBUS-MCP-SERVER · SCANNED AUG 4

MCP server for the Transkribus REST API — collections, documents, HTR/OCR, and models.

+24 this week 77 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security83
  • No malware found by supply-chain analysis.Pass
  • CVE check failed: a known medium-severity CVE affects hono 4.12.33, reached via @modelcontextprotocol/sdk > hono. A fixed version is available. View diagnostics → Fail
  • No install/post-install scripts declared.Pass
  • Only part of the dependency tree could be resolved (107 of 108), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency84
  • Source repository is publicly reachable at the declared URL. View diagnostics → Pass
  • Cryptographically verified build provenance (signed, bound to lazyants/transkribus-mcp-server). View diagnostics → Pass
  • License check failed: the license (FSL-1.1-MIT) isn't a recognized OSI-approved license. See how to fix → Fail
  • Actively maintained (last published 17 days ago).Pass
  • Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability82
  • 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
  • AI-judged instruction clarity (good).Pass
  • Tool/resource definitions use about 21216 tokens (~70/item across 301 items; 300 tools + 1 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
  • Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @lazyants/transkribus-mcp-server

# add to Claude Code
claude mcp add lazyants-transkribus -- npx -y @lazyants/transkribus-mcp-server
# add to Codex CLI
codex mcp add lazyants-transkribus -- npx -y @lazyants/transkribus-mcp-server
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "lazyants-transkribus": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@lazyants/transkribus-mcp-server"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add lazyants-transkribus --command npx --arg -y --arg @lazyants/transkribus-mcp-server
# ~/.hermes/config.yaml
mcp_servers:
  lazyants-transkribus:
    command: "npx"
    args: ["-y", "@lazyants/transkribus-mcp-server"]
// mcp.json
{
  "mcpServers": {
    "lazyants-transkribus": {
      "command": "npx",
      "args": [
        "-y",
        "@lazyants/transkribus-mcp-server"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 4 Aug 26 +3
    • CVE-2026-69207 affects this package: medium security
    • Known CVEs: partial → fail security
    • Stability: unverified → 0.27 functional
  • 2 Aug 26 +48
    • Install scripts: unverified → pass security
    • Provenance: unverified → pass security
    • Known CVEs: unverified → partial security
    • Malware scan: unverified → pass security
    • Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
    • The attested source repository moved: lazyants/transkribus-mcp-server security
    • License: unverified → fail functional
    • Dependency health: unverified → partial functional
    • Maintenance: unverified → pass functional
    • Schema quality: unverified → good functional
    • MCP protocol: unverified → pass functional
    • Licence: FSL-1.1-MIT functional
  • 31 Jul 26 −27
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 27 Jul 26 53

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 4 Aug 2026 · Analysed npm/@lazyants/[email protected]

Provenance verified

Ecosystem: npm · Outcome: verified

Reason: verified

Source repo:
lazyants/transkribus-mcp-server
Certificate issuer:
https://token.actions.githubusercontent.com
Certificate SAN:
https://github.com/lazyants/transkribus-mcp-server/.github/workflows/publish-registry.yml@refs/tags/v3.0.0
Rekor log index:
2191746807
Predicate type:
https://slsa.dev/provenance/v1
Subject digest:
sha512:ea33452587f529623b38471e64829d121b58549662fb29d87645adcb49a15eb7826e44ae6a24a59ddaf9325eaaefeb74c4ecaa33d5fccef24c5601e4e
Discovery method:
attestation_endpoint
Vulnerabilities 1 finding
ID CVE Severity Vector Fix available
GHSA-8j4g-w8fx-2239 CVE-2026-69207 medium CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:L yes
Dependencies 107 packages

107 packages in the resolved dependency tree · 107 deprecated · 32 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 300 exposed · ~21,189 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
transkribus_page_delete_transcript ~61

Delete a specific transcript version from a page.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesDocument ID
keystringyesTranscript key to delete
pageintegeryesPage number

No output schema declared.

No examples provided.

transkribus_page_get ~49

Get details of a specific page in a document.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesDocument ID
pageintegeryesPage number

No output schema declared.

No examples provided.

transkribus_page_get_curr_transcript ~50

Get the current transcript for a page.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesDocument ID
pageintegeryesPage number

No output schema declared.

No examples provided.

transkribus_page_get_metadata ~47

Get metadata for a specific page.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesDocument ID
pageintegeryesPage number

No output schema declared.

No examples provided.

transkribus_page_get_plaintext ~51

Get the plain text content of a page transcript.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesDocument ID
pageintegeryesPage number

No output schema declared.

No examples provided.

transkribus_page_get_text ~49

Get the transcript text for a specific page.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesDocument ID
pageintegeryesPage number

No output schema declared.

No examples provided.

transkribus_page_get_transcript ~60

Get a specific transcript version for a page.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesDocument ID
pageintegeryesPage number
transcriptIdintegeryesTranscript ID

No output schema declared.

No examples provided.

transkribus_page_is_locked ~48

Check if a page is currently locked.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesDocument ID
pageintegeryesPage number

No output schema declared.

No examples provided.

transkribus_page_list_locks ~48

List all locks on a page.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesDocument ID
pageintegeryesPage number

No output schema declared.

No examples provided.

transkribus_page_list_transcripts ~95

List all transcript versions for a page.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesDocument ID
indexintegerStart index
nValuesintegerNumber of values
pageintegeryesPage number
sortColumnstringColumn to sort by
sortDirectionstringSort direction (asc/desc)

No output schema declared.

No examples provided.

transkribus_page_lock ~67

Lock or unlock a page for editing.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesDocument ID
pageintegeryesPage number
typebooleanWhether to lock (true) or unlock (false) the page

No output schema declared.

No examples provided.

transkribus_page_move ~106

Move a page to a different position within the document or to another document.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesDocument ID
moveTointegeryesTarget position to move the page to
moveToDocIdintegerTarget document ID to move the page to
nrIsPageIdbooleanTreat page nr as page ID (default false)
pageintegeryesPage number

No output schema declared.

No examples provided.

transkribus_page_post_transcript ~118

Post a new transcript for a page.

NameTypeReqDescription
bodyobjectTranscript data
collIdintegeryesCollection ID
idintegeryesDocument ID
notestringNote for the transcript
nrIsPageIdbooleanTreat page nr as page ID
pageintegeryesPage number
parentintegerParent transcript ID
statusstringTranscript status
toolNamestringTool name that created the transcript

No output schema declared.

No examples provided.

transkribus_page_replace ~47

Replace a page image in a document.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesDocument ID
pageintegeryesPage number

No output schema declared.

No examples provided.

transkribus_page_update_hide_on_sites ~96

Set whether a page is hidden on public sites.

NameTypeReqDescription
collIdintegeryesCollection ID
hidebooleanyesWhether to hide the page on sites
hideOnSitesbooleanWhether to hide on sites
idintegeryesDocument ID
nrIsPageIdbooleanTreat page nr as page ID
pageintegeryesPage number

No output schema declared.

No examples provided.

transkribus_page_update_status_v2 ~106

Update page status using transcript ID (alternative endpoint).

NameTypeReqDescription
bodyobjectStatus update data
collIdintegeryesCollection ID
idintegeryesDocument ID
notestringStatus note
nrIsPageIdbooleanTreat page nr as page ID
pageintegeryesPage number
statusstringNew status
transcriptIdintegeryesTranscript ID

No output schema declared.

No examples provided.

transkribus_page_update_transcript_status ~96

Update the status of a specific transcript version.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesDocument ID
notestringStatus note
nrIsPageIdbooleanTreat page nr as page ID
pageintegeryesPage number
statusstringyesNew transcript status
transcriptIdintegeryesTranscript ID

No output schema declared.

No examples provided.

transkribus_pylaia_recognize ~343

Run PyLaia HTR recognition on a document using a specific model.

NameTypeReqDescription
allowConcurrentExecutionbooleanAllow concurrent execution (default false)
b2pBackendstringBaseline to polygon backend (default "Legacy")
batchSizeintegerBatch size (default 10)
clearLinesbooleanClear existing lines before recognition
collIdintegeryesCollection ID
creditsstringCredits parameter
doLinePolygonSimplificationbooleanSimplify line polygons (default true)
doNotDeleteWorkDirbooleanDo not delete working directory
doStructuresstringStructure analysis mode
doWordSegbooleanPerform word segmentation
docIdintegeryesDocument ID
keepOriginalLinePolygonsbooleanKeep original line polygons (default false)
languageModelstringLanguage model to use
modelIdintegeryesModel/HTR ID
nBestintegerNumber of best results (default 1)
pagesstringPage range (e.g. "1-5")
printedLanguageModelstringLanguage model for printed text
printedModelIdintegerPrinted text model ID
useExistingLinePolygonsbooleanUse existing line polygons (default false)
writeKwsIndexbooleanWrite KWS index (default false)
writeLineConfScorebooleanWrite line confidence scores
writeWordConfScoresbooleanWrite word confidence scores

No output schema declared.

No examples provided.

transkribus_pylaia_train ~689

Start PyLaia HTR model training for a collection. By default, sends training parameters matching the Transkribus UI defaults (textFeatsCfg with TextFeats preprocessing, use_masked_conv=True, max_epochs=100). Without these defaults, the server uses different preprocessing (trpPreprocPars) which produces significantly worse models. Set noTrainingDefaults=true to send no training parameters (server defaults).

NameTypeReqDescription
baseModelIdintegerBase model ID for transfer learning
batch_sizeintegerBatch size (default: 24). Shortcut for trainCtcPars --batch_size.
collIdintegeryesCollection ID
createModelParsobjectModel architecture parameters as key-value pairs (e.g. {"--rnn_units": "512"}). Merged with UI defaults (use_masked_conv=True, cnn_poolsize="2 2 0 2", etc.). Only specify parameters you want to overr…
customAbbrevsTrainingbooleanEnable custom abbreviations training
customTagTrainingbooleanEnable custom tag training
descriptionstringDescription of the model
imgTypestringImage type
languagestringLanguage code (e.g. "rus", "deu", "eng")
learning_ratenumberLearning rate (default: 3.0E-4). Shortcut for trainCtcPars --learning_rate.
max_epochsintegerMaximum training epochs (default: 100). Shortcut for trainCtcPars --max_epochs.
max_nondecreasing_epochsintegerEarly stopping patience (default: 20). Shortcut for trainCtcPars --max_nondecreasing_epochs.
modelNamestringName for the new model
noTrainingDefaultsbooleanIf true, do NOT apply UI-default training parameters. The server will use its own defaults (which differ from the UI and may produce worse models).
omitLinesByTagarrayTags of lines to omit from training
providerstringTraining provider (default: "PyLaia")
reverseTextbooleanWhether to reverse text direction
testListarrayTest page list
testListFilestringAbsolute path to JSON file containing test page list array of {docId, pageId} objects. Example: /tmp/transkribus-training/test_list.json
textFeatsCfgobjectTextFeats preprocessing config override. Merged with UI defaults (normheight=64, deslope/deslant=true, enh=true). Only specify fields you want to change.
trainCtcParsobjectCTC training parameters as key-value pairs (e.g. {"--max_epochs": "200"}). Merged with UI defaults (max_epochs=100, learning_rate=3.0E-4, batch_size=24, etc.). Only specify parameters you want to ove…
trainListarrayTraining page list
trainListFilestringAbsolute path to JSON file containing training page list array of {docId, pageId} objects. Example: /tmp/transkribus-training/train_list.json
trainPropertiesbooleanEnable training properties

No output schema declared.

No examples provided.

transkribus_recog_add_to_collection ~58

Add a recognition model to another collection.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesResource ID
targetCollIdintegeryesTarget collection ID to add the model to

No output schema declared.

No examples provided.

transkribus_recog_compute_error_rate ~60

Compute the error rate for a model in a collection.

NameTypeReqDescription
bodyobjectAdditional error rate computation parameters
collIdintegeryesCollection ID
modelIdintegeryesModel/HTR ID

No output schema declared.

No examples provided.

transkribus_recog_compute_sample ~44

Compute a recognition sample for a document in a collection.

NameTypeReqDescription
collIdintegeryesCollection ID
docIdintegeryesDocument ID

No output schema declared.

No examples provided.

transkribus_recog_compute_wer ~90

Compute the Word Error Rate for a document.

NameTypeReqDescription
collIdintegeryesCollection ID
docIdintegeryesDocument ID
hypstringHypothesis transcript identifier
keystringTranscript key
pagesstringPage range (e.g. "1-5")
refstringReference transcript identifier

No output schema declared.

No examples provided.

transkribus_recog_compute_wer_tasas ~96

Compute the Word Error Rate using TASAS method for a document.

NameTypeReqDescription
collIdintegeryesCollection ID
docIdintegeryesDocument ID
hypstringHypothesis transcript identifier
keystringTranscript key
pagesstringPage range (e.g. "1-5")
refstringReference transcript identifier

No output schema declared.

No examples provided.

transkribus_recog_delete ~39

Delete a recognition model from a collection.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesResource ID

No output schema declared.

No examples provided.

transkribus_recog_get ~41

Get details of a recognition model in a collection.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesResource ID

No output schema declared.

No examples provided.

transkribus_recog_get_add_info ~43

Get information about adding a recognition model to collections.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesResource ID

No output schema declared.

No examples provided.

transkribus_recog_get_atr ~26

Retrieve information about available ATR (Automatic Text Recognition) models.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

transkribus_recog_get_costs ~77

Get the cost information for a recognition model.

NameTypeReqDescription
collIdintegeryesCollection ID
creditsstringCredits parameter
idintegeryesResource ID
nrOfPagesintegerNumber of pages
writeKwsIndexbooleanWrite KWS index

No output schema declared.

No examples provided.

transkribus_recog_get_error_rate ~65

Get the error rate for a collection or model.

NameTypeReqDescription
collIdintegerCollection ID
keystringKey identifier
modelIdintegerModel/HTR ID
refstringReference identifier

No output schema declared.

No examples provided.

transkribus_recog_get_ocr_costs ~98

Get the estimated OCR costs for a document.

NameTypeReqDescription
collIdintegeryesCollection ID
doBlockSegOnlybooleanOnly do block segmentation
docIdintegeryesDocument ID
idintegerModel ID
nrOfPagesintegerNumber of pages
pagesstringPage range
typestringOCR type

No output schema declared.

No examples provided.

transkribus_recog_get_test_set ~56

Get the test set data for a recognition model.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesResource ID
nrOfTranscriptsintegerNumber of transcripts

No output schema declared.

No examples provided.

transkribus_recog_get_train_data ~62

Get the training data for a recognition model.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesResource ID
indexintegerStart index
nValuesintegerNumber of values

No output schema declared.

No examples provided.

transkribus_recog_get_train_set ~55

Get the training set for a recognition model.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesResource ID
nrOfTranscriptsintegerNumber of transcripts

No output schema declared.

No examples provided.

transkribus_recog_get_validation_gt_by_htr ~66

Get validation ground truth data for a recognition model.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesResource ID
indexintegerStart index
nValuesintegerNumber of values

No output schema declared.

No examples provided.

transkribus_recog_list_by_collection ~96

List recognition models available in a specific collection.

NameTypeReqDescription
collIdintegeryesCollection ID
indexintegerStart index (0-based)
nValuesintegerNumber of results (-1 for all)
provstringFilter by provider
sortColumnstringColumn to sort by
sortDirectionstringSort direction: asc or desc

No output schema declared.

No examples provided.

transkribus_recog_list_collections ~43

List collections that have access to a recognition model.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesResource ID

No output schema declared.

No examples provided.

transkribus_recog_list_dicts ~20

List available dictionaries for recognition.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

transkribus_recog_list_models ~130

List available recognition models with optional filtering.

NameTypeReqDescription
collIdintegerFilter by collection ID
filterstringFilter string
indexintegerStart index (0-based)
nValuesintegerNumber of results (-1 for all)
provstringFilter by provider (alternative)
providerstringFilter by model provider
releaseLevelintegerFilter by release level
sortColumnstringColumn to sort by
sortDirectionstringSort direction: asc or desc

No output schema declared.

No examples provided.

transkribus_recog_remove_from_collection ~41

Remove a recognition model from a collection.

NameTypeReqDescription
collIdintegeryesCollection ID
idintegeryesResource ID

No output schema declared.

No examples provided.

transkribus_recog_run_atr ~68

Run Automatic Text Recognition on a document or specific pages.

NameTypeReqDescription
collIdintegeryesCollection ID
docIdintegeryesDocument ID
modelIdintegerModel/HTR ID
pageNrintegerPage number

No output schema declared.

No examples provided.

transkribus_recog_run_htr_citlab ~189

Run CITlab HTR recognition on a document using a specific model.

NameTypeReqDescription
allowConcurrentExecutionbooleanAllow concurrent execution (default false)
collIdintegeryesCollection ID
creditsstringCredits parameter
dictstringDictionary to use
doLinePolygonSimplificationbooleanSimplify line polygons (default true)
doStoreConfMatsbooleanStore confidence matrices (default true)
doStructuresbooleanRun structure analysis
docIdintegeryesDocument ID
keepOriginalLinePolygonsbooleanKeep original line polygons (default false)
modelIdintegeryesModel/HTR ID
pagesstringPage range (e.g. "1-5")
tempDictstringTemporary dictionary

No output schema declared.

No examples provided.

transkribus_recog_run_ocr ~126

Run OCR on a document or specific pages in a collection.

NameTypeReqDescription
collIdintegeryesCollection ID
doBlockSegOnlybooleanOnly do block segmentation (default false)
docIdintegeryesDocument ID
idintegerModel ID
languagestringLanguage for OCR
ocrTypestringOCR type (default "Legacy")
pagesstringPage range (e.g. "1-5")
typeFacestringType face for OCR

No output schema declared.

No examples provided.

transkribus_recog_run_trhtr ~169

Run TRHTR recognition using a specific model in a collection.

NameTypeReqDescription
allowConcurrentExecutionbooleanAllow concurrent execution
b2pBackendstringB2P backend type
collIdintegeryesCollection ID
creditsstringCredits parameter
doLinePolygonSimplificationbooleanSimplify line polygons
doNotDeleteWorkDirbooleanDo not delete work directory
idintegerDocument ID
modelIdintegeryesModel/HTR ID
modelNamestringModel name
pagesstringPage range (e.g. "1-5")
useExistingLinePolygonsbooleanUse existing line polygons

No output schema declared.

No examples provided.

transkribus_recog_text2image ~86

Run Text2Image alignment using a specific model in a collection.

NameTypeReqDescription
bodyobjectyesText2Image parameters
collIdintegeryesCollection ID
creditsstringCredits parameter
doNotDeleteWorkDirbooleanDo not delete work directory
modelIdintegeryesModel/HTR ID

No output schema declared.

No examples provided.

transkribus_recog_text2image_citlab ~50

Run CITlab Text2Image alignment for a collection.

NameTypeReqDescription
bodyobjectyesText2Image configuration parameters
collIdintegeryesCollection ID

No output schema declared.

No examples provided.

transkribus_recog_text2image_matching ~216

Run Text2Image matching using a specific model in a collection.

NameTypeReqDescription
addNotMatchedTextInLastLinebooleanAdd unmatched text in last line
allowDoubleMatchingbooleanAllow double matching
blockThreshnumberBlock threshold
collIdintegeryesCollection ID
creditsstringCredits parameter
doNotDeleteWorkDirbooleanDo not delete work directory
docIdintegeryesDocument ID
keepUnmatchedLinesbooleanKeep unmatched lines
lineThreshnumberLine threshold
modelIdintegeryesModel/HTR ID
pagesstringPage range (e.g. "1-5")
preserveLineOrderbooleanPreserve line order
reductionMethodintegerReduction method
useCurrentTranskriptbooleanUse current transcript
useSourceLineFeedsbooleanUse source line feeds

No output schema declared.

No examples provided.

transkribus_recog_train_htr_citlab ~48

Start CITlab HTR model training for a collection.

NameTypeReqDescription
collIdintegeryesCollection ID
configobjectyesTraining configuration parameters

No output schema declared.

No examples provided.

transkribus_recog_train_la_citlab ~47

Start CITlab Layout Analysis model training for a collection.

NameTypeReqDescription
collIdintegeryesCollection ID
configobjectyesTraining configuration parameters

No output schema declared.

No examples provided.

transkribus_recog_train_la2 ~45

Start Layout Analysis 2 model training for a collection.

NameTypeReqDescription
collIdintegeryesCollection ID
configobjectyesTraining configuration parameters

No output schema declared.

No examples provided.