# Genealogy research toolkit [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/igormel81/genealogy-mcp  
**GitHub Stars:** 3  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/genealogy-research-toolkit

## Description
Family history research: 114 archives and databases, name variants, calendars, kinship, evidence

## Tools
Capabilities this server exposes over MCP:

- **plan_research** — A step-by-step plan for a country and period: which records exist, guides, sources in order
- **find_sources** — Sources by country/region (`europe`, `latin_america`, `russian_empire`…), years and record kind
- **source_details** — One source: coverage, access, how to search
- **where_are_records** — Which archives now hold the records of a historical province (Russian Empire, Poland, Galicia, Bukovina, East Prussia, the Baltics, the Caucasus)
- **search_links** — Ready search URLs for a name and its variants
- **search_online** — Live search: Internet Archive full text, Chronicling America, WikiTree, Open Archives, Open List
- **place_history** — Wikidata: what a village belonged to over the years, coordinates, Wikipedia article
- **name_variants** — Spelling, old orthography, gendered forms, transliterations, Daitch–Mokotoff codes, given-name equivalents (incl. Yiddish and Hebrew), patronymics
- **normalize_date** — "около 1899", "9 de octubre de 1899" → `ABT 1899`, `9 OCT 1899
- **convert_calendar** — Julian ↔ Gregorian, Hebrew, French Republican
- **feast_date** — «на Покров», «после Петрова поста», Easter, Wielkanoc… → the date in a given year
- **cyrillic_numerals** — ҂аѡ҃п ↔ 1880
- **birth_year_from_age** — The birth-year range from an age in a record
- **kinship** — The name of a relation in ru/en/ro, with the expected DNA share
- **dna_match** — Shared cM → the relationships it fits (Shared cM Project 4.0)
- **check_match** — Is a found record our person? A verdict with every fact compared (Hispanic double surnames too)
- **audit_tree** — Impossible facts, duplicates and gaps in a GEDCOM or `family_tree.json
- **draft_archive_request** — A request letter to a registry office or archive
- **record_guide** — How to read and find a kind of record
- **glossary** — Old Russian record terms explained

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "genealogy-research-toolkit": {
    "command": "uvx",
    "args": ["genealogy-mcp"]
  }
}
```

## Documentation

## What Genealogy research toolkit MCP server does

Genealogy research toolkit MCP server supports research across 114 archives and databases in 55 countries. It helps identify which records may exist for a place and period, where historical records are held today, and how to search them. Coverage includes regions such as Europe, Latin America, the Russian Empire, the former USSR, the British Isles, and the United States.

The toolkit also handles common interpretation problems in historical genealogy. It can generate spelling variants, transliterations, old-orthography forms, gendered names, patronymics, given-name equivalents, and Daitch–Mokotoff codes. Date tools normalize uncertain or multilingual dates, convert between calendars, interpret feast-day references, and read Church Slavonic numerals.

## How it works

The server runs locally as an MCP process and can be started with `uvx genealogy-mcp`. An MCP-capable assistant sends research questions to individual tools, which return plans, source information, calculations, links, or assessments. Online searches are performed only when requested and target the selected service.

Research can begin with a country, region, time range, record type, or known person. The assistant can then combine source discovery with name variants, historical place information, date conversion, and evidence comparison. `check_match` compares facts in a candidate record, while `audit_tree` checks a GEDCOM or `family_tree.json` for contradictions, duplicates, and missing information.

## Tools and capabilities

The Genealogy research toolkit MCP server exposes tools for:

- Planning research and finding sources by geography, period, and record kind.
- Explaining source coverage, access methods, and search approaches.
- Identifying present-day archives for records from historical provinces.
- Creating search links and searching Internet Archive full text, Chronicling America, WikiTree, Open Archives, and Open List.
- Looking up historical place affiliations, coordinates, and related Wikipedia pages through Wikidata.
- Converting names, dates, calendars, feast dates, and Cyrillic numerals.
- Calculating kinship, expected DNA shares, and relationships compatible with shared centimorgans.
- Comparing a possible record with a person and auditing family-tree data.
- Drafting archive or registry requests and explaining record terminology.

## Setup and configuration

Claude Desktop can use the downloadable `.mcpb` release package. Claude Code can register the server with `claude mcp add genealogy -- uvx genealogy-mcp`. Other listed MCP clients can use `uvx genealogy-mcp` as the server command, subject to their MCP configuration format.

The repository provides guides in English, Russian, and Ukrainian, with major guides also available in Spanish, Portuguese, Polish, and German. No environment variables are specified in the provided setup instructions.

## Limitations and notes

The toolkit does not establish identity from a matching name alone. Its matching workflow weighs additional facts and reports a verdict, but documentary evidence remains necessary. DNA calculations describe relationships that fit a shared-cM value; they do not identify the relationship by themselves.

Online search depends on the selected service and is performed only when requested. Historical borders, spelling systems, calendars, and archive transfers can make results incomplete or ambiguous. Files that are not UTF-8 are read-only according to the project documentation.

_Full upstream README: https://allmcps.com/mcp/genealogy-research-toolkit/readme_