# AHG Archives

> AHG Archives is an open-source MCP server for files and documents. Search and read AtoM archival catalogues, and propose edits for archivists to review. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, Web
- **Website:** https://www.atom-extensions.com
- **Repository:** https://github.com/archiveheritagegroup/ahg-archives-mcp
- **MCP Registry name:** za.co.theahg/ahg-archives
- **Categories:** files and documents, knowledge and memory
- **Listing updated:** 2026-11-14

## About

This server works with archival catalogues running stock AtoM, AtoM with the AHG Extensions, Heratio or OpenRiC. Its read tools list catalogues, search records, open a description with its children, images, text and provenance chain, walk every record under a series, fetch authority records, IIIF manifests, OCR text and a record's reference image.

Its distinctive part is a set of propose tools: access points and dates, relationships, description changes, transcriptions, translations and, for Heratio, condition flags. Nothing changes a record until an archivist reviews and approves it, and a signed-in user can see which of their proposals were approved or rejected. Each person may make at most 200 suggestions an hour.

Anyone can connect without a key to a public endpoint that reads published records of a demonstration catalogue. A personal read-only key comes by email request, and suggestions need a staff key. The README marks the project as in development. The wider AHG offer is free, open-source AtoM plugins, with paid installation, hosting and training services.

## Features

- **Catalogue search:** Searches descriptions across one or all catalogues.
- **Full record reads:** Returns dates, creators, hierarchy, images and provenance.
- **Series walking:** Steps through every record under a parent in batches.
- **Review-gated proposals:** Archivists approve edits before records change.
- **Transcription and translation:** Proposes text for scanned pages and translated fields.
- **Public demo endpoint:** Connect without a key to a demonstration catalogue.

## Good for

- Find records in an archive with citable links
- Transcribe scanned pages for archivist review
- Propose access points for a family papers series
- Translate description fields into English
- Check what happened to earlier proposals

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http ahg-archives https://mcp.theahg.co.za/public/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.theahg.co.za/public/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ahg-archives": {
      "url": "https://mcp.theahg.co.za/public/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "ahg-archives": {
      "type": "http",
      "url": "https://mcp.theahg.co.za/public/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "ahg-archives": {
      "serverUrl": "https://mcp.theahg.co.za/public/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "ahg-archives": {
      "type": "http",
      "url": "https://mcp.theahg.co.za/public/mcp"
    }
  }
}
```

## Tools

- `list_catalogues`: Lists the catalogues the service can read.
- `search_records`: Searches descriptions by text.
- `get_record`: Returns one description in full.
- `get_children`: Lists records directly below a description.
- `work_through_series`: Walks every record below a parent in batches.
- `get_authority`: Returns an authority record.
- `search_authorities`: Finds people, organisations, families or places by name.
- `get_iiif_manifest`: Returns the IIIF manifest for a record's images.
- `get_record_text`: Returns extracted text, OCR and transcriptions.
- `get_record_image`: Returns the record's reference image.
- `list_my_proposals`: Lists your proposals and their outcomes.
- `propose_access_points_and_dates`: Proposes people, organisations, places and dates with evidence.
- `propose_relationships`: Proposes relationships between people or organisations.
- `propose_description_change`: Proposes new text for one description field.
- `propose_transcription`: Proposes a transcription of a record's file.
- `propose_translation`: Proposes a translation of a field.
- `propose_condition`: Flags damage seen on a record's image for a conservator.
- `ric_query`: Reads a record in Records in Contexts JSON-LD.

## FAQ

### Do I need a key?

Not for the public demo endpoint, which reads published records of a demonstration catalogue.

### Can the assistant edit records directly?

No. Proposals take effect only after an archivist approves them.

### Which systems does it support?

Stock AtoM, AtoM with the AHG Extensions, Heratio and OpenRiC.

### Is there a rate limit?

Yes. Every key has an hourly limit and each person can make 200 suggestions an hour.

### Is AHG Archives free?

Yes. AHG Archives is open source, so you can use and self-host it for free.

### How do I add AHG Archives to Claude Code?

Run this command in your terminal: claude mcp add --transport http ahg-archives https://mcp.theahg.co.za/public/mcp

### What are the best alternatives to AHG Archives?

The closest alternatives to AHG Archives are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/ahg-archives
