AHG Archives

za.co.theahg/ahg-archives · v0.4.0 · ai-and-media

AHG Archives is healthy: it completed an MCP handshake in 1490 ms and exposes 16 tools.

Search and read AtoM archival catalogues with citable links; staff propose changes for review.

Endpoint: https://mcp.theahg.co.za/public/mcp (streamable-http)

Repository · Website · JSON · Add to my inventory

Facts

Users (last 30 days)0
HandshakeHealthy
Auth neededNone
Tool count16
Latency1490 ms
Last checked (UTC)2026-10-26T06:00:22.880Z

Health history

Checked (UTC)StatusLatencyError
2026-10-26T06:00:22.880ZHealthy1490
2026-10-26T06:00:22.832ZHealthy1791

Tools (16)

search_recordsSearch 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
list_cataloguesThe catalogues this service can search and read. Proposals go to the home catalogue only.
get_recordRead 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
get_childrenList the descriptions directly below one record (for example the series in a fonds).
work_through_seriesWork 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 p
get_authorityRead an authority record (a person, family or organisation) by its slug.
search_authoritiesFind 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, organis
get_iiif_manifestReturn the IIIF manifest URL for a record's images, for viewing in a IIIF viewer.
get_record_textRead 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
get_record_imageLook 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 co
list_my_proposalsList 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. Chec
propose_access_points_and_datesPropose 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_existe
propose_relationshipsPropose 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 thi
propose_description_changePropose 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).
propose_transcriptionPropose 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_tex
propose_translationPropose 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 r