Skip to content
MCP server

AHG Archives

Search and read AtoM archival catalogues, and propose edits for archivists to review

Install
Pricing
Open source
Platforms
API, Web
Runs
Remotely
Version
0.8.2
Listing updated
3 days ago

About AHG Archives

AHG Archives is an open-source MCP server for files and documents. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://mcp.theahg.co.za/public/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ahg-archives": {
      "url": "https://mcp.theahg.co.za/public/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (18)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Free open-source software; installation, hosting and training are paid services

Prices change. Check atom-extensions.com before you buy.

AHG Archives 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 to AHG Archives

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  5. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  6. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents