Search and read AtoM archival catalogues with citable links; staff propose changes for review.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Read an authority record (a person, family or organisation) by its slug.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Read an authority record (a person, family or organisation) by its slug.
| Argument | Type | Description |
|---|---|---|
| slug* | string | |
| catalogue | string |
{
"type": "object",
"title": "get_authorityArguments",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"title": "Slug"
},
"catalogue": {
"type": "string",
"title": "Catalogue",
"default": ""
}
}
}List the descriptions directly below one record (for example the series in a fonds).
| Argument | Type | Description |
|---|---|---|
| skip | integer | |
| slug* | string | |
| limit | integer | |
| catalogue | string |
{
"type": "object",
"title": "get_childrenArguments",
"required": [
"slug"
],
"properties": {
"skip": {
"type": "integer",
"title": "Skip",
"default": 0
},
"slug": {
"type": "string",
"title": "Slug"
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 25
},
"catalogue": {
"type": "string",
"title": "Catalogue",
"default": ""
}
}
}Return the IIIF manifest URL for a record's images, for viewing in a IIIF viewer.
| Argument | Type | Description |
|---|---|---|
| slug* | string | |
| catalogue | string |
{
"type": "object",
"title": "get_iiif_manifestArguments",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"title": "Slug"
},
"catalogue": {
"type": "string",
"title": "Catalogue",
"default": ""
}
}
}Read one archival description in full, by its slug (the last part of its URL). Includes dates, names, subjects, places, notes and, where the catalogue provides them, its place in the hierarchy, its number of children, images, and its provenance chain (owners, dates, transfers, certainty, gaps).
| Argument | Type | Description |
|---|---|---|
| slug* | string | |
| catalogue | string |
{
"type": "object",
"title": "get_recordArguments",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"title": "Slug"
},
"catalogue": {
"type": "string",
"title": "Catalogue",
"default": ""
}
}
}Look at a record's image: returns the reference image itself, so you can describe what it shows, read inscriptions or labels, or judge its condition. Use it before proposing a description for a record whose own text is thin. Only images the caller may view are returned (the reference copy, never the master). Say what you saw and what you inferred, and treat inscriptions you cannot read clearly as uncertain.
| Argument | Type | Description |
|---|---|---|
| slug* | string | |
| catalogue | string |
{
"type": "object",
"title": "get_record_imageArguments",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"title": "Slug"
},
"catalogue": {
"type": "string",
"title": "Catalogue",
"default": ""
}
}
}Read the text held for a record's files: text extracted from a PDF or by OCR, and transcriptions of audio or video. Use it for documents, where reading the text beats looking at a small image. Long text comes in pages: if a result says more=true, call again with offset set to offset + the length you received. Personal information may be masked. Quote what you rely on when you propose changes.
| Argument | Type | Description |
|---|---|---|
| slug* | string | |
| limit | integer | |
| offset | integer | |
| catalogue | string |
{
"type": "object",
"title": "get_record_textArguments",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"title": "Slug"
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20000
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0
},
"catalogue": {
"type": "string",
"title": "Catalogue",
"default": ""
}
}
}The catalogues this service can search and read. Proposals go to the home catalogue only.
No arguments.
{
"type": "object",
"title": "list_cataloguesArguments",
"properties": {}
}List the proposals you made and what became of them, newest first. Each shows the record, the name, place, date or field text proposed, and its status: pending, approved, edited, linked (to an authority record), rejected, new_record_created or parked, with who reviewed it and when. Check it before proposing for a record, and do not propose again what was rejected. Needs the archivist's own staff key.
| Argument | Type | Description |
|---|---|---|
| skip | integer | |
| limit | integer | |
| status | any |
{
"type": "object",
"title": "list_my_proposalsArguments",
"properties": {
"skip": {
"type": "integer",
"title": "Skip",
"default": 0
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 25
},
"status": {
"anyOf": [
{
"enum": [
"pending",
"approved",
"edited",
"linked",
"rejected",
"new_record_created",
"parked"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Status",
"default": null
}
}
}Propose access points (people, organisations, places) and dates for one record. Read the record with get_record first. Propose only what its text, or a reliable source you name, supports; give the evidence and source URLs for each. For a person or organisation, also give dates_of_existence, a short history and places when the record or a source states them: they pre-fill the new authority record if the archivist creates one. Look names and places up with search_authorities first; when one is already in the catalogue, give its id as existing_id and why in link_reason, and the archivist sees it as the first candidate to link. Nothing on the record changes: an archivist reviews every proposal. On AtoM with the AHG extensions they are queued in AI > NER review; on stock AtoM they are returned for the archivist to apply. Needs the archivist's own staff key.
| Argument | Type | Description |
|---|---|---|
| slug* | string | |
| proposals* | array |
{
"type": "object",
"$defs": {
"Proposal": {
"type": "object",
"title": "Proposal",
"required": [
"kind",
"value"
],
"properties": {
"kind": {
"enum": [
"person",
"organisation",
"place",
"date"
],
"type": "string",
"title": "Kind"
},
"value": {
"type": "string",
"title": "Value",
"description": "As it should appear: a name, a place, or a date such as \"1954\" or \"1938-1945\"."
},
"places": {
"type": "string",
"title": "Places",
"default": "",
"description": "Person or organisation only: places associated with them, separated by semicolons."
},
"history": {
"type": "string",
"title": "History",
"default": "",
"description": "Person or organisation only: a short biographical or administrative history, from the record or a named source."
},
"sources": {
"type": "array",
"items": {
"type": "string"
},
"title": "Sources",
"description": "URLs of web sources used, if any."
},
"evidence": {
"type": "string",
"title": "Evidence",
"default": "",
"description": "Where in the record, or which source, supports it."
},
"existing_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Existing Id",
"default": null,
"description": "Id from search_authorities of the existing record this most likely is (not for dates)."
},
"link_reason": {
"type": "string",
"title": "Link Reason",
"default": "",
"description": "With existing_id: why it is the same person, organisation or place, e.g. matching dates or places."
},
"dates_of_existence": {
"type": "string",
"title": "Dates Of Existence",
"default": "",
"description": "Person or organisation only: life or existence dates for a new authority record, e.g. \"1874-1949\"."
}
}
}
},
"title": "propose_access_points_and_datesArguments",
"required": [
"slug",
"proposals"
],
"properties": {
"slug": {
"type": "string",
"title": "Slug"
},
"proposals": {
"type": "array",
"items": {
"$ref": "#/$defs/Proposal"
},
"title": "Proposals"
}
}
}Propose new text for one field of a record, for an archivist to review. text is the complete proposed text for the field, not a fragment: read the record with get_record first and keep what is right in the current text. For a title, propose the title only (at most 1,024 characters). Give the evidence and the URLs of any web sources. Nothing on the record changes: on AtoM with the AHG extensions the proposal is queued in AI > Suggest review, where the archivist can edit it before approving; on stock AtoM it is returned for the archivist to apply. Needs the archivist's own staff key.
| Argument | Type | Description |
|---|---|---|
| slug* | string | |
| text* | string | |
| field* | string | |
| sources | any | |
| evidence | string |
{
"type": "object",
"title": "propose_description_changeArguments",
"required": [
"slug",
"field",
"text"
],
"properties": {
"slug": {
"type": "string",
"title": "Slug"
},
"text": {
"type": "string",
"title": "Text"
},
"field": {
"enum": [
"title",
"scope_and_content",
"archival_history",
"extent_and_medium",
"arrangement",
"access_conditions",
"reproduction_conditions"
],
"type": "string",
"title": "Field"
},
"sources": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Sources",
"default": null
},
"evidence": {
"type": "string",
"title": "Evidence",
"default": ""
}
}
}Propose relationships between people or organisations that a record states, such as a marriage or parent and child in a family register. Each side must be an existing authority record (give its id from search_authorities) or a person or organisation you have already proposed for this record with propose_access_points_and_dates. Give the line that states each relationship as evidence. An archivist reviews them in AI > Relationship review; approved ones show on both authority records. Needs the archivist's own staff key.
| Argument | Type | Description |
|---|---|---|
| slug* | string | |
| relationships* | array |
{
"type": "object",
"$defs": {
"Relationship": {
"type": "object",
"title": "Relationship",
"required": [
"subject",
"relation",
"object"
],
"properties": {
"date": {
"type": "string",
"title": "Date",
"default": "",
"description": "When it held, as written, e.g. \"married 2 May 1898\" or \"1898-1949\"."
},
"object": {
"type": "string",
"title": "Object",
"description": "The second person or organisation."
},
"sources": {
"type": "array",
"items": {
"type": "string"
},
"title": "Sources",
"description": "URLs of web sources used, if any."
},
"subject": {
"type": "string",
"title": "Subject",
"description": "The first person or organisation, as proposed for this record or as named in the catalogue."
},
"end_date": {
"type": "string",
"title": "End Date",
"default": "",
"description": "End as YYYY-MM-DD, only when the exact day is known."
},
"evidence": {
"type": "string",
"title": "Evidence",
"default": "",
"description": "The line in the record, or the source, that states it."
},
"relation": {
"enum": [
"is the spouse of",
"is the parent of",
"is the child of",
"is the sibling of",
"is the grandparent of",
"is the grandchild of",
"is the cousin of",
"is the superior of",
"is the subordinate of",
"controls",
"is controlled by",
"is the owner of",
"is owned by",
"is the predecessor of",
"is the successor of",
"is the provider of",
"is the client of",
"is the business partner of",
"is the associate of",
"is the friend of"
],
"type": "string",
"title": "Relation",
"description": "How the subject relates to the object, read \"subject relation object\"."
},
"start_date": {
"type": "string",
"title": "Start Date",
"default": "",
"description": "Start as YYYY-MM-DD, only when the exact day is known."
},
"object_existing_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Object Existing Id",
"default": null,
"description": "Id from search_authorities when the object already has an authority record."
},
"subject_existing_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Subject Existing Id",
"default": null,
"description": "Id from search_authorities when the subject already has an authority record."
}
}
}
},
"title": "propose_relationshipsArguments",
"required": [
"slug",
"relationships"
],
"properties": {
"slug": {
"type": "string",
"title": "Slug"
},
"relationships": {
"type": "array",
"items": {
"$ref": "#/$defs/Relationship"
},
"title": "Relationships"
}
}
}Propose a transcription of a record's file, such as a scanned page with no text. Look at the page with get_record_image first and transcribe what is written, line by line, in its own language and spelling; mark what you cannot read as [illegible] rather than guessing. Use get_record_text to see whether the file already has text. digital_object_id picks the file when a record has several. At most 65,000 bytes: propose a long document page by page. An archivist compares it with the page image in AI > Suggest review; once approved it is the file's text and is searchable. Needs the archivist's own staff key.
| Argument | Type | Description |
|---|---|---|
| slug* | string | |
| text* | string | |
| evidence | string | |
| digital_object_id | any |
{
"type": "object",
"title": "propose_transcriptionArguments",
"required": [
"slug",
"text"
],
"properties": {
"slug": {
"type": "string",
"title": "Slug"
},
"text": {
"type": "string",
"title": "Text"
},
"evidence": {
"type": "string",
"title": "Evidence",
"default": ""
},
"digital_object_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Digital Object Id",
"default": null
}
}
}Propose a translation of one field of a record into another language. language is the target language code, e.g. "en", "af" or "nl". Translate the record's current text for that field faithfully (read it with get_record); keep names, dates and reference codes as they are. An archivist reviews it in AI > Suggest review next to any text already held in that language; once approved the record shows it in that language. Needs the archivist's own staff key.
| Argument | Type | Description |
|---|---|---|
| slug* | string | |
| text* | string | |
| field* | string | |
| evidence | string | |
| language* | string |
{
"type": "object",
"title": "propose_translationArguments",
"required": [
"slug",
"field",
"language",
"text"
],
"properties": {
"slug": {
"type": "string",
"title": "Slug"
},
"text": {
"type": "string",
"title": "Text"
},
"field": {
"enum": [
"title",
"scope_and_content",
"archival_history",
"extent_and_medium",
"arrangement",
"access_conditions",
"reproduction_conditions"
],
"type": "string",
"title": "Field"
},
"evidence": {
"type": "string",
"title": "Evidence",
"default": ""
},
"language": {
"type": "string",
"title": "Language"
}
}
}Find existing authority records (people, organisations, families) or places by name. Every word must appear in the name, in any order, so "Hendrik Engelbrecht" also finds "Engelbrecht, Hendrik". Use it before proposing a name or place: when one of the results is the same person, organisation or place, pass its id as existing_id in propose_access_points_and_dates, so the archivist links the existing record instead of creating a new one.
| Argument | Type | Description |
|---|---|---|
| kind | string | |
| name* | string | |
| limit | integer | |
| catalogue | string |
{
"type": "object",
"title": "search_authoritiesArguments",
"required": [
"name"
],
"properties": {
"kind": {
"enum": [
"person",
"organisation",
"family",
"place"
],
"type": "string",
"title": "Kind",
"default": "person"
},
"name": {
"type": "string",
"title": "Name"
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 10
},
"catalogue": {
"type": "string",
"title": "Catalogue",
"default": ""
}
}
}Search archival descriptions (fonds, series, files, items) by keyword. Returns title, level of description and the citable URL of each match. Use get_record on a result for the full description. catalogue: leave empty for the home catalogue, give a name from list_catalogues, or "all" to search every catalogue at once (results grouped by catalogue). Every read tool takes the same catalogue; read a result with the catalogue it came from.
| Argument | Type | Description |
|---|---|---|
| skip | integer | |
| limit | integer | |
| query* | string | |
| catalogue | string |
{
"type": "object",
"title": "search_recordsArguments",
"required": [
"query"
],
"properties": {
"skip": {
"type": "integer",
"title": "Skip",
"default": 0
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 10
},
"query": {
"type": "string",
"title": "Query"
},
"catalogue": {
"type": "string",
"title": "Catalogue",
"default": ""
}
}
}Work through every record below a parent (for example each page of a family Bible), a batch at a time, with a running summary of what you proposed where. Returns a batch of the parent's children, each with your proposals on it so far by status, the totals for the whole batch, how many proposals you may still make this hour, and next_skip for the next batch (null when done). For each child: read it (get_record, and get_record_text or get_record_image when its text is thin), skip it when your proposals there are still pending, propose, then move on. Call again with skip=next_skip until it is null. When get_record shows a child has children of its own, work through it the same way.
| Argument | Type | Description |
|---|---|---|
| skip | integer | |
| slug* | string | |
| limit | integer |
{
"type": "object",
"title": "work_through_seriesArguments",
"required": [
"slug"
],
"properties": {
"skip": {
"type": "integer",
"title": "Skip",
"default": 0
},
"slug": {
"type": "string",
"title": "Slug"
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 10
}
}
}