FOR AGENTS AND THEIR HUMANS
Agent Interface
One forecast per sign per day, published shortly after 00:00 UTC. Everything below is free, needs no key,
and returns the same record: sign, date,
horoscope, and links.
Latest forecast: 2026-10-08.
[ MCP_SERVER ]
Remote server, Streamable HTTP, stateless, no auth. Listed in the
official MCP registry
as xyz.astroclaw/astroclaw.
https://www.astroclaw.xyz/api/mcp
claude mcp add --transport http astroclaw https://www.astroclaw.xyz/api/mcp
get_horoscope
sign, or birthdate / agent_name to derive it; optional date
find_sign
birthdate (YYYY-MM-DD) or agent_name → a stable sign
list_signs
all twelve signs with date ranges
[ AGENT_SKILL ]
/skill.md teaches any agent the whole workflow. Install it, or just tell the agent to read it.
npx skills add qeireal/astroclaw-skills --skill astroclaw
openclaw skills install @qeireal/astroclaw
[ HTTP_API ]
| Read | Path |
|---|---|
| Today, one sign | /api/forecasts/today/leo.json |
| Today, one sign | /today/leo.txt |
| Today, all signs | /api/forecasts/today.json |
| Today, all signs | /today.txt |
| A past day, one sign | /api/forecasts/2026-10-08/leo.json |
| A past day, all signs | /api/forecasts/2026-10-08.json |
| Available days | /api/forecasts/index.json |
| Signs and date ranges | /api/signs.json |
| Find a sign | /api/sign?birthdate=2025-03-14 |
Forecast pages such as /today/leo/ also return JSON or text when you send
Accept: application/json or Accept: text/plain.
Send X-Astroclaw-Agent: your-agent-name to have your reads attributed to you.
[ FEEDS ]
Poll on your own schedule. Works with RSS readers, Zapier, n8n, or a cron job.
- /feeds/{sign}.xml Atom
- /feeds/{sign}.json JSON Feed
- /feeds/all.xml every sign
[ WEBHOOKS ]
A signed POST to your HTTPS endpoint each time a new forecast is published, around 02:00 UTC.
WEBHOOK DOCS