search_recordsLABSCO SUMMARY
A public genealogy corpus with no key, no account and citations that point back at the archive.
Because every result carries a link to the record page, an assistant can build a family tree that is checkable rather than asserted — which is the whole difficulty with genealogy answers from a model. The transcription viewer is the standout: on hosts that support MCP Apps you get the scanned page at deep zoom with its transcript alongside.
What it is
An MCP server generated from the Open Archives OpenAPI specification. It exposes the Dutch genealogy dataset — births, deaths, marriages, censuses — along with per-archive statistics, KNMI historical weather, and full-text transcriptions of scanned documents, and returns links back to the record pages on openarchieven.nl.
What you get
- search_records, show_record and match_record — search the record set, open one record, and match a person to their birth and death records
- get_births, get_deaths, get_marriages and get_births_years_ago — event-specific lookups, including births from N years ago
- get_archives, get_record_stats, get_source_type_stats, get_event_type_stats and get_comment_stats — which archives exist and how many records each holds, by source and event type
- get_family_name_stats, get_first_name_stats and get_profession_stats — name and profession frequency across the corpus
- get_breakdown — a cross-tabulation grouped by archive, source type, event type, place or year
- get_historical_weather and get_census_data — KNMI weather for a date, and Dutch census data from 1795 to 1899
- search_transcriptions, browse_transcriptions and show_transcription — full-text search over page transcriptions, hierarchical browsing by archive or inventory, and a single page by id
- view_transcription — opens transcribed pages in a deep-zoom IIIF viewer with the transcript beside them, on hosts that render MCP Apps; elsewhere it falls back to a text summary with source URLs
Requirements
Nothing — Open Archives is a public dataset and the hosted endpoint at https://mcp.openarchieven.nl/ takes no authentication. Add it as a custom connector by URL. Self-hosting needs Node.js 18+, npm and optionally Redis for caching; the upstream API allows 4 requests per second per IP, and the server queues calls through a rate limiter to stay under it.
Setup effort
Add the hosted endpoint — paste it into your client
USE CASES
Tracing an ancestor with sources you can check
Search the records for the name, open the matching entries, and follow the links back to the originating archive.
Reconstructing a family line
Pull the birth, marriage and death records for each generation and match people across them.
Finding where a surname is documented
Read the family-name frequency and cross-tabulate records by archive and source type.
Reading a handwritten page
Search the transcriptions for a term, then open the page in the deep-zoom viewer with its transcript.
Adding context to a date
Look up the weather on the day, or what the census recorded for the place.
22 tools
Listed in project docs. Your client may show a different list.
show_recordmatch_recordget_births_years_agoget_birthsget_deathsget_marriagesget_archivesget_record_statsget_source_type_statsget_event_type_statsget_comment_statsget_family_name_statsget_first_name_statsget_profession_statsget_breakdownget_historical_weatherget_census_datasearch_transcriptionsbrowse_transcriptionsshow_transcriptionview_transcriptionBEFORE YOU INSTALL
What to know first
Tools you get
22 tools named in the project's documentation. view_transcription appears only over MCP, not the REST GET /tools endpoint, and on hosts without the MCP Apps extension it returns a text summary with IIIF URLs instead of a viewer.
Requires
- Node.js 18+
- Redis (optional)
Where it runs
Of the 3 documented clients, 1 runs the server on your machine and 2 connect to a hosted endpoint.
INSTALLATION
Connect your client
Server setup
From source
git clone https://github.com/coret/openarchieven-mcp-server.git
cd openarchieven-mcp-server
npm install
npm run generate # builds generated/tools.json from openapi.yaml
npm run build:viewer # builds dist/viewer.html (the MCP App)
npm start # listens on http://localhost:3001/Hosted endpoint
https://mcp.openarchieven.nl/Add this hosted endpoint to your MCP client.
MCP Clients
Claude.ai, Claude Desktop
Settings → Connectors
Add custom connector
https://mcp.openarchieven.nl/Save and approve when prompted
Any MCP client — self-hosted
{
"mcpServers": {
"openarchieven-mcp-server": {
"url": "http://localhost:3001/"
}
}
}