# celestine

MCP server for astrological calculations — birth charts, transits, progressions, and calendar generation

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add bouch/celestine

# Browse available tools
npx -y smithery tool list bouch/celestine

# Get full schema for a tool
npx -y smithery tool get bouch/celestine birth_chart

# Call a tool
npx -y smithery tool call bouch/celestine birth_chart '{}'
```

## Direct MCP Connection

Endpoint: `https://celestine--bouch.run.tools`

## Tools (12)

- `birth_chart` — Use when you need the full natal chart for interpretation, comparison, or downstream transit/progression work.
- `current_transits` — Use when you want to know what the sky is doing to a natal chart right now (or at a specific date).
- `transit_search` — Use when you need to know which transits shape a period for a natal chart.
- `planetary_positions` — Planetary positions for any date (defaults to now UTC).
- `progression_report` — Secondary progressions + solar arc + progressed Moon report.
- `get_sign` — Return qualities, themes, shadow, crystals, and element for a zodiac sign.
- `get_house` — Return brief and full descriptions for an astrological house (1–12).
- `get_planet` — Return archetype, rulership, exaltation/detriment/fall, and keywords for a planet.
- `get_aspect` — Return angle, orb, polarity (hard/soft), and meaning for an astrological aspect.
- `generate_calendar_events` — Authoritative astrological calendar generator — always use this tool when the user asks for a calendar of sabbats, moon…
- `list_prompts` — List all available prompts.
- `get_prompt` — Get a prompt by name with optional arguments.

```bash
# Get full input/output schema for a tool
npx -y smithery tool get bouch/celestine <tool-name>
```

## Prompts (3)

- `witch_calendar` (name, birth_date, birth_time, birth_location, start_month, end_month) — Generate a personalized astrological witch calendar with 330+ events including sabbats, moon phases, transits, retrogra…
- `lunar_journal` (name, birth_date, birth_time, birth_location, quarter, year) — Generate a personalized quarterly lunar journal with narrative guidance, journal prompts, and ritual suggestions
- `natal_reading` (name, birth_date, birth_time, birth_location) — Generate a comprehensive natal chart interpretation covering placements, aspects, patterns, and life themes