Epsteinexposed

CI Codacy Badge codecov Python MCP License: MIT

Model Context Protocol server exposing the Epstein Exposed public API as AI-agent tool calls.

Plug directly into any MCP-compatible client (Claude Desktop, Cursor, SmolAgents, etc.) to search persons, documents, flight logs, and emails from the Epstein case files.

epsteinexposed-mcp

Disclaimer: Inclusion in the Epstein Exposed database does not imply guilt or wrongdoing. All data is derived from publicly released government records.

Tools

Quick Start

# Install
pip install -e ".[dev]"

# Run via stdio (for MCP clients)
python -m src.server

# Or via the MCP CLI
mcp run src/server.py

MCP Client Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "epstein-files": {
      "command": "epsteinexposed-mcp",
      "args": []
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "epstein-files": {
      "command": "epsteinexposed-mcp",
      "args": []
    }
  }
}

Architecture

MCP Client (Claude, Cursor, SmolAgents)
    │
    │  JSON-RPC 2.0 (stdio / SSE)
    ▼
epsteinexposed-mcp (FastMCP)
    │
    │  AsyncEpsteinExposed (curl_cffi)
    ▼
epsteinexposed.com/api/v1

Powered by the epsteinexposed Python package.

Development

git clone https://github.com/releasetheepsteinfiles/epsteinexposed-mcp.git
cd epsteinexposed-mcp
pip install -e ".[dev]"
pytest -v

Documentation

Full docs available at the docs site (VitePress).

The toolchain

This repository is one of four that share a data source and a design system:

A 20-second overview of how the four fit together:

Epstein Files toolchain

Design system

All four repositories share the "Declassified" visual language — a dark archival palette with a single ember accent, monospace structure and Inter prose. The canonical tokens live in brand/tokens.css and the rationale in brand/DESIGN.md; both files are byte-identical across the four repos.

The VitePress theme maps --vp-* onto that palette in docs/.vitepress/theme/custom.css.

License

MIT