# caelus-mcp [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/heavyblotto/caelus  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/caelus-mcp

## Description
Astrology/ephemeris MCP server: 9 chart tools — positions, houses, aspects, transits, electional.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "caelus-mcp": {
    "url": "https://www.ephemengine.com"
  }
}
```

## Documentation & README

# Caelus

Clean-room astrology computation monorepo. MIT, no Swiss Ephemeris code, no
AGPL, no ephemeris files. Caelus computes ephemeris positions, charts, events,
hellenistic timing techniques, Vedic methods, citable chart facts, sky-view
image-prompt frames, and the MCP tools around them. Live at
[ephemengine.com](https://www.ephemengine.com).

## Packages

| Path | npm | Description |
|------|-----|-------------|
| `packages/caelus` | [`caelus`](https://www.npmjs.com/package/caelus) | TypeScript engine (~153 KB gzipped total, zero deps) |
| `packages/caelus-mcp` | [`caelus-mcp`](https://www.npmjs.com/package/caelus-mcp) | MCP server: charts, transits, synastry, events, eclipses |
| `packages/caelus-delineations-pd` | — | Public-domain interpretation corpus + default validation set for `interpret()` |
| `packages/birth` | [`caelus-birth`](https://www.npmjs.com/package/caelus-birth) | Birth time + place → UT (timezone and DST resolution) |
| `packages/wheel` | [`caelus-wheel`](https://www.npmjs.com/package/caelus-wheel) | React SVG chart wheel, zero runtime deps |
| `apps/web` | — | Next.js site: playground, validation, edge `/api/chart` |
| [`caelus-starter`](https://github.com/heavyblotto/caelus-starter) | — | Next.js starter app (separate repo) |

The Python reference engine and data-fitting pipeline live in `python/`;
they mint the coefficient data and golden fixtures and are not a runtime
dependency.

## Docs

- [ARCHITECTURE.md](https://github.com/heavyblotto/caelus/blob/HEAD/ARCHITECTURE.md) — layout, durability decisions, product strategy
- [MCP_SPEC.md](https://github.com/heavyblotto/caelus/blob/HEAD/MCP_SPEC.md) — MCP tool contract
- [docs/gap-analysis.md](https://github.com/heavyblotto/caelus/blob/HEAD/docs/gap-analysis.md) — Swiss Ephemeris comparison (closed at 0.5.0)
- [docs/agents.md](https://github.com/heavyblotto/caelus/blob/HEAD/docs/agents.md) — pitfalls for coding agents building on Caelus
- [docs/releasing.md](https://github.com/heavyblotto/caelus/blob/HEAD/docs/releasing.md) — release process

## Quick start

```bash
npm install
npm run build
npm test
npm run dev -w web
```

http://localhost:3000 — live chart in the browser.
Edge API: `GET /api/chart?date=…&lat=…&lon=…`.

## Branches

- `main` — stable releases
- `dev` — active development