transkribus_action_count
Get the total count of actions, optionally filtered by collection or type.
Drive Transkribus from an assistant — collections, documents, HTR and OCR runs, model training and search.
LABSCO SUMMARY
300 tools is more than most clients will accept and far more than any one task needs. The split entry points exist precisely for that — transcription work is 47 tools, search is 16 — and choosing one is the difference between a working setup and a client that refuses to connect.
A wrapper over the Transkribus REST API for handwritten and printed text recognition. It covers collections and documents, page transcripts, recognition and layout-analysis runs, model training and management, search and keyword spotting, and the jobs, credits and uploads underneath all of it.
The npm package @lazyants/transkribus-mcp-server over stdio. Authentication is session-based: set TRANSKRIBUS_USER and TRANSKRIBUS_PASSWORD and the server logs in and manages the session, or set TRANSKRIBUS_SESSION_ID if you already hold one — session IDs expire, so credentials are the choice for anything long-running. Pick a split binary rather than the full server if your client caps tool counts: transkribus-mcp-collections is 132 tools, admin 62, transcription 47, users 29, models 26, jobs 18, search 16. Scope is the legacy TrpServer REST API; the newer Processing API v2 is deliberately out of scope. This is an unofficial server, not affiliated with READ-COOP SCE.
One command plus credentials — npm install -g @lazyants/transkribus-mcp-server, then supply credentials
USE CASES
Kick off ATR or OCR against selected pages and follow the job until it finishes.
Read the plain text of the current transcript, or a specific earlier version of it.
Create the collection, then ingest documents from PDFs or a IIIF manifest.
Compute the word error rate for a document and read the error rate recorded for the model.
Start a PyLaia or CITlab training run and inspect the training set it was built from.
Full-text search across transcriptions, or a keyword-spotting query with per-hit results.
Cost estimates for OCR, layout analysis and the document as a whole, before credits are spent.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
transkribus_action_countGet the total count of actions, optionally filtered by collection or type.
transkribus_action_infoRetrieve detailed information about a specific action.
transkribus_action_listList actions with optional filtering by collection, type, and pagination.
transkribus_admin_authorize_users_for_jobAuthorize specific users to run a job implementation.
transkribus_admin_get_job_logRetrieve the log output for a specific job.
transkribus_admin_get_job_usersList users authorized to run a specific job implementation.
transkribus_admin_get_reportsRetrieve administrative reports by type and time period.
transkribus_admin_list_sessionsList all currently active user sessions.
transkribus_admin_move_field_modelMove a field recognition model to a different directory.
transkribus_admin_move_table_modelMove a table recognition model to a different directory.
transkribus_admin_rebuild_models_indexRebuild the search index for all recognition models.
transkribus_auth_check_sessionCheck if the current Transkribus session is valid.
transkribus_auth_get_detailsGet details of the currently authenticated user.
transkribus_auth_invalidateInvalidate the current authentication session.
transkribus_auth_logoutLog out of the current Transkribus session.
transkribus_auth_refreshRefresh the current authentication session token.
transkribus_coll_activity_recognitionGet recognition activity records for a collection.
transkribus_coll_activity_savesGet save activity records for a collection.
transkribus_coll_add_docAdd an existing document to a collection.
transkribus_coll_add_docsAdd multiple existing documents to a collection.
transkribus_coll_add_favoriteAdd a collection to the user favorites.
transkribus_coll_can_manageCheck if the current user can manage the specified collection.
transkribus_coll_countGet the total number of collections accessible to the current user.
transkribus_coll_count_docsGet the number of documents in a collection.
transkribus_coll_count_find_documentsCount documents matching the given search criteria.
transkribus_coll_createCreate a new collection with the given name.
transkribus_coll_create_doc_from_ftpIngest a document into a collection from an FTP source.
transkribus_coll_create_doc_from_iiifCreate a document in a collection from an IIIF manifest URL.
transkribus_coll_create_doc_from_metsCreate a document in a collection from METS metadata.
transkribus_coll_create_doc_from_mets_urlCreate a document in a collection from a METS URL.
transkribus_coll_create_doc_from_pdfCreate a document in a collection from a PDF file.
transkribus_coll_create_iob_importCreate documents from an IOB import.
transkribus_coll_credit_add_packageAdd a credit package to a collection.
transkribus_coll_credit_historyGet the credit usage history for a collection.
transkribus_coll_credit_listList credit packages associated with a collection.
transkribus_coll_credit_remove_packageRemove a credit package from a collection.
transkribus_coll_credit_transactionsGet credit transaction records for a collection.
transkribus_coll_deleteDelete a collection by ID.
transkribus_coll_delete_emptyDelete a collection only if it is empty.
transkribus_coll_duplicateDuplicate an entire collection.
transkribus_coll_duplicate_docDuplicate a document within a collection.
transkribus_coll_ead_metadata_importImport EAD metadata into a collection.
transkribus_coll_exportExport documents from a collection in the specified format.
transkribus_coll_find_documentsSearch for documents across collections using filters.
transkribus_coll_find_documents_oldSearch for documents using the legacy endpoint.
transkribus_coll_find_documents_postSearch for documents across collections using a POST request body.
transkribus_coll_get_metadataGet metadata for a collection.
transkribus_coll_get_recentGet recently accessed items in a collection.
transkribus_coll_get_recent_collectionsGet recently accessed collections.
transkribus_coll_get_recent_documentsGet recently accessed documents.
transkribus_coll_get_tag_defsList tag definitions for a collection.
transkribus_coll_label_listList all labels associated with a collection.
transkribus_coll_listList all collections accessible to the current user.
transkribus_coll_list_by_nameSearch for collections by name.
transkribus_coll_list_docsList all documents in a collection with pagination.
transkribus_coll_list_docs_xmlList all documents in a collection in XML format.
transkribus_coll_list_for_userList collections accessible to a specific user.
transkribus_coll_list_pagedList collections with pagination support.
transkribus_coll_list_xmlList all collections in XML format.
transkribus_coll_modifyModify the properties of a collection.
transkribus_coll_remove_docRemove a document from a collection without deleting it.
transkribus_coll_remove_favoriteRemove a collection from the user favorites.
transkribus_coll_remove_userRemove a user from a collection using the POST endpoint.
transkribus_coll_subscribe_getGet the subscription status for a collection.
transkribus_coll_update_default_tag_defsUpdate the default tag definitions across all collections.
transkribus_coll_update_metadataUpdate the metadata for a collection.
transkribus_coll_update_tag_defsUpdate tag definitions for a specific collection.
transkribus_coll_upload_docUpload a document to a collection.
transkribus_coll_upload_doc_multipartUpload a document to a collection using multipart form data.
transkribus_coll_user_addAdd a new user to a collection with an optional role.
transkribus_coll_user_add_or_modifyAdd a user to a collection or modify their role if they already exist.
transkribus_coll_user_countGet the number of users in a collection.
transkribus_coll_user_get_listGet the list of users with access to a collection.
transkribus_coll_user_listList users of a collection with optional pagination.
transkribus_coll_user_removeRemove a user from a collection by their user ID.
transkribus_coll_user_statsGet user statistics for a collection.
transkribus_coll_user_update_roleUpdate the role of a user in a collection.
transkribus_credit_createCreate a new credit package.
transkribus_credit_getGet details of a specific credit package by ID.
transkribus_credit_get_collectionsList collections associated with a specific credit package.
transkribus_credit_get_costsGet the credit cost information, optionally filtered by type.
transkribus_credit_get_historyGet the credit usage history with pagination.
transkribus_credit_get_package_transactionsList credit transactions for a specific credit package.
transkribus_credit_get_productsList available credit products for purchase.
transkribus_credit_get_transactionsList credit transactions with pagination.
transkribus_credit_handle_orderProcess a credit order by ID.
transkribus_credit_list_by_userList credit packages for the current user.
transkribus_credit_manageCreate or update credit history entries.
transkribus_credit_updateUpdate an existing credit package by ID.
transkribus_crowd_delete_messagesDelete messages from the crowd project of a collection.
transkribus_crowd_delete_milestonesDelete milestones from the crowd project of a collection.
transkribus_crowd_get_projectGet the crowd project details for a collection.
transkribus_crowd_post_messageStore a new message in the crowd project of a collection.
transkribus_crowd_post_milestoneStore a new milestone in the crowd project of a collection.
transkribus_crowd_post_projectCreate or update the crowd project configuration for a collection.
transkribus_crowdsource_countGet the total count of crowdsourcing projects.
transkribus_crowdsource_get_detailsGet crowdsourcing details for a collection.
transkribus_crowdsource_listList available crowdsourcing projects.
transkribus_crowdsource_subscribeSubscribe to a crowdsourcing project for a collection.
transkribus_crowdsource_unsubscribeUnsubscribe from a crowdsourcing project for a collection.
transkribus_doc_deleteDelete a document from a collection.
transkribus_doc_exportExport a document in the specified format.
transkribus_doc_get_costsGet the processing costs for a document.
transkribus_doc_get_editorial_declarationGet the editorial declaration for a document.
transkribus_doc_get_fulldocGet the full document including all pages and transcripts.
transkribus_doc_get_fulldoc_xmlGet the full document in XML format.
transkribus_doc_get_image_namesGet the image file names for all pages in a document.
transkribus_doc_get_metadataGet metadata for a document.
transkribus_doc_get_metsGet the METS metadata for a document.
transkribus_doc_get_page_idsGet the page IDs for all pages in a document.
transkribus_doc_get_pagesGet all pages for a document.
transkribus_doc_get_statGet document statistics summary.
transkribus_doc_get_statsGet detailed statistics for a document.
transkribus_doc_get_test_setGet the test set data for a document.
transkribus_doc_get_train_dataGet the training data for a document.
transkribus_doc_get_transcript_idsGet all transcript IDs for a document.
transkribus_doc_get_validation_dataGet the validation data for a document.
transkribus_doc_has_affiliationCheck if a document has an affiliation.
transkribus_doc_kws_searchSearch for keywords within a document.
transkribus_doc_list_collectionsList all collections a document belongs to.
transkribus_doc_list_collections_pagedList all collections a document belongs to with pagination.
transkribus_doc_list_pagesList pages in a document with pagination.
transkribus_doc_move_pages_by_image_namesMove pages within a document based on image names.
transkribus_doc_post_editorial_declarationCreate or update the editorial declaration for a document.
transkribus_doc_remove_from_collectionRemove a document from a collection without deleting it.
transkribus_doc_update_metadataUpdate metadata for a document.
transkribus_doc_update_metadata_v2Update document metadata using the v2 endpoint.
transkribus_doc_update_transcriptUpdate a transcript for a specific page in a document.
transkribus_du_recognizeRun Document Understanding recognition on a document using a specific model.
transkribus_editdecl_delete_featureDelete an editorial declaration feature from a collection.
transkribus_editdecl_delete_optionDelete an option from an editorial declaration feature.
transkribus_editdecl_list_featuresList all editorial declaration features for a collection.
transkribus_editdecl_post_featureStore a new editorial declaration feature in a collection.
transkribus_editdecl_post_optionStore a new option for an editorial declaration feature.
transkribus_elearning_countGet the total count of e-learning courses.
transkribus_elearning_listList available e-learning courses.
transkribus_elearning_subscribeSubscribe to an e-learning course for a collection.
transkribus_elearning_unsubscribeUnsubscribe from an e-learning course for a collection.
transkribus_file_checkCheck the status or existence of a file at a given path.
transkribus_file_list_dirsList directories at a given path on the server.
transkribus_file_list_filesList files at a given path on the server.
transkribus_job_countGet the total number of jobs, optionally filtered by status or type.
transkribus_job_createCreate a new processing job.
transkribus_job_getGet details of a specific job by ID.
transkribus_job_get_credit_transactionsGet credit transactions associated with a specific job.
transkribus_job_get_errorsGet error details for a specific job.
transkribus_job_killKill a running job by ID.
transkribus_job_listList jobs with pagination, optionally filtered by status or type.
transkribus_job_restart_all_by_userRestart all jobs for a specific user.
transkribus_job_undoUndo the results of a completed job.
transkribus_job_updateUpdate properties of an existing job.
transkribus_kws_create_queryCreate a new keyword spotting query.
transkribus_kws_get_hitsGet hits for a keyword spotting query.
transkribus_kws_get_keywordsGet keywords for a keyword spotting query.
transkribus_kws_get_result_dataGet result data for a keyword spotting query.
transkribus_kws_list_queriesList keyword spotting queries.
transkribus_la_analyzeRun layout analysis on document pages.
transkribus_la_analyze_advancedRun advanced layout analysis with additional parameters.
transkribus_la_get_costsGet the cost estimate for layout analysis on a document.
transkribus_la_la2_inferenceRun LA2 model inference on document pages.
transkribus_la_table_inferenceRun table structure inference on document pages.
transkribus_label_assign_documentsAssign documents to a label.
transkribus_label_assign_pagesAssign pages to a label.
transkribus_label_createCreate a new label.
transkribus_label_deleteDelete a label by ID.
transkribus_label_getGet a label by ID.
transkribus_label_listList all labels.
transkribus_label_remove_all_documentsRemove all documents from a label.
transkribus_label_remove_all_pagesRemove all pages from a label.
transkribus_label_remove_documentsRemove documents from a label.
transkribus_label_remove_pagesRemove pages from a label.
transkribus_label_replace_document_assignmentsReplace label assignments for a specific document.
transkribus_label_replace_page_assignmentsReplace label assignments for a specific page.
transkribus_label_updateUpdate an existing label by ID.
transkribus_model_add_collectionAdd a collection to a model by type and model ID.
transkribus_model_add_collection_by_idAdd a collection to a model by model ID and collection ID.
transkribus_model_deleteDelete a model by its ID.
transkribus_model_delete_by_typeDelete a model by its type and ID.
transkribus_model_getGet details of a model by its ID.
transkribus_model_get_by_typeGet models filtered by type with optional query parameters.
transkribus_model_get_detailsGet detailed information about a model by type and ID.
transkribus_model_get_field_paramsGet the field parameters for a model by type and ID.
transkribus_model_get_train_dataGet the training data for a model by type and ID.
transkribus_model_get_train_data_docsGet the documents used as training data for a model.
transkribus_model_get_train_data_statsGet statistics about the training data for a model.
transkribus_model_get_validation_dataGet the validation data for a model by type and ID.
transkribus_model_get_validation_data_docsGet the documents used as validation data for a model.
transkribus_model_get_validation_data_statsGet statistics about the validation data for a model.
transkribus_model_listList available models with optional pagination and filtering.
transkribus_model_list_collectionsList collections associated with a model by type and ID.
transkribus_model_list_collections_by_idList collections associated with a model by its ID.
transkribus_model_remove_collectionRemove a collection from a model by type, model ID, and collection ID.
transkribus_model_remove_collection_by_idRemove a collection from a model by model ID and collection ID.
transkribus_model_updateUpdate a model by posting updated model data.
transkribus_model_update_by_typeUpdate a model by its type and ID.
transkribus_p2pala_trainStart P2PaLA layout analysis model training for a collection.
transkribus_page_addAdd a new page to a document at the specified position.
transkribus_page_assign_plaintextAssign plain text content to a page as a new transcript.
transkribus_page_count_transcriptsGet the number of transcripts for a page.
transkribus_page_deleteDelete a page from a document.
transkribus_page_delete_transcriptDelete a specific transcript version from a page.
transkribus_page_getGet details of a specific page in a document.
transkribus_page_get_curr_transcriptGet the current transcript for a page.
transkribus_page_get_metadataGet metadata for a specific page.
transkribus_page_get_plaintextGet the plain text content of a page transcript.
transkribus_page_get_textGet the transcript text for a specific page.
transkribus_page_get_transcriptGet a specific transcript version for a page.
transkribus_page_is_lockedCheck if a page is currently locked.
transkribus_page_list_locksList all locks on a page.
transkribus_page_list_transcriptsList all transcript versions for a page.
transkribus_page_lockLock or unlock a page for editing.
transkribus_page_moveMove a page to a different position within the document or to another document.
transkribus_page_post_transcriptPost a new transcript for a page.
transkribus_page_replaceReplace a page image in a document.
transkribus_page_update_hide_on_sitesSet whether a page is hidden on public sites.
transkribus_page_update_status_v2Update page status using transcript ID (alternative endpoint).
transkribus_page_update_transcript_statusUpdate the status of a specific transcript version.
transkribus_pylaia_recognizeRun PyLaia HTR recognition on a document using a specific model.
transkribus_pylaia_trainStart 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).
transkribus_recog_add_to_collectionAdd a recognition model to another collection.
transkribus_recog_compute_error_rateCompute the error rate for a model in a collection.
transkribus_recog_compute_sampleCompute a recognition sample for a document in a collection.
transkribus_recog_compute_werCompute the Word Error Rate for a document.
transkribus_recog_compute_wer_tasasCompute the Word Error Rate using TASAS method for a document.
transkribus_recog_deleteDelete a recognition model from a collection.
transkribus_recog_getGet details of a recognition model in a collection.
transkribus_recog_get_add_infoGet information about adding a recognition model to collections.
transkribus_recog_get_atrRetrieve information about available ATR (Automatic Text Recognition) models.
transkribus_recog_get_costsGet the cost information for a recognition model.
transkribus_recog_get_error_rateGet the error rate for a collection or model.
transkribus_recog_get_ocr_costsGet the estimated OCR costs for a document.
transkribus_recog_get_test_setGet the test set data for a recognition model.
transkribus_recog_get_train_dataGet the training data for a recognition model.
transkribus_recog_get_train_setGet the training set for a recognition model.
transkribus_recog_get_validation_gt_by_htrGet validation ground truth data for a recognition model.
transkribus_recog_list_by_collectionList recognition models available in a specific collection.
transkribus_recog_list_collectionsList collections that have access to a recognition model.
transkribus_recog_list_dictsList available dictionaries for recognition.
transkribus_recog_list_modelsList available recognition models with optional filtering.
transkribus_recog_remove_from_collectionRemove a recognition model from a collection.
transkribus_recog_run_atrRun Automatic Text Recognition on a document or specific pages.
transkribus_recog_run_htr_citlabRun CITlab HTR recognition on a document using a specific model.
transkribus_recog_run_ocrRun OCR on a document or specific pages in a collection.
transkribus_recog_run_trhtrRun TRHTR recognition using a specific model in a collection.
transkribus_recog_text2imageRun Text2Image alignment using a specific model in a collection.
transkribus_recog_text2image_citlabRun CITlab Text2Image alignment for a collection.
transkribus_recog_text2image_matchingRun Text2Image matching using a specific model in a collection.
transkribus_recog_train_htr_citlabStart CITlab HTR model training for a collection.
transkribus_recog_train_la_citlabStart CITlab Layout Analysis model training for a collection.
transkribus_recog_train_la2Start Layout Analysis 2 model training for a collection.
transkribus_recog_train_tableStart table recognition model training for a collection.
transkribus_recog_updateUpdate a recognition model in a collection.
transkribus_search_fulltextSearch across document transcriptions using a fulltext query.
transkribus_search_keywordSearch for documents matching a keyword.
transkribus_search_replaceSearch for a term and replace it across documents.
transkribus_search_replace_in_collectionSearch for a term and replace it within a specific collection.
transkribus_search_reset_indexReset the search index, optionally for a specific collection.
transkribus_search_tagsSearch for tags, optionally filtered by collection or tag name.
transkribus_server_available_filesList available client files on the server.
transkribus_server_bug_reportSubmit a bug report to the Transkribus server.
transkribus_server_client_versionGet the current Transkribus client version.
transkribus_server_download_client_fileDownload a specific client file by name.
transkribus_server_download_client_file_newDownload a specific client file using the new endpoint.
transkribus_server_download_guiDownload the latest Transkribus GUI version.
transkribus_server_get_eventsRetrieve server events and notifications.
transkribus_server_versionGet the current Transkribus server version.
transkribus_stat_get_collGet statistics for a collection.
transkribus_stat_get_coll_statsGet collection statistics using the new stats endpoint.
transkribus_stat_get_page_statusGet the page status overview for a collection.
transkribus_stat_get_pages_filteredGet collection pages with filtering via POST body.
transkribus_stat_get_storage_usageGet storage usage details for a collection.
transkribus_stat_update_page_statusUpdate the status of pages in a collection.
transkribus_system_db_statusCheck the status of the Transkribus database.
transkribus_system_fimagestoreCheck the status of the Transkribus image store.
transkribus_upload_bulk_update_doc_metadataBulk update document metadata for uploads.
transkribus_upload_bulk_update_isad_metadataBulk update ISAD(G) metadata for uploads.
transkribus_upload_create_from_metsCreate upload from METS file.
transkribus_upload_create_s3Create an upload from an S3 source.
transkribus_upload_create_structureCreate upload document structure.
transkribus_upload_deleteDelete an upload by ID.
transkribus_upload_get_bulk_doc_metadataRetrieve bulk document metadata for uploads.
transkribus_upload_get_bulk_isad_metadataRetrieve bulk ISAD(G) metadata for uploads.
transkribus_upload_get_statusGet the status of an upload by ID.
transkribus_upload_pageUpload a page to an existing upload.
transkribus_upload_update_metadataUpdate metadata for an existing upload.
transkribus_user_activity_recognitionGet recognition activity history for a specific user.
transkribus_user_activity_savesGet save activity history for a specific user.
transkribus_user_count_my_docsGet the total number of documents owned by the current user.
transkribus_user_deleteDelete a user by ID.
transkribus_user_findSearch for users by username/email.
transkribus_user_getGet details of a specific user by ID.
transkribus_user_get_job_aclGet the job access control list for the current user.
transkribus_user_get_statsGet usage statistics for the current user.
transkribus_user_get_storageGet storage usage information for a specific user.
transkribus_user_initInitialize or set up a user account by ID.
transkribus_user_is_allowed_for_jobCheck if the current user is allowed to run a specific job type.
transkribus_user_listList all users with pagination.
transkribus_user_list_my_docsList documents owned by the current user with pagination.
transkribus_user_list_tag_defsList all tag definitions for the current user.
transkribus_user_update_tag_defsCreate or update tag definitions for the current user.
BEFORE YOU INSTALL
300 tools when we connected. The split entry points expose smaller sets instead, such as transkribus-mcp-collections with 132 and transkribus-mcp-search with 16.
TRANSKRIBUS_SESSION_ID in your environment
CONTEXT COST
Rated by the size of the 300 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
npm install -g @lazyants/transkribus-mcp-server{
"mcpServers": {
"transkribus": {
"command": "npx",
"args": [
"-y",
"@lazyants/transkribus-mcp-server"
],
"env": {
"TRANSKRIBUS_USER": "<YOUR_TRANSKRIBUS_USER>",
"TRANSKRIBUS_PASSWORD": "<YOUR_TRANSKRIBUS_PASSWORD>"
}
}
}
}The configuration on this page does not set TRANSKRIBUS_SESSION_ID; the project's instructions set it with an export line. An app opened from its icon or dock does not see variables exported in a terminal, so to supply TRANSKRIBUS_SESSION_ID, use the block's "env" section.
{
"mcpServers": {
"transkribus-collections": {
"command": "npx",
"args": [
"-y",
"-p",
"@lazyants/transkribus-mcp-server",
"transkribus-mcp-collections"
],
"env": {
"TRANSKRIBUS_USER": "<YOUR_TRANSKRIBUS_USER>",
"TRANSKRIBUS_PASSWORD": "<YOUR_TRANSKRIBUS_PASSWORD>"
}
},
"transkribus-transcription": {
"command": "npx",
"args": [
"-y",
"-p",
"@lazyants/transkribus-mcp-server",
"transkribus-mcp-transcription"
],
"env": {
"TRANSKRIBUS_USER": "<YOUR_TRANSKRIBUS_USER>",
"TRANSKRIBUS_PASSWORD": "<YOUR_TRANSKRIBUS_PASSWORD>"
}
}
}
}The configuration on this page does not set TRANSKRIBUS_SESSION_ID; the project's instructions set it with an export line. An app opened from its icon or dock does not see variables exported in a terminal, so to supply TRANSKRIBUS_SESSION_ID, use the block's "env" section.