WikiPeatia MCP Server

An MCP server that gives AI assistants access to WikiPeatia -- a community wiki and full-text corpus of Ray Peat's work on bioenergetic health -- plus Ray Peat's original articles on raypeat.com.

32 tools · no API keys · read-only · works with any MCP client (Claude Desktop, Claude Code, Cursor, Windsurf, Hermes, ...).

The server itself is a single Python file: server.py (FastMCP over stdio, ~1,000 lines). Everything else in this repo is documentation, packaging and tests.

What it gives your assistant

• Search the entire Ray Peat corpus (~7,000 documents / ~220,000 text chunks): articles, books, interviews (audio transcripts), newsletters, forum posts, email Q&A and wiki pages.

• Hybrid retrieval: full-text search, semantic (embedding) search, and LLM-powered Q&A -- a quick grounded answer mode plus a deep multi-source synthesis mode with citations.

• Read & explore the WikiPeatia wiki: pages, sections, categories, the Library namespace (Ray Peat's books / newsletters), backlinks, recent changes, random pages.

• Read Ray Peat's original articles from raypeat.com.

Related MCP server: mcp-vault-reader

Quick start

Option A -- run with uvx (no install)

uvx --from git+https://github.com/BerkayCelk/wikipeatia-mcp wikipeatia-mcp

(uv will fetch and run the server; it speaks MCP over stdio.)

Option B -- clone and run

git clone https://github.com/BerkayCelk/wikipeatia-mcp
cd wikipeatia-mcp
pip install -r requirements.txt
python server.py

Client setup

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "wikipeatia": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/BerkayCelk/wikipeatia-mcp", "wikipeatia-mcp"]
    }
  }
}

Claude Code:

claude mcp add wikipeatia -- uvx --from git+https://github.com/BerkayCelk/wikipeatia-mcp wikipeatia-mcp

Cursor (~/.cursor/mcp.json) and Windsurf: same JSON shape as Claude Desktop. Hermes: add to your config.yaml under mcp_servers (see examples/hermes_config.yaml).

Ready-made config files live in examples/.

For AI agents (automated setup)

Written so an AI coding agent (Claude Code, Codex, Cursor, Hermes, ...) can install and verify this server on its own.

1. Install command (no clone needed):

uvx --from git+https://github.com/BerkayCelk/wikipeatia-mcp wikipeatia-mcp

2. Register with a client:

• Claude Code:

  claude mcp add wikipeatia -- uvx --from git+https://github.com/BerkayCelk/wikipeatia-mcp wikipeatia-mcp

• Claude Desktop -- merge into claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows, ~/.config/Claude/ on Linux):

  {"mcpServers": {"wikipeatia": {"command": "uvx", "args": ["--from", "git+https://github.com/BerkayCelk/wikipeatia-mcp", "wikipeatia-mcp"]}}}

• Cursor -- same JSON in ~/.cursor/mcp.json (project scope: .cursor/mcp.json).

• Hermes -- see examples/hermes_config.yaml.

• Any other MCP client -- register this stdio command: uvx --from git+https://github.com/BerkayCelk/wikipeatia-mcp wikipeatia-mcp

3. Verify (no client needed):

printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"probe","version":"0"}}}' | uvx --from git+https://github.com/BerkayCelk/wikipeatia-mcp wikipeatia-mcp | head -c 400

Expect JSON containing "serverInfo":{"name":"wikipeatia".

4. Usage notes for agents:

• Research questions -> corpus_search / corpus_semantic_search (hybrid search over the full corpus).

• Quick answer -> corpus_ask; deep multi-source synthesis (30-120 s) -> corpus_deep_ask.

• Scope a search with doc_type, author, series; ray_only=false includes all authors (Georgi Dinkov, Danny Roddy, ...).

• Read-only, no API keys; avoid tight request loops (the upstream API rate-limits bursts).

5. Copy-paste prompt for users:

Set up the WikiPeatia MCP server for me: register uvx --from git+https://github.com/BerkayCelk/wikipeatia-mcp wikipeatia-mcp as a stdio MCP server named wikipeatia in my client config, restart/reload the client, then verify by calling the corpus_health tool.

Tools (32)

Wiki (17)

Corpus (12)

Ray Peat articles (3)

Example prompts

• "Search the corpus for what Ray Peat wrote about PUFA and insulin resistance." → corpus_search(query="PUFA insulin resistance", limit=10)

• "Only interviews from the Ask the Herb Doctor series." → corpus_search(query="thyroid", series="Ask the Herb Doctor", doc_type="interview")

• "What has Georgi Dinkov said about serotonin?" (non-Peat author) → corpus_search(query="serotonin", author="Georgi Dinkov (Haidut)", ray_only=false)

• "Explain the Randle cycle in Ray Peat's framework." (deep synthesis) → corpus_deep_ask(question="Explain the Randle cycle...")

• "Open the Thyroid entry in the Library namespace." → wiki_read(title="Library:Thyroid")

Environment variables

Notes

• No API keys, read-only. The server calls public endpoints of wikipeatia.org and search.wikipeatia.org; be considerate (avoid tight loops -- the upstream API rate-limits bursts).

• corpus_deep_ask can take 30-120 s. Prefer corpus_ask when you just need a fast answer.

• The corpus includes third-party authors (Georgi Dinkov, Danny Roddy, forum members, ...). Use ray_only / author / series filters to scope a search.

• This is an unofficial community project, not affiliated with WikiPeatia or raypeat.com. Content rights belong to the respective sources.

Development

uv run --with fastmcp --with httpx python smoke_test.py

The smoke test spawns the server over stdio and exercises a handful of live calls.

License

MIT -- see LICENSE.

Credits

• WikiPeatia -- wiki + corpus

• raypeat.com -- Ray Peat's original articles

• Built with FastMCP