人生导师命 師

FateGuides MCP Server

Accurate Chinese astrology calculations for AI assistants — free, hosted, no API key.
为 AI 客户端提供准确排盘计算的免费 MCP 服务。

Why

Large language models are unreliable at Chinese calendar math: GanZhi conversion, solar-term boundaries and star placement are frequently wrong when a model computes them from memory. This MCP server gives your AI assistant the same production chart engine that powers FateGuides — the model gets verified facts and focuses on what it does best: interpretation.

Endpoint

https://fateguides.com/api/mcp

Transport: Streamable HTTP · Auth: none · Cost: free

Tools

bazi_chart (八字排盘)
Four Pillars chart: pillars with hidden stems & ten gods, day master, five elements, luck cycles (大运), symbolic stars, lunar date.
ziwei_chart (紫微斗数排盘)
Zi Wei Dou Shu natal chart: twelve palaces, major/minor stars with brightness, four transformations (四化), life & body palace.
liuyao_cast (六爻起卦)
I-Ching hexagram casting with najia attribution: six relatives, six spirits, shi/ying, moving lines and transformed hexagram.

Setup

Claude Code

claude mcp add --transport http fateguides https://fateguides.com/api/mcp

Claude.ai / Claude Desktop

Settings → Connectors → Add custom connector → paste the endpoint URL above.

OpenAI Codex CLI

# ~/.codex/config.toml
[mcp_servers.fateguides]
command = "npx"
args = ["-y", "mcp-remote", "https://fateguides.com/api/mcp"]

Newer Codex versions with native remote-MCP support can use url = "https://fateguides.com/api/mcp" directly.

ChatGPT (Plus/Pro)

Settings → Connectors → Advanced → Developer mode → Add connector with the endpoint URL above (no authentication).

Gemini CLI

// ~/.gemini/settings.json
{
  "mcpServers": {
    "fateguides": { "httpUrl": "https://fateguides.com/api/mcp" }
  }
}

Cursor / Windsurf / other MCP clients

{
  "mcpServers": {
    "fateguides": {
      "url": "https://fateguides.com/api/mcp"
    }
  }
}

For stdio-only clients, bridge with: npx -y mcp-remote https://fateguides.com/api/mcp

Privacy

Chart computation is stateless and in-memory: birth data sent to the MCP endpoint is used only to compute the requested chart and is not stored, logged for profiling, or shared. No account or API key is required. See our privacy policy for the full site-wide policy. 排盘输入仅用于当次计算,不存储、不用于画像。

Try it

After connecting, ask your assistant: “Use the bazi_chart tool to compute the chart for someone born June 15 1990 at 10am, male, and interpret it.” For a full 12-chapter AI reading with luck-cycle timelines, visit the report links included in every tool result, or start directly at fateguides.com/bazisuanming.