predok.ai predok.ai

Plugin for agents

predok-plugin is an open plugin for AI agents in a terminal or editor. It has two components:

  • the predok skill: the family-history research manual; it reads the current version from the Predok knowledge base each time;
  • the predok MCP server at https://api.predok.ai/mcp: people, events, places, surnames, archival sources with call numbers and scans. The agent queries it first.

An agent that has read this page can install the plugin itself: below is the same as in the plugin README.

Claude Code

In a Claude Code session:

/plugin marketplace add solvek/predok
/plugin install predok-plugin@predok

The second command opens the plugin panel: choose who to install it for (you in all projects, everyone in the repository, or only you in this folder). From a terminal:

claude plugin marketplace add solvek/predok
claude plugin install predok-plugin@predok --scope local

Codex

codex plugin marketplace add solvek/predok

Then open the plugin catalog (Plugins) in Codex, choose the Predok marketplace and install predok-plugin. Without the plugin, by hand:

codex mcp add predok --url https://api.predok.ai/mcp
codex mcp login predok

For the skill, copy the skills/predok folder of the repository into ~/.agents/skills/ or into .agents/skills/ of the project.

Gemini CLI

gemini extensions install https://github.com/solvek/predok

OpenCode

opencode mcp add predok --global --url https://api.predok.ai/mcp

For the skill, copy the skills/predok folder into ~/.config/opencode/skills/ or into .opencode/skills/ of the project.

Cursor

Add the server to ~/.cursor/mcp.json (all projects) or to .cursor/mcp.json of the project:

{
  "mcpServers": {
    "predok": { "url": "https://api.predok.ai/mcp" }
  }
}

Add the content of skills/predok/SKILL.md as a rule in .cursor/rules/.

Claude (app and claude.ai)

This is not an agent environment but an assistant with connectors: see the connector.

Other environments

Add the MCP server https://api.predok.ai/mcp (Streamable HTTP transport) to the MCP settings file of your environment. Mostly it is JSON like this; see the environment's documentation for the file name and the exact format:

{
  "mcpServers": {
    "predok": { "type": "http", "url": "https://api.predok.ai/mcp" }
  }
}

If the environment supports skills, rules or system instructions, connect skills/predok/SKILL.md.

Sign-in

The server uses OAuth: sign-in with Google. Reading is counted in credits, with a free allowance (pricing).

  • Claude Code: /mcp → predok → Authenticate, sign in in the browser and return to the terminal.
  • Gemini CLI: /mcp auth predok.
  • Codex: codex mcp login predok.
  • OpenCode: /mcps → predok or opencode mcp auth predok.

First request

Tell the agent what you know about your ancestors and what you want, for example:

My great-grandfather Ivan Koval was born around 1890 in a village in Volyn. Where do I start?

The agent reads the sections of the manual it needs, makes a search plan and suggests sources, archives and online resources with links to predok.ai.

Back to the overview.

← All ways