把知命接入你的 Agent

知命的命盘引擎通过 MCP（Model Context Protocol）开放。任何支持 MCP 的宿主都能直接排盘、查黄历、择日、核对典籍，而不必把用户引到一个网页上。

端点与鉴权

协议版本 2026-07-28，传输方式为 Streamable HTTP（POST）。服务端是**无状态**的：没有 initialize 握手，也没有会话 id。

https://fateread.cc/api/mcp

protocolVersion: 2026-07-28

匿名可用

不创建令牌也能调用一部分工具：只读、确定性、零积分、不读任何个人数据的那几个。按 IP 每天有次数上限。其余工具需要一个账号，因为它们要读你保存的命盘。

cast_chart, get_almanac, resolve_birthplace, consult_classics · 20/IP/day

工具清单

这张表由服务端的能力注册表**生成**，不是手写的 —— 它和 server-card、以及实际可调用的工具永远一致。工具描述固定为英文：它是给模型读的协议面文案。

权限（scope）

令牌默认只有只读权限。要调用会消耗积分的能力，必须在创建令牌时显式勾选；权限不足时服务端返回 insufficient_scope，并告诉你缺哪一个。

• chart:read只读（不花钱）Cast charts and look up birthplaces (no personal data is read).
• fortune:read只读（不花钱）Read the day's fortune, the almanac and auspicious-date searches.
• classics:read只读（不花钱）Query the classical sources on a topic.
• profile:read只读（不花钱）List the birth charts saved on the account (summaries only).
• chat:write可写（会消耗积分）Ask questions about a saved chart — this spends chat credits.
• report:write可写（会消耗积分）Generate the long-form books — this spends book credits.
• compatibility:write可写（会消耗积分）Compare two charts — this spends compatibility credits.

接入示例

两家宿主都原生支持静态请求头，所以直接填令牌即可。

OpenClaw

openclaw mcp add fateread \
  --url https://fateread.cc/api/mcp \
  --transport streamable-http \
  --header "Authorization: Bearer fat_xxx" \
  --include 'cast_chart,get_daily_fortune,find_auspicious_dates'

Hermes

# ~/.hermes/config.yaml
# 顶层键是 mcp_servers:，不是 mcp: servers:
mcp_servers:
  fateread:
    url: https://fateread.cc/api/mcp
    headers:
      Authorization: "Bearer fat_xxx"
    tools:
      include: [cast_chart, get_daily_fortune, find_auspicious_dates]

任意 JSON-RPC 客户端

直接用 curl 验证端点是否可达：

curl -s https://fateread.cc/api/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

机器可读入口

写 agent 的人可以从这几个文件拿到完整清单。

• llms.txt
• MCP server card
• AI catalog

坦白说：发布 llms.txt、MCP server-card 这类文件**不保证**带来引用流量。它确定带来的两件事，是降低已经在抓取本站的 agent 的解析成本，以及让「要不要引用你」这个决策更容易做对。

边界与口径