astro — Claude Code MCP server: what it does, how to install
astro gives AI agents computed birth charts, transits, and compatibility readings. It covers Western, Vedic, and Chinese astrology.
Open on GitHubWhat astro does
astro connects an AI agent to a deterministic Python calculation engine. It can produce natal charts, transit data, synastry, compatibility results, and other astrology outputs through an MCP server with 18 tools. The model receives structured calculations and interprets them instead of estimating planetary positions.
The server covers Western tropical astrology, Vedic Jyotisha with Lahiri sidereal calculations, and Chinese BaZi. Its listed set includes 19 modes, such as returns, progressions, horary charts, and astrocartography. A request without hour and minute only reaches Sun-sign level, so a full chart requires an exact birth time along with the location details.
What it helps with
- calculate a natal chart
- compare two birth charts
- check a planetary return or transit
- find locations through astrocartography
- choose a date for an event
Example prompts for the agent
- Calculate my natal chart from my birth date, time, and city.
- Compare our charts and assess compatibility.
- Find my Saturn return period and interpret the transit.
How to install astro
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about astro
How do I install astro in Claude Code?
Run /plugin marketplace add aryaminus/astro first, then run /plugin install astrology in Claude Code.
What does the astro MCP server do?
It calculates data for natal charts, transits, synastry, compatibility, and other supported modes, then gives the structured result to an AI agent for interpretation.
Does astro need an exact birth time?
The engine accepts date, latitude, longitude, and an IANA time zone. hour and minute are optional, but leaving them out reduces the result to Sun-sign level.
