Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

GOV Historical Gazetteer

by iandersoversion 0.1.0i★ 1iRuns on your computerRepository ↗
Registry nameio.github.ianderso/gov-gazetteer-mcp

How to install

What it does

German historical gazetteer GOV: a place's name, Kreis, parish and Standesamt in any year.

  • Connects Runs on your computer
  • Account or key No key needed
  • Category Other

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity4/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score16/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install GOV Historical Gazetteer. Follow https://mcp.popnx.com/i/ianderso-gov-gazetteer-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server GOV Historical Gazetteer for Claude on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "gov-gazetteer": { "command": "uvx", "args": [ "gov-gazetteer-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the GOV Historical Gazetteer tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  3. Paste these settings and save the file

    {
      "mcpServers": {
        "gov-gazetteer": {
          "command": "uvx",
          "args": [
            "gov-gazetteer-mcp"
          ]
        }
      }
    }
  4. Quit Claude and open it again

  5. Try it

    Use GOV Historical Gazetteer and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using GOV Historical Gazetteer or shows a GOV Historical Gazetteer tool in the answer, you are connected

4 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • GOV_GAZETTEER_CACHE_DIR Directory for the on-disk response cache. · default ~/.cache/gov-gazetteer-mcp
  • GOV_GAZETTEER_TIMEOUT HTTP timeout in seconds for one request. · default 30
  • GOV_GAZETTEER_MIN_INTERVAL Least seconds between two requests to GOV. Never below 1. · default 1
  • GOV_GAZETTEER_CONTACT An email address or URL appended to the User-Agent, so CompGen can reach whoever runs the server.

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect GOV Historical Gazetteer yet

GOV Historical Gazetteer runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect GOV Historical Gazetteer

  • Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • Install Python (uv) on your computer first (one time)
  • Install Python (uv) on your computer first (one time)
  • Install Python (uv) on your computer first (one time)

B · Others in Other that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server GOV Historical Gazetteer for Claude Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user gov-gazetteer -- uvx gov-gazetteer-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the GOV Historical Gazetteer tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  3. Paste this command and press Enter

    claude mcp add --scope user gov-gazetteer -- uvx gov-gazetteer-mcp
  4. Type /mcp in Claude Code

    You should see GOV Historical Gazetteer listed as connected

  5. Try it

    Use GOV Historical Gazetteer and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using GOV Historical Gazetteer or shows a GOV Historical Gazetteer tool in the answer, you are connected

4 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • GOV_GAZETTEER_CACHE_DIR Directory for the on-disk response cache. · default ~/.cache/gov-gazetteer-mcp
  • GOV_GAZETTEER_TIMEOUT HTTP timeout in seconds for one request. · default 30
  • GOV_GAZETTEER_MIN_INTERVAL Least seconds between two requests to GOV. Never below 1. · default 1
  • GOV_GAZETTEER_CONTACT An email address or URL appended to the User-Agent, so CompGen can reach whoever runs the server.

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server GOV Historical Gazetteer for Cursor on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "gov-gazetteer": { "command": "uvx", "args": [ "gov-gazetteer-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the GOV Historical Gazetteer tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  3. Open the AI chat in Cursor in Agent mode

  4. Try it

    Use GOV Historical Gazetteer and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using GOV Historical Gazetteer or shows a GOV Historical Gazetteer tool in the answer, you are connected

4 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • GOV_GAZETTEER_CACHE_DIR Directory for the on-disk response cache. · default ~/.cache/gov-gazetteer-mcp
  • GOV_GAZETTEER_TIMEOUT HTTP timeout in seconds for one request. · default 30
  • GOV_GAZETTEER_MIN_INTERVAL Least seconds between two requests to GOV. Never below 1. · default 1
  • GOV_GAZETTEER_CONTACT An email address or URL appended to the User-Agent, so CompGen can reach whoever runs the server.

Descriptions are as written by the maker.

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server GOV Historical Gazetteer for VS Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "gov-gazetteer": { "type": "stdio", "command": "uvx", "args": [ "gov-gazetteer-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the GOV Historical Gazetteer tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  3. Open the AI chat in VS Code in Agent mode

  4. Try it

    Use GOV Historical Gazetteer and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using GOV Historical Gazetteer or shows a GOV Historical Gazetteer tool in the answer, you are connected

4 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • GOV_GAZETTEER_CACHE_DIR Directory for the on-disk response cache. · default ~/.cache/gov-gazetteer-mcp
  • GOV_GAZETTEER_TIMEOUT HTTP timeout in seconds for one request. · default 30
  • GOV_GAZETTEER_MIN_INTERVAL Least seconds between two requests to GOV. Never below 1. · default 1
  • GOV_GAZETTEER_CONTACT An email address or URL appended to the User-Agent, so CompGen can reach whoever runs the server.

Descriptions are as written by the maker.

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use GOV Historical Gazetteer💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user gov-gazetteer -- uvx gov-gazetteer-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "gov-gazetteer": {
      "command": "uvx",
      "args": [
        "gov-gazetteer-mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "gov-gazetteer": {
      "command": "uvx",
      "args": [
        "gov-gazetteer-mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "gov-gazetteer": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "gov-gazetteer-mcp"
      ]
    }
  }
}

Values you fill in

  • GOV_GAZETTEER_CACHE_DIR env
    Directory for the on-disk response cache.
  • GOV_GAZETTEER_TIMEOUT env
    HTTP timeout in seconds for one request.
  • GOV_GAZETTEER_MIN_INTERVAL env
    Least seconds between two requests to GOV. Never below 1.
  • GOV_GAZETTEER_CONTACT env
    An email address or URL appended to the User-Agent, so CompGen can reach whoever runs the server.

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
22/wk
Connection
Runs on your computer
Latest versioni
0.1.0
Categoryi
Other
Published to registryi
Oct 11, 2026
Code last changedi
Nov 14, 2026
Maker
ianderso
Packages
pypi: gov-gazetteer-mcp
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account ianderso, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 5 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for gov-gazetteer-mcp@0.1.0

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/ianderso-gov-gazetteer-mcp.svg)](https://mcp.popnx.com/en/servers/ianderso-gov-gazetteer-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Otheri

  • More stars than 86% of the other 20693 servers in this category
  • Published to the registry more recently than 53% of the other 20693 servers in this category
  • Basic checks equal to or better than 99% of the other 20693 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is GOV Historical Gazetteer safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 5 days ago, and the latest version (0.1.0) reached the registry 39 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

by koala73Widely used★ 90.9KUpdated 3 days ago

Runs in the cloud✓ service owner · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

by openstatusHQWidely used★ 9.3KUpdated 2 months ago

Runs in the cloud✓ service owner · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

by JanDeDobbeleerWidely used★ 23.8K Stars for the whole repoUpdated 30 days ago

Runs in the cloud✓ service owner · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

by Klavis-AIGrowing★ 5.8KUpdated 14 months ago

Runs in the cloudRepo archived✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

by jitsucomWidely used★ 5.1KUpdated 4 months ago

Runs in the cloud✓ service owner · jitsu.com
Compared with similar ones
This one
GOV Historical Gazetteer
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks3/34/44/44/41/44/4
LicenseMITAGPL-3.0AGPL-3.0MITApache-2.0MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

gov-gazetteer-mcp

An MCP server for GOV, the Geschichtliches Orts-Verzeichnis: the historical gazetteer of the Verein für Computergenealogie (CompGen), with about 1.2 million places, mostly in Germany and the lands that were once German or Prussian. GOV dates everything it records about a place: its names, what kind of place it was, and every place that enclosed it, civil and ecclesiastical.

That makes it the tool for the question a genealogist asks of every German village: in the year of the event, which Kreis, province and state held it, and which parish and Standesamt kept its registers? A village in Posen was Prussian until 1919 and Polish after 1920; a Pomeranian one was German until 1945. A Kreis was renamed, an Amt dissolved, a parish merged. The server reads GOV's public web service and answers for one year at a time, and it gives the dated enclosures a genealogy program needs to build a place tree that is right for every date.

It works the way a careful genealogist does. A gazetteer entry is a finding aid, not evidence. GOV is edited by volunteers: a parish or Standesamt link says which register to look in, and the register's own heading confirms it. Every result credits GOV and CompGen and carries the address of each object's page on GOV, because that page is what gets cited.

Nothing here writes anywhere, and nothing here keeps a family tree. It sits well beside familysearch-mcp, whose place tools resolve a place by date but know no parishes or Standesämter, and us-places-mcp, its counterpart for American counties.

This is an independent project. It is not affiliated with, endorsed by, or supported by the Verein für Computergenealogie.

Tools

The server publishes six tools. All are read-only.

ToolPurpose
gov_searchFind places by name: GOV id, names, types, coordinates and current parents. within limits the search to what lies inside a Kreis, province or state at any date; place_type keeps villages, parishes, Standesämter and so on.
gov_objectOne object in full: every name with its language and dates, every type with dates, coordinates, external ids, and each part-of, located-in and represents relation with its dates and GOV's source ids. children lists what lies inside it, such as a parish's villages. Takes a GOV id, a GOV page address, or an external id such as geonames:2851465.
gov_place_at_dateA place in one year: its name then and the civil chain above it to the state, each level with its type and the link's dates. Links GOV leaves undated, or attests only in another year, are marked.
gov_registersThe parish (by confession, where GOV records it) and the Standesamt that covered a place in one year, the bodies above each parish whose archive may hold the books, and the local court. Says plainly when GOV records no parish or no Standesamt.
gov_enclosuresEvery dated enclosure of a place and of each civil place above it, shaped for a dated place tree: one entry per parent with its periods, current first, each with a gramps_date such as from 1871-01-01 to 1937-03-31, and a suggested Gramps place type.
cache_statusThis session's requests to GOV, by operation, and cache use. Makes no request.

Setup

You need Python 3.11 or later and uv. There is no key to request.

Without cloning. uvx fetches it from PyPI and runs it in one step:

uvx gov-gazetteer-mcp

From a clone, which is what you want if you will change it:

git clone https://github.com/ianderso/gov-gazetteer-mcp

cd gov-gazetteer-mcp uv sync uv run gov-gazetteer-mcp # stdio server, usually launched by the client

Either way the server speaks MCP over stdio, so you will normally let an MCP client start it rather than run it by hand.

Claude Desktop
{

"mcpServers": { "gov": { "command": "uvx", "args": ["gov-gazetteer-mcp"] } } }

A desktop app does not always inherit your shell's PATH. If the server fails to start because uvx cannot be found, give the full path that which uvx prints as the command.

Claude Code
claude mcp add gov -- uvx gov-gazetteer-mcp

Configuration

Nothing is required. A .env file in the directory the server starts in supplies anything the environment does not; only that directory is read.

VariableMeaning
GOV_GAZETTEER_CACHE_DIRResponse cache directory. Default ~/.cache/gov-gazetteer-mcp.
GOV_GAZETTEER_TIMEOUTHTTP timeout in seconds for one request. Default 30.
GOV_GAZETTEER_MIN_INTERVALLeast seconds between two requests to GOV. Default 1, and never below 1.
GOV_GAZETTEER_CONTACTAn email address or URL added to the User-Agent, so CompGen can reach you if your use causes trouble. Optional, and courteous.

An unusable value is reported on the first tool call as a not_configured result naming the variable. The server writes no files but its cache.

Being a good guest

GOV is run by volunteers on CompGen's own server. The client sends one request at a time, at least a second apart, and two identical calls in flight share one request. Objects are cached for 30 days and searches for 7, and every object an answer carries (a search returns whole objects, not ids) is kept for the session, so a place already seen is not asked for again. A question about one year reads each enclosing object once; the same place in another year then costs nothing. A walk reads at most 40 objects per call and says so if it stops. A 429, a 5xx or a dropped connection gets one retry, honouring Retry-After; a SOAP fault is GOV's answer and is not retried. The User-Agent names the package, its version and this repository.

Terms of use

GOV's site has no terms-of-use page; its footer links CompGen's Impressum and privacy statement. The home page says the project was started to make "qualitativ hochwertige Daten für jedermann bereitzustellen" (to provide high-quality data for everyone, gov.genealogy.net), and it publishes its SOAP services without a key at gov.genealogy.net/services. CompGen describes GOV's data as freely available Linked Open Data; GOV's documentation on GenWiki sits behind a bot check and was not read for this project. Every result credits "GOV — Geschichtliches Orts-Verzeichnis, Verein für Computergenealogie (CompGen)" and links each object's page.

As a fact: GOV's robots.txt disallows a few website paths (edit and history pages, KML and GeoJSON exports, the distance search) and names several crawlers it shuts out entirely; it does not mention /services/, the web service this server uses.

How to read what comes back

  • Ask with the event's year. gov_place_at_date and gov_registers answer for one year. A place that changed Kreis or state within that year shows both links with their dates; choose by the event's exact date.
  • A parish or Standesamt link is a lead. GOV is edited by volunteers. Confirm the parish or office in the register itself, whose heading or title page names it and the places it served, and cite the register.
  • Certainty is marked. A link is dated (its dates bracket the year), undated (GOV gives none; it is assumed to hold), or attested in another year only (GOV records it from one directory of another year). Prefer the first.
  • Where GOV links no parish to a place, gov_registers gives the parishes whose church stands in the place, and says so: usually, not always, the place's own parish. Where GOV links no Standesamt, it gives a Standesamt of the same name in the same district, as a candidate, and says GOV does not link them. In well-modelled regions (Pomerania, for one) GOV links both directly.
  • Name search is literal. It matches whole words and word beginnings, ignoring case and accents (Lubeck finds Lübeck), and never spelling variants: German, Polish and older spellings (Cöslin, Köslin, Koszalin) each need their own call. A zero covers only the spellings and area searched. GOV answers at most 500 objects per search.
  • Names follow the year. A Polish name GOV dates from 1945 is not given for 1900. Among names that hold, language (deu by default, pol for a place under Polish rule) picks the one shown; names_at_date lists them all.
  • Before 1874 there was no Standesamt in Prussia (1876 in the rest of the Empire; earlier on the left bank of the Rhine). gov_registers says so for those years.
  • Confederations are left out. GOV records memberships of the German Confederation, the Rheinbund, the League of Nations, the EU and the UN as enclosures; they are not levels of government, so a chain stops below them and a note names them.
  • Cite the object's page. Use the citation each result carries: the source credit, the entry's title, its GOV id and address, the day GOV last changed it and the day it was read.

Deliberately not here

  • Editing GOV. GOV's ChangeService needs an account; this server builds no envelope for it.
  • The GenWiki documentation. It sits behind a bot check (Anubis), which this project does not work around. Everything here was built from the WSDLs and GOV's live answers; see docs/API-NOTES.md.
  • Bulk export. This server reads places one at a time for research, not whole regions.

Security

Tool arguments are written by a model, and the model reads text this server does not control, including GOV's own names and notes. The server assumes that text can steer the model, and limits what a steered model can make it do.

  • One address. Every request is a POST over https to gov.genealogy.net/services/ComplexService; a request hook refuses anything else, and an argument chooses only what is asked, never where. Redirects are not followed.
  • Read operations only. The client builds envelopes for seven read operations and nothing else.
  • Public addresses only. The connection goes to an address checked to be public, so a DNS answer pointing at a private network is refused. Proxy settings in the environment are not used.
  • Bounded, plain answers. An answer over 10 MB is refused as it streams in, and one carrying a document type declaration is refused before it is parsed.
  • Arguments are validated (GOV ids, external ids, years, type names) before they reach a request.
  • GOV's text is untrusted. Names and notes reach the model verbatim. The server's instructions tell the model to treat that text as material to weigh, never as instructions; the model still decides, so review what it proposes to do.

To report a vulnerability, see SECURITY.md.

Development

uv sync --extra dev

uv run pytest # mocked with respx; never touches GOV uv run ruff check . uv run ruff format --check . uv run python -m tests.live_check # paced calls to GOV itself

The live check asks GOV what the recorded fixtures cannot: whether its answers still have the shape the server reads. See CONTRIBUTING.md for how the suite is organised, docs/API-NOTES.md for what was observed of the service and when, and docs/DESIGN.md for why the server is shaped this way.

Credits

The data is GOV's — Geschichtli

Only the beginning is shown; read the rest in the repo