npm caelus-mcpstreamable-httpMITupdated 8d ago
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.
What can you do with caelus mcp?
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
| 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
Install
Add caelus mcp to your client. Pick the one you use.
{
"servers": {
"caelus-mcp": {
"type": "http",
"url": "https://www.ephemengine.com/api/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
claude mcp add caelus-mcp -- npx -y caelus-mcpcodex mcp add caelus-mcp -- npx -y caelus-mcpamp mcp add caelus-mcp -- npx -y caelus-mcp{
"mcpServers": {
"caelus-mcp": {
"command": "npx",
"args": [
"-y",
"caelus-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"caelus-mcp": {
"command": "npx",
"args": [
"-y",
"caelus-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"mcpServers": {
"caelus-mcp": {
"command": "npx",
"args": [
"-y",
"caelus-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"caelus-mcp": {
"command": "npx",
"args": [
"-y",
"caelus-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"caelus-mcp": {
"command": "npx",
"args": [
"-y",
"caelus-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"caelus-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"caelus-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"caelus-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"caelus-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y caelus-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
Score
39 / 100
Incomplete
- Documentation13/25
- Maintenance25/25
- Trust13/20
- Capability0/15
- Install experience15/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 1 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 18 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 0.24.1Latest | Aug 15, 2026 |
| 0.24.0 | Aug 15, 2026 |
| 0.23.0 | Jun 21, 2026 |
| 0.22.0 | Jun 21, 2026 |
| 0.21.0 | Jun 20, 2026 |
| 0.20.1 | Jun 17, 2026 |
| 0.20.0 | Jun 17, 2026 |
| 0.19.0 | Jun 16, 2026 |
| 0.17.0 | Jun 15, 2026 |
| 0.16.0 | Jun 15, 2026 |
| 0.15.0 | Jun 15, 2026 |
| 0.14.0 | Jun 14, 2026 |
| 0.13.0 | Jun 14, 2026 |
| 0.12.1 | Jun 14, 2026 |