# celestine

celestine — an MCP server for astrological calculations: natal charts, transits, progressions, planetary positions, and aspect calendars.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 2188 installs
- Author: bouch
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/bouch/celestine
- Updated: 2026-04-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/celestine

## What it does

The server performs astrological calculations through Swiss Ephemeris: builds natal charts with planets, houses, aspects, and patterns, computes current transits and searches transits in a given period, calculates secondary progressions and solar arc, returns planetary positions for any date. Reference tools for signs, houses, planets, and aspects are included.

\`birth_chart` with `detail="compact"` drops per-aspect details and per-pattern planet lists, keeping only summary counts. `current_transits` in `mode="summary"` returns the six strongest transits and aggregate counts in roughly 800 tokens; `mode="full"` gives all active transits, around 4 thousand tokens. `transit_search` finds transits in a period and groups them by body and aspect type; `mode="top"` adds the N strongest transits with enter, exact, and leave-orb dates.

\`generate_calendar_events` produces calendars of sabbats, Moon phases, retrograde stations, ingresses, or transits. The server uses Swiss Ephemeris; standalone calculations in `code_interpreter` without this library will produce incorrect dates.

## Requirements
- Remote server: `https://celestine--bouch.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http celestine https://celestine--bouch.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add celestine --url https://celestine--bouch.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "celestine": {
            "url": "https://celestine--bouch.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "celestine": {
            "type": "http",
            "url": "https://celestine--bouch.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http celestine https://celestine--bouch.run.tools
```

## When to use it
- build a natal chart with aspects and houses
- find active transits for the current date or a period
- calculate secondary progressions and solar arc
- generate a calendar of retrogrades, Moon phases, and ingresses
- get planetary positions for an arbitrary date

## Example prompts
- Build a natal chart for March 15, 1985, 2:30 PM, Moscow
- What transits are active right now for this chart?
- Find all Saturn transits to natal Sun in April 2025

## Similar
- [Open Ephemeris](https://affpapa.org/en/nevibecode/mcp/open-ephemeris.md) — MCP server · ★ 5 repo stars
- [PanchangaAPI — Vedic Astrology](https://affpapa.org/en/nevibecode/mcp/panchangaapi-vedic-astrology.md) — MCP server · 310 installs
- [Tessera Human Design](https://affpapa.org/en/nevibecode/mcp/tessera-human-design.md) — MCP server
- [Zhouyi](https://affpapa.org/en/nevibecode/mcp/zhouyi.md) — MCP server · 1315 installs
- [Ziwei & Bazi Astrology](https://affpapa.org/en/nevibecode/mcp/ziwei-bazi-astrology.md) — MCP server · 976 installs
- [Horosa Skill](https://affpapa.org/en/nevibecode/mcp/horosa-skill.md) — MCP server · ★ 525 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
