Plugin for agents
predok-plugin is an open plugin for AI agents in a terminal or editor. It has two components:
- the
predokskill: the family-history research manual; it reads the current version from the Predok knowledge base each time; - the
predokMCP server athttps://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→predokoropencode 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.