README.md
Expose the Epstein Exposed public API as AI-agent tool calls.
epsteinexposed-mcp
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.
Disclaimer: Inclusion in the Epstein Exposed database does not imply guilt or wrongdoing. All data is derived from publicly released government records.
Tools
| Tool | Description |
|---|---|
search_persons |
Search/filter persons of interest by name and category |
get_person |
Get full detail for a person by slug (bio, aliases, stats) |
search_documents |
FTS5 full-text search across case documents |
search_flights |
Search flight logs by passenger, year, origin, destination |
cross_search |
Search across documents and emails simultaneously |
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/guilyx/epsteinexposed-mcp.git
cd epsteinexposed-mcp
pip install -e ".[dev]"
pytest -v
Documentation
Full docs available at the docs site (VitePress).
License
MIT
Tools (5)
search_personsSearch/filter persons of interest by name and categoryget_personGet full detail for a person by slug (bio, aliases, stats)search_documentsFTS5 full-text search across case documentssearch_flightsSearch flight logs by passenger, year, origin, destinationcross_searchSearch across documents and emails simultaneouslyConfiguration
claude_desktop_config.json
{"mcpServers": {"epstein-files": {"command": "epsteinexposed-mcp", "args": []}}}Try it
→Search for all documents mentioning specific flight logs from 2002.
→Find details about a person of interest named Jeffrey Epstein.
→Cross-reference emails and documents for mentions of specific locations.
→List all flight logs associated with a specific passenger name.