wikitree-mcp

wikitree-mcp

MCP server exposing WikiTree's genealogy API via the Code Mode architecture. Public profiles only — no authentication required.

Note: GitHub is a read-only mirror. Development happens on GitLab.

Architecture

This server uses 2 meta-tools (search + execute) with 10 operations in a server-side registry. The LLM discovers operations via search and runs them via execute.

| Tool | Description | |---|---| | search | Discover available operations and their parameters | | execute | Run a named operation against the WikiTree API |

Operations

| Operation | Category | Description | |---|---|---| | get_profile | read | Retrieve a person or free-space profile | | get_person | read | Retrieve a person profile (person profiles only) | | get_people | read | Fetch multiple profiles by keys or relationships | | search_person | search | Search profiles by name, dates, location, gender | | get_ancestors | analysis | Get ancestor tree (parents, grandparents, etc.) | | get_descendants | analysis | Get descendant tree (children, grandchildren, etc.) | | get_relatives | read | Get parents, children, siblings, spouses | | get_bio | content | Retrieve biography text | | get_photos | content | Get photos linked to a profile | | get_categories | content | Retrieve associated categories |

Configuration

| Environment Variable | Required | Default | Description | |---|---|---|---| | WIKITREE_APP_ID | No | Genealogy-MCP_wikitree-mcp | Your application identifier for the WikiTree API | | WIKITREE_API_BASE_URL | No | https://api.wikitree.com/api.php | WikiTree API endpoint | | WIKITREE_HTTP_TIMEOUT | No | 10.0 | HTTP request timeout in seconds | | WIKITREE_MAX_RETRIES | No | 3 | Max retry attempts for transient failures |

Setup: Claude Desktop

Add to your claude_desktop_config.json:

Using uv (local)

{
  "mcpServers": {
    "wikitree": {
      "command": "uv",
      "args": ["--directory", "/path/to/wikitree-mcp", "run", "wikitree-mcp"],
      "env": {
        "WIKITREE_APP_ID": "your-app-id"
      }
    }
  }
}

Using Docker

{
  "mcpServers": {
    "wikitree": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "WIKITREE_APP_ID=your-app-id", "wikitree-mcp"]
    }
  }
}

Setup: Claude Code

Using uv (local)

claude mcp add wikitree -- uv --directory /path/to/wikitree-mcp run wikitree-mcp

Set the environment variable:

export WIKITREE_APP_ID=your-app-id

Using Docker

claude mcp add wikitree -- docker run -i --rm -e WIKITREE_APP_ID=your-app-id wikitree-mcp

Development

make install       # Install dependencies
make test          # Run tests with coverage (mocked, no network)
make test-live     # Run live tests against real WikiTree API
make ci            # Full CI pipeline (lint + typecheck + test + audit)
make format        # Auto-format code
make build         # Build wheel
make run           # Run with streamable-http on port 8000
make run-stdio     # Run with stdio transport

License

AGPL-3.0-only