Multi-tradition astrology. 19 modes, 18 tools. Deterministic ephemeris engine.
Copy the AI prompt to install this server into Claude Code, Cursor, or another agent โ or use 1-click editor setup below.
๐ก Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Trustworthy birth charts, transits, and synastry across Western, Vedic/Jyotish, and Chinese BaZi. The engine computes; the model interprets.
Paste this into any AI chat or agent (Claude, ChatGPT, Gemini, Claude Code, Cursor, Codex, DeepSeek, Perplexityโฆ). It installs Astro itself โ you don't set anything up first:
Local install โ works on Claude Code, Cursor, Codex, Copilot, Gemini CLI, and 50+ Agent Skills hosts:

| Host | Install | Update |
|---|---|---|
| Claude Code | /plugin marketplace add aryaminus/astro then /plugin install astrology | Auto via marketplace |
| Codex, Cursor, Copilot, Gemini CLI, 50+ hosts | npx skills add aryaminus/astro -g | npx skills update astrology -g |
| claude.ai | Download .skill โ Customize โ Skills โ + | Re-download |
| ChatGPT | Copy openapi.yaml into Custom GPT โ Actions โ Import | Manual |
| Poke (Messages/WhatsApp/Telegram) | Add as MCP integration โ URL: https://astro-api-a2rc.onrender.com/mcp/sse | โ |
| Claude Desktop / Zed | npx @smithery/cli install astrology --client claude | Re-run |
| Manual / dev | git clone https://github.com/aryaminus/astro.git && ln -sfn "$(pwd)/astro/skills/astrology" ~/.agents/skills/astrology | git pull |
A raw LLM cannot tell you where Mars was on a Tuesday in 1997 โ it hallucinates chart data. Astro splits the work:
The model never guesses a position. It interprets structured output grounded in 8 classical rulesets.
Modes: natal, transit, synastry, compatibility, composite, astrocartography, horary, event, solar/lunar/planetary return, navamsa, varga (D2โD60), panchang, moon phase, numerology, progressions, planetary hours, transit-to-natal aspects. Full list and parameters in skills/astrology/SKILL.md.
Traditions: Western tropical, Vedic/Jyotisha (Lahiri sidereal), Chinese BaZi + Tibetan/Buddhist.
Auto-included in every natal chart: Aspect patterns (Grand Trine, Kite, T-Square, Grand Cross, Yod, Mystic Rectangle, Stellium) ยท Part of Fortune ยท Vertex ยท Black Moon Lilith ยท Moon phase ยท 10 Arabic Parts ยท 23 fixed-star conjunctions ยท Navamsa D9 ยท Panchang ยท Mangal Dosha ยท Kaalsarpa Dosha.
After installing, ask any of these:
Free by default. No auth, no rate limits. Set ASTRO_API_KEY to gate, ASTRO_RATE_LIMIT to throttle.
Render (one-click, free tier): Connect this repo โ New โ Blueprint. render.yaml provisions everything. Verify with curl https://astro-api-a2rc.onrender.com/health. Free tier spins down after 15 min idle; first request after idle takes ~30s.
Docker:
Raw Python:
MCP SSE (Smithery, Cloudflare, Poke):
Cloud MCP SSE (no deploy needed): https://astro-api-a2rc.onrender.com/mcp/sse โ free Render instance. ~30s cold start.
Env vars and operational endpoints documented in AGENTS.md.
| File | What it covers |
|---|---|
AGENTS.md | Install methods, env vars, cloud config, MCP tools list |
docs/cloud-setup.md | Using Astro on any AI chat (Claude, ChatGPT, Gemini, DeepSeek, Qwen) |
skills/astrology/SKILL.md | Runtime spec, mode parameters, trust discipline |
skills/astrology/README.md | Engine internals, API surface, specialty branches |
openapi.yaml | REST API schema (ChatGPT, Agentforce, Coze) |
CHANGELOG.md | Release history |
CONTRIBUTING.md | Hard rules, dev workflow, PR checklist |
SECURITY.md | Vulnerability reporting |
PRs welcome. Hard rules: engine stays zero-dep, engine never imports frameworks, touch all 4 surfaces (engine + MCP + REST + OpenAPI), the skill is honest. See CONTRIBUTING.md.
MIT. Reference texts in skills/astrology/references/ are original MIT-licensed syntheses of classical sources.
Factual signals from GitHub, npm, and our automated checks โ not a rating.
No reviews yet โ be the first to share how this listing worked for you.
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
[](https://allmcps.com/mcp/astro)<a href="https://allmcps.com/mcp/astro"><img src="https://allmcps.com/api/badge/astro?style=directory" alt="Astro on AllMCPs" /></a>