§ MCP·Free · open · no auth

Install Apotheon as an MCP tool

Apotheon speaks the Model Context Protocol. Any MCP-compatible client — Claude Desktop, Cursor, Windsurf, Zed, Claude Code, OpenAI Agents SDK — can install it as a tool and call the same PubMed-verified calculators the website uses.

7toolsno authread-onlyrate-limited30/min/IP

§ ENDPOINT

Streamable HTTP

The single URL every MCP client connects to. Use the streamable HTTP transport (current spec) — SSE is also exposed at /api/sse for legacy clients.

https://apotheon.io/api/mcp

§ CLAUDE DESKTOP

Claude Desktop / Claude.ai

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent on Windows / Linux. Restart the app.

{
  "mcpServers": {
    "apotheon": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://apotheon.io/api/mcp"]
    }
  }
}

§ CLAUDE CODE

Claude Code CLI

One command, no config file:

claude mcp add --transport http apotheon https://apotheon.io/api/mcp

§ CURSOR / WINDSURF / ZED

Cursor, Windsurf, Zed

All three accept a URL directly. Cursor: ~/.cursor/mcp.json. Windsurf and Zed: settings → MCP servers → add. Same JSON shape:

{
  "mcpServers": {
    "apotheon": {
      "url": "https://apotheon.io/api/mcp"
    }
  }
}

§ OPENAI AGENTS

OpenAI Agents SDK

Use MCPServerStreamableHttp from the Agents SDK and point it at the endpoint above. Same URL, no auth.

§ TOOLS

What's exposed

Every tool returns JSON with the computed result and the PubMed citations the website would have shown. Same pure functions as /api/v1/calc/<slug>.

compute_creatine — Creatine Loading Protocol
compute_vitamin_d3 — Vitamin D3 Dose-to-Target
compute_peptide_reconstitution — Peptide Reconstitution
compute_magnesium — Magnesium Dosing Protocol
compute_melatonin — Melatonin Dose & Timing
lookup_compound — monograph summary by slug
search_compounds — search across name, alias, tag

§ LIMITS

Abuse policy

Per-IP rate limit of 30 requests/minute and 1,000 requests/day, applied at the proxy layer. Read-only — no writes, no auth, no personalization. If you need higher limits for a research project, let us know.