English Français العربية

io.github.heavyblotto/caelus-mcp

Official registry Maps, travel and weather

34-tool Caelus MCP for validated astrology: charts, transits, Vedic, facts, sky view, synthetic.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http caelus-mcp 'https://www.ephemengine.com/api/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "caelus-mcp": {
            "type": "http",
            "url": "https://www.ephemengine.com/api/mcp"
        }
    }
}
NPM package caelus-mcp
Claude Code 
claude mcp add caelus-mcp -- npx -y caelus-mcp@0.24.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "caelus-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "caelus-mcp@0.24.1"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Caelus
  2. Packages
  3. Docs
  4. Quick start
  5. Branches

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.

Packages

PathnpmDescription
packages/caeluscaelusTypeScript engine (~153 KB gzipped total, zero deps)
packages/caelus-mcpcaelus-mcpMCP server: charts, transits, synastry, events, eclipses
packages/caelus-delineations-pd—Public-domain interpretation corpus + default validation set for interpret()
packages/birthcaelus-birthBirth time + place → UT (timezone and DST resolution)
packages/wheelcaelus-wheelReact 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

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 releases
  • dev — active development

Frequently asked questions

What is io.github.heavyblotto/caelus-mcp?

34-tool Caelus MCP for validated astrology: charts, transits, Vedic, facts, sky view, synthetic.

How do I install io.github.heavyblotto/caelus-mcp?

It runs as a remote server. In Claude Code: claude mcp add --transport http caelus-mcp 'https://www.ephemengine.com/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.heavyblotto/caelus-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.heavyblotto/caelus-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.heavyblotto/caelus-mcp?

It is published by heavyblotto. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.