---
title: "Plugin for agents — Predok"
description: "How to install predok-plugin in Claude Code, Codex, Gemini CLI, OpenCode, Cursor or another agent environment: the Predok server and the family-history research manual."
lang: en
url: https://predok.ai/en/help/agents
updated: 2026-11-21
alternates:
  uk: https://predok.ai/uk/help/agents.md
---

# Plugin for agents

[predok-plugin](https://github.com/solvek/predok) 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](https://predok.ai/en/w/) 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](https://github.com/solvek/predok).

## 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:

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

## Codex

```bash
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:

```bash
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

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

## OpenCode

```bash
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:

```json
{
  "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](https://predok.ai/en/help/connector.md).

## 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:

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

If the environment supports skills, rules or system instructions, connect [`skills/predok/SKILL.md`](https://github.com/solvek/predok/blob/main/skills/predok/SKILL.md).

## Sign-in

The server uses OAuth: sign-in with Google. Reading is counted in credits, with a free allowance ([pricing](https://predok.ai/en/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](https://predok.ai/en/help.md).
