# Astro

> Astro is an open-source MCP server for personal profiles. Open-source astrology engine for AI agents: charts, transits and synastry via MCP. It is available on API, CLI, self-hosted and Chrome extension.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI, self-hosted, Chrome extension
- **Repository:** https://github.com/aryaminus/astro
- **MCP Registry name:** io.github.aryaminus/astro
- **Categories:** [personal profiles](https://ai-powered.com/categories/personal-profiles)
- **Listing updated:** 2026-11-18

## About

The README describes Astro as a deterministic ephemeris engine that computes birth charts, transits and synastry across Western, Vedic/Jyotish and Chinese BaZi traditions. The model is meant to interpret the computed output rather than estimate planetary positions itself.

It is exposed through several surfaces: an MCP server with 18 tools over stdio or SSE, a REST API with 31 endpoints, an OpenAPI schema for ChatGPT Actions, and an installable Agent Skills package. The engine is pure Python with no external dependencies, per the README.

The repository says it suits developers building astrology features into AI assistants and people who want chart calculations grounded in computed positions. The README also notes a free public cloud endpoint that can take around 30 seconds to wake after idle.

## Features

- **Multi-tradition chart engine:** Computes natal, transit and synastry charts in Western tropical, Vedic (Lahiri sidereal) and Chinese BaZi systems.
- **19 calculation modes:** Covers modes such as solar returns, progressions, astrocartography, horary, panchang and planetary hours.
- **MCP server with 18 tools:** Exposes the engine to MCP-compatible AI clients over stdio or SSE transport.
- **REST API and OpenAPI schema:** A 31-endpoint REST API with an OpenAPI 3.1 file for ChatGPT Actions and similar platforms.
- **Zero-dependency Python engine:** The core engine uses only the Python standard library, according to the README.
- **Agent Skills installation:** Installs as a skill for Claude Code, Cursor, Codex, Gemini CLI and other compatible hosts.

## Good for

- Generating a natal chart and transit summary inside an AI chat assistant
- Comparing two people's charts for synastry and compatibility scoring
- Finding astrocartography locations or planetary hour timings for scheduling
- Building an astrology feature into a custom app through the REST API

## FAQ

### Does the engine invent planetary positions?

The README states the engine computes positions deterministically, and that the model interprets the structured output rather than guessing positions.

### Does it require any dependencies to run?

The README says the engine is pure Python with zero dependencies and no pip install is needed.

### Why is the public cloud endpoint slow sometimes?

The README says the free Render instance spins down after 15 minutes idle, so the first request after idle takes about 30 seconds.

### Is Astro free?

Yes. Astro is open source, so you can use and self-host it for free.

### What are the best alternatives to Astro?

The closest alternatives to Astro are Asteria and Zodiacs.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.

## Alternatives

- [Asteria](https://ai-powered.com/mcp/asteria): Asteria is a free MCP server for personal profiles.
- [Zodiacs](https://ai-powered.com/mcp/zodiacs-2): Zodiacs is an MCP server for personal profiles.

---
Source: https://ai-powered.com/mcp/astro
