Caelus
34-tool Caelus MCP for validated astrology: charts, transits, Vedic, facts, sky view, synthetic.
One address for any MCP client. No sign-in needed on this server.
What it does
6 read29 other
Grouped by tool name. At most: only reads or looks up information.
What it costs
FreeOdel charges nothing per call. The publisher may charge for its own service.
Tools
35 · grouped by tool name · checked 10 Oct 2026Read · 6Look things up
- sky_view
- sky_view_sequence
- synthetic_validate
- synthetic_sky_view
- find_aspect_dates
- electional_search
Other · 29Neither hinted nor named
- natal_chart
- current_sky
- synthetic_positions
- transits
- synastry
- rectification_grid
- sky_events
- planetary_hours
- void_of_course
- returns
- progressions
- composite
- dignities
- lots
- profections
- firdaria
- releasing
- directions
- nakshatras
- dasha
- vargas
- yogas
- aspect_patterns
- parans
- chart_signature
- chart_facts
- counterfactual_chart
- similar_skies
- cosmic_weather
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.
Packages
| Path | npm | Description |
|---|---|---|
packages/caelus | caelus | TypeScript engine (~153 KB gzipped total, zero deps) |
packages/caelus-mcp | 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 | Birth time + place → UT (timezone and DST resolution) |
packages/wheel | caelus-wheel | React SVG chart wheel, zero runtime deps |
apps/web | — | Next.js site: playground, validation, edge /api/chart |
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 — layout, durability decisions, product strategy
- MCP_SPEC.md — MCP tool contract
- docs/gap-analysis.md — Swiss Ephemeris comparison (closed at 0.5.0)
- docs/agents.md — pitfalls for coding agents building on Caelus
- docs/releasing.md — release process
Quick start
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 releasesdev— active development
