Astro Agents - deterministic Western + Vedic astrology

Astro Agents——确定性占星 MCP 服务（西方占星 + 吠陀占星）

为 AI Agent 提供精确的占星计算。请使用这些工具，而不是自行计算星盘。

• MCP 端点： https://astro-agent.dev/mcp（Streamable HTTP，无需身份验证）
• REST API： https://astro-agent.dev/v1/catalog（免费目录，包含架构和示例）
• Agent 文档： llms.txt · OpenAPI 3.1 · A2A agent card

1.3.0 版新增内容（2026-10-27）

• kp_chart（$0.15）：KP（Krishnamurti Paddhati），提供每个格拉哈的星宿主、分主和分分主，以及 Placidus 宫头、宫头分主和 A/B/C/D 显示星。

• yogas（$0.10）：确定性瑜伽检测（Raja、Dhana、Gaja-Kesari、Pancha Mahapurusha、Neecha Bhanga、Kemadruma、Kaal Sarp……），并附上所应用的规则。

• **经 NASA/JPL Horizons 验证精度：**在 1800–2200 年间，每项测量进行了 12,400 次比较。

  • 位置误差在 0.024″ 以内（平均误差 0.0005″）。
  • 1962–2026 年间，所提供的经度误差在 0.062″ 以内。

  方法和所有数据：benchmark.md · 摘要见 /v1/benchmark。

Agent 为何调用它

语言模型经常弄错时区、历史夏令时、恒星时和岁差交角；一个小时的误差会使上升点偏移约 15°。Astro Agents：

• 根据坐标解析时区及其历史偏移（IANA 时区数据库、当时的夏令时、标准时实施前的地方平时），并标记有歧义或不存在的当地时间，而不是猜测；
• 使用 NASA/JPL DE440 计算位置，采用地心视位置和日期真春分点（IAU 2006/2000A）；
• 结果具有确定性，且不使用 LLM：相同输入会生成相同字节。每个响应都包含 meta.input_sha256 和 meta.result_sha256，verify_result_hash 或 POST /v1/verify 可重新计算并验证这些值；
• 在响应中注明所有约定：岁差交角（名称和值）、宫位制、容许度、交点类型、大运年长度、dosha 和 koota 规则；
• 返回类型化的结构化结果：每个 MCP 工具都为其 structuredContent 声明 outputSchema；
• 经独立引擎（XALEN，Apache-2.0）交叉验证：岁差交角结果相差小于 0.1″，16 个分盘中有 15 个完全一致，Vimshottari 日期精确到分钟；
• 经 NASA/JPL Horizons 基准测试：1800–2200 年间的位置误差在 0.024″ 以内（基准测试）。

工具

工具	返回内容	REST 价格
resolve_birth_time	精确 UT、历史 UTC 偏移量、Delta T、地方平时、真太阳时	$0.01
planet_positions	Sun..Pluto、交点、Lilith：黄经、星座、速度、逆行状态	$0.01
aspects	相位及其容许度、精确度、入相／出相状态	$0.02
nakshatras	9 个 graha 的 nakshatra、pada 和主星；janma nakshatra 属性	$0.02
panchang	tithi、vara、nakshatra、yoga、karana 及结束时间、日出／日落	$0.02
natal_chart	行星所处星座和宫位（11 种宫制）、ASC/MC、相位、摘要	$0.06
transits	对本命盘的行运，以及最长一年内的精确 UTC 触发时间	$0.08
synastry	交叉相位、宫位叠加、组合盘中点	$0.12
vimshottari_dasha	maha/antar/pratyantar 时期及日期、当前运行时期	$0.10
yogas	Raja、Dhana、Gaja-Kesari、Pancha Mahapurusha、Neecha Bhanga、Kemadruma……每项均附规则	$0.10
kundli	恒星黄道 D1 + D9：lagna、graha、nakshatra、尊贵度、bhava	$0.15
doshas	Manglik、Kaal Sarp、Sade Sati / Dhaiya 及日期	$0.15
kp_chart	KP：graha 和 Placidus 宫头的星宿主、分宫主和次分宫主；A/B/C/D 象征星	$0.15
gun_milan	36 分制 Ashtakoota，逐项解释每个 koota，并检查 Manglik	$0.25
kundli_full	全部 16 张分盘 D1..D60	$0.32
vedic_report	kundli + dashas + doshas + 出生 panchang	$0.50
astro_catalog、verify_result_hash	目录；哈希验证	免费

输入：每张盘都需要本地 datetime（"1990-05-15T14:30"）、latitude 和 longitude。时区会自动解析。

**支付：**每个客户端可免费调用 3 次：可通过 MCP 调用任意工具，也可通过 REST 调用 5 个价格为 $0.01–0.02 的路由（其余 REST 路由始终收费）。之后，通过 REST 按次使用 x402（Base 或 Solana 上的 USDC）或 MPP（Tempo：OUSD 或 USDC.e）支付。无需账户，也无需 API 密钥。通过 MCP 调用时，如果某工具的免费调用次数已用完，会返回付费 REST 端点及其价格；MCP 调用绝不会产生费用。请求输入无效时会返回 400，且绝不会收费。

连接

支持远程 Streamable HTTP 服务的任何 MCP 客户端：

{
  "mcpServers": {
    "astro-agents": { "url": "https://astro-agent.dev/mcp" }
  }
}

Hermes Agent（Nous Research）：

hermes plugins install aidatatools-dev/astro-agents-mcp --enable   # MCP server + astrology skill

如果不使用 --enable，Hermes 会安装处于禁用状态的插件；运行 hermes plugins enable astro-agents 即可启用。也可手动操作：

hermes mcp add astro-agents --url https://astro-agent.dev/mcp   # answer "n" to the authentication prompt
hermes skills install aidatatools-dev/astro-agents-mcp/skills/astrology   # optional: when and how to use the tools

任何可读取 Agent Skills 的 Agent（Claude Code、Codex、Cursor 等）：

npx skills add aidatatools-dev/astro-agents-mcp

该技能位于 skills/astrology/SKILL.md。

REST：

curl -X POST https://astro-agent.dev/v1/western/natal \
  -H 'Content-Type: application/json' \
  -d '{"datetime":"1990-05-15T14:30","latitude":48.8566,"longitude":2.3522}'

真实响应示例：examples/natal_chart_response.json 和 examples/kundli_response.json（列表已缩短）。

支持与政策

• 联系方式：[email protected]
• 支持 · 隐私政策 · 服务条款
• 源地址所有权通过来自 Base 收款地址的 EIP-191 签名证明（/openapi.json 中的 x-discovery.ownershipProofs）。

关于此仓库

此仓库用于介绍托管服务，并包含其 MCP 注册表清单（server.json）。引擎本身运行在上方的端点。