OpenHeritage agent tooling

Public, cross-agent integration files for OpenHeritage, a collaborative genealogy and cultural-heritage platform.

OpenHeritage brings together Ukraine's largest public collection of memorial, grave, and archival document data.

This repository connects compatible AI agents to OpenHeritage in two complementary ways:

• a remote, anonymous, read-only MCP server for live public-record search;
• five portable Agent Skills with domain guidance, safe REST fallbacks, and canonical OpenHeritage links.

No API key is required for public search.

Ukrainian heritage data at scale

• Memorials and graves: discover memorial profiles, grave sites, cemetery records, cemetery photographs, map locations, and transcriptions.
• Archival documents: search repositories and sources, retrieve digitized documents by page or original file, and use XML, transcriptions, parsing, or OCR to answer questions with provenance.

These records are connected through canonical OpenHeritage pages, so agents can move from a discovery lead to the relevant cemetery, memorial, source, or document without treating search results as proof.

MCP endpoint

https://openheritage.online/mcp

The endpoint uses MCP Streamable HTTP and exposes:

• search_records
• search_memorials
• search_cemeteries
• search_sources
• search_documents
• search_repositories

Use the root .mcp.json with clients that support project or plugin MCP configuration.

Add OpenHeritage to your agent / Додайте OpenHeritage до свого агента

English

Use the MCP connection for live, public OpenHeritage search. Add the skills as well when you want your agent to receive focused guidance for memorials, graves, archival documents, historical photos, and genealogy research.

Codex

codex mcp add openheritage --url https://openheritage.online/mcp
npx skills add OpenHeritageOnline/agent-tooling

Gemini CLI

gemini mcp add --scope user --transport http openheritage https://openheritage.online/mcp
gemini skills install https://github.com/OpenHeritageOnline/agent-tooling

Claude Code — install the complete plugin, which includes both the MCP server and skills:

claude plugin marketplace add OpenHeritageOnline/agent-tooling
claude plugin install agent-tooling@openheritage

If you only need live search in Claude Code, use this instead:

claude mcp add --transport http --scope user openheritage https://openheritage.online/mcp

Start a new chat after installation. In an open Claude Code session, run /reload-plugins after installing the plugin. Do not install both the Claude plugin and its separate MCP entry unless you intentionally want duplicate configuration.

Українською

Підключіть MCP, щоб агент міг шукати публічні записи OpenHeritage у реальному часі. Додайте також навички, якщо хочете, щоб агент отримав спеціальні інструкції для роботи з меморіалами, могилами, архівними документами, історичними фотографіями та генеалогічними дослідженнями.

Codex

codex mcp add openheritage --url https://openheritage.online/mcp
npx skills add OpenHeritageOnline/agent-tooling

Gemini CLI

gemini mcp add --scope user --transport http openheritage https://openheritage.online/mcp
gemini skills install https://github.com/OpenHeritageOnline/agent-tooling

Claude Code — встановіть повний плагін: він містить і MCP-сервер, і навички.

claude plugin marketplace add OpenHeritageOnline/agent-tooling
claude plugin install agent-tooling@openheritage

Якщо в Claude Code потрібен лише пошук, використайте натомість:

claude mcp add --transport http --scope user openheritage https://openheritage.online/mcp

Після встановлення почніть новий чат. Якщо ви встановили плагін у вже відкритій сесії Claude Code, виконайте /reload-plugins. Не встановлюйте одночасно плагін Claude та окремий запис MCP, якщо навмисно не хочете дублювати конфігурацію.

Claude Code

Add the public OpenHeritage marketplace, then install the complete plugin:

claude plugin marketplace add OpenHeritageOnline/agent-tooling
claude plugin install agent-tooling@openheritage

Connect only the MCP server:

claude mcp add --transport http --scope user openheritage https://openheritage.online/mcp

To load the complete plugin from a checkout:

claude --plugin-dir /path/to/agent-tooling

The repository includes a Claude Code manifest at .claude-plugin/plugin.json.

Codex and other Agent Skills clients

Install the portable skills from GitHub with a compatible Agent Skills installer:

npx skills add OpenHeritageOnline/agent-tooling

The repository also includes a Codex manifest at .codex-plugin/plugin.json. Plugin-aware hosts can load the repository checkout directly and use its bundled .mcp.json.

Every Agent Skills-compatible host can also discover the five published skills from the OpenHeritage Agent Skills index. For an MCP host without plugin support, add the openheritage entry from .mcp.json to its user or project MCP configuration.

Skills

The same versioned skill documents are also published from the OpenHeritage website:

• Agent Skills discovery index
• Umbrella OpenHeritage skill

MCP Registry

server.json publishes the remote server as io.github.OpenHeritageOnline/public-search in the official MCP Registry. The GitHub Actions workflow publishes it when an mcp-v* tag is pushed:

git tag mcp-v2.9.6
git push origin mcp-v2.9.6

The workflow uses GitHub OIDC, so it requires no stored token or domain-verification private key. Registry versions are immutable: bump server.json before creating a later tag.

Publishing is restricted to protected release refs and the mcp-registry-production GitHub Environment. The publisher is downloaded from an exact release, verified by SHA256 and Sigstore identity, and checked for the expected version and source commit before the OIDC-capable job can run. See the required repository controls before creating a release tag.

Safety

• Treat search results as discovery leads, not proof of identity or family relationship.
• Respect record visibility and copyright restrictions.
• Do not crawl, bulk-enumerate, or collect profile/contact data.
• Prefer canonical OpenHeritage pages when sharing results with a user.
• Use authenticated or mutating REST workflows only when the user explicitly requests them.

Source of truth

The production skill documents are maintained in the main OpenHeritage application repository under sources/FrontendServer/AgentSkills/. Keep the copies in skills/ byte-for-byte synchronized when releasing a new version.