io.github.heavyblotto/caelus-mcp
34-tool Caelus MCP for validated astrology: charts, transits, Vedic, facts, sky view, synthetic.
Open source Repository Open in the app JSON README (API)
About
34-tool Caelus MCP for validated astrology: charts, transits, Vedic, facts, sky view, synthetic.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- heavyblotto
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 0.24.1
- Forks
- 1
- Last push
- 2026-08-31T12:07:44Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:02:56
- Updated
- 2026-08-29 03:02:56
- Origin id
io.github.heavyblotto/caelus-mcp
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](./ARCHITECTURE.md) — layout, durability decisions, product strategy - [MCP_SPEC.md](./MCP_SPEC.md) — MCP tool contract - [docs/gap-analysis.md](./docs/gap-analysis.md) — Swiss Ephemeris comparison (closed at 0.5.0) - [docs/agents.md](./docs/agents.md) — pitfalls for coding agents building on Caelus - [docs/releasing.md](./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