A Model Context Protocol (MCP) server for the National Archives and Records Administration (NARA) Catalog API v2. Built with pure Python stdlib — no external dependencies.

• 8 MCP tools covering persons, military, immigration, presidential records, and more
• SQLite caching — repeat queries are instant and free
• Rate limiting — max 1 live API call per second, with automatic retry on gateway errors
• Cross-server hints — every military/immigration result includes clickable links to complementary TNA Discovery series and Old Bailey searches
• GEDCOM integration — tag searches with a GEDCOM person ID (@I47@) to group results by ancestor
• Zero dependencies — Python 3.10+ stdlib only

• Python 3.10+
• A NARA API key (contact Catalog_API@nara.gov)

git clone <repo-url>
cd NARA_MCP

export NARA_API_KEY=your_key_here

Or add it to your shell profile / .env loader of choice.

Add to your claude_desktop_config.json (or equivalent):

{
  "mcpServers": {
    "nara": {
      "command": "python",
      "args": ["/path/to/NARA_MCP/server.py"],
      "env": {
        "NARA_API_KEY": "your_key_here"
      }
    }
  }
}

Query the local SQLite cache. Always call this first — cache hits are instant and free.

Get NARA record group suggestions plus complementary TNA Discovery and Old Bailey links from a plain-English research context. No API call — instant.

Supported categories: Civil War, Revolutionary War, naval/piracy, WWI, immigration and naturalisation, Freedmen's Bureau, Native American, Presidential.

Primary person search. Automatically generates:

• US census search links for relevant years
• Draft eligibility assessment (WWI, WWII, Civil War pension)
• Immigration links if birthplace is non-US
• Military/naval cross-server fan-out hints
• NPRC fire warning where applicable

Broad keyword search across all 35M+ NARA catalogue records. Best for places, events, units, ships, or topics rather than specific persons.

Targeted military records search. Automatically selects the relevant Record Groups for the given war and includes cross-server hints for TNA WO/ADM series and Old Bailey soldier/sailor searches.

Record Groups searched by war:

Targeted immigration and naturalisation search across RG 36 (passenger lists 1820-1957), RG 85 (INS), and RG 21 (court naturalisation records pre-1906). Includes TNA BT 26/27 cross-reference links.

Fetch the full catalogue description for a specific record.

Search Presidential Library holdings (Hoover through Obama). Includes TNA FO 371 and PREM cross-reference links for Anglo-American diplomatic research.

All search results are stored in nara_cache.db (SQLite, created alongside server.py). The schema has three tables:

• searches — one row per tool call, keyed by a SHA-256 hash of the parameters
• records — one row per unique NARA record (keyed by NaId), upserted on each cache write
• search_records — many-to-many join between searches and records

Cache hits bypass the API entirely. There is currently no TTL/expiry — to refresh a result, delete the relevant row from searches.

A 1-second minimum interval is enforced between live API calls. Network errors and 502/503/504 responses are retried up to 3 times with exponential backoff (2 s, 4 s).

This server is designed to complement two other MCP servers:

• TNA (The National Archives) — British records. Every military and immigration result includes direct TNA Discovery series links (WO 363, WO 372, ADM 36, BT 26, BT 27, FO 371, etc.)
• Old Bailey Online — Criminal proceedings 1674-1913. Military and naval results include pre-built Old Bailey search URLs filtered by relevant terms (soldier, sailor, regiment, ship).

For military or naval queries, always fan out to all three servers in parallel.

Logs are written to nara_mcp.log alongside the server file. The handler rotates at 1 MB, keeping 3 backups. Log level: INFO.

• 1890 census: Substantially destroyed by fire in 1921 — fragments survive for some counties only.
• NPRC St Louis fire (1973): ~80% of Army records 1912-1960 and ~75% of Air Force records 1947-1964 were destroyed. Absence of a service record does not mean the person did not serve.
• 1960+ census: Under the 72-year privacy rule — most recent publicly available census is 1950.
• Old Bailey archive: Ends at 1913 in the online edition.

See repository root for licence information.