FateStar Ziwei

Zi Wei Dou Shu for AI agents: free natal charts, six transit levels, and optional readings.

CommunityOnlineAPI key requiredGlobalFreeRead-only

What it can do

    What data it sees

    Do you need an account

    An API key from the service settings is required

    Zi Wei Dou Shu for AI agents: free natal charts, six transit levels, and optional readings.

    How to connect

    How to connect FateStar Ziwei to Claude

    The server address to paste into Claude settings:

    https://www.fatestar.top/api/mcp

    1. Open Claude (claude.ai or the desktop app).
    2. Go to Settings → Connectors.
    3. Click Add custom connector.
    4. Paste the server address copied below into Remote MCP server URL and click Add.
    5. In a chat, click + → Connectors and switch the new connector on.

    Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

    Authorization

    After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

    How to connect FateStar Ziwei to ChatGPT

    The server address to paste into ChatGPT settings:

    https://www.fatestar.top/api/mcp

    1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
    2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
    3. Open Settings → Connectors and click Create.
    4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
    5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
    6. In a new chat open + → Apps/Connectors and enable the connector.

    OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

    Authorization

    On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

    How to connect FateStar Ziwei to Cursor

    The server address to paste into Cursor settings:

    https://www.fatestar.top/api/mcp

    Fastest: click Open in Cursor below and confirm the prompt.

    Manually:

    1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
    2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
    3. Save the file. The server appears in the MCP list; authorize it there if asked.

    Authorization

    If the service needs sign-in, an authorize button appears next to the server in the MCP list.

    Server tool list (3)

    Raw names from tools/list. Only developers need these.

    ziwei_chart生成紫微斗数 (Zi Wei Dou Shu / Purple Star Astrology) 完整本命盘。输入阳历或农历出生信息, 返回: 五行局/阴阳/命主身主、十二宫 (主星辅星煞星杂曜+庙旺亮度+生年四化+空宫借星+大限年龄+长生十二神)、生年四化所在宫、格局识别 (30+ 经典格局含古籍出处)、夹宫扫描、真实出生四柱 (万年历按节气)。引擎为 FateStar 自建 (102 颗星, 三合派四化, 真太阳时修正), 0 第三方排盘库。⚠️ 三合派庚干: 化科=天同 / 化忌=太阴。
    ziwei_transits在本命盘基础上计算 6 层运限: 大限 (10 年运, 含全部 13 段列表) / 小限 (1 年) / 流年 / 流月 / 流日 / 流时。每层返回该层命宫地支 + 四化 (化禄/化权/化科/化忌) + 双轨干支 (真实干支 vs 宫位编号)。不传 target* 则默认: 当前农历年月日 + 出生时辰。⚠️ 双轨干支铁律: 对外讲「X 日签约 / X 月运势」必用「真实干支」, 严禁用「宫位编号」当日子说。
    ziwei_reading调 FateStar「郑大钱」AI 命理师 —— 知识引擎 + 郑大钱人格深度解读命盘、回答命理问题 (感情/事业/财运/健康等)。解读会结合 FateStar 知识引擎与古籍检索上下文；排盘事实仍由确定性工具提供。【调用条件】仅在用户明确选择托管解读并确认可能扣积分后调用。普通命理问题默认先用免费排盘数据。⚠️ 付费: 按问题长度/模式扣积分 (短问免费), 需 FSFSKey 开发者 Key。【没 Key】引导用户去 https://www.fatestar.top 注册免费会员 → 做新手任务领积分 → 开发者中心拿 FSFSKey Key → 配进 MCP (环境变量 FATESTAR_API_KEY 或 apiKey 参数)。【积分用完 (402)】告知用户「已切回你自己的 LLM 解读, 请去 fatestar.top 充值或等北京时间 21:00 免费重置」, 然后改用 ziwei_chart 拿命盘数据 + 你自己解读。