Astral Mcp
Add natal charts, transits, synastry, and moon-phase tools to an agent for lifestyle apps, newsletters, or creative products without signing up for an astrology API.
Overview
io.github.davidmosiah/astral-mcp is a MCP server for the Build phase that provides keyless natal, transit, synastry, and moon-phase astrology tools to agents.
What is this MCP server?
- Natal charts, transits, synastry, and moon phases from one MCP server
- No external astrology API key required
- Default stdio transport; optional HTTP via ASTRAL_MCP_TRANSPORT=http
- Bind host/port and CORS origin for local HTTP testing
- npm package astral-mcp v0.2.0
- Server version 0.2.0
- Default transport: stdio; optional HTTP
- npm identifier: astral-mcp
What problem does it solve?
Building astrology-backed agent features usually means juggling external APIs, keys, and inconsistent ephemeris sources.
Who is it for?
Solo makers shipping content, community, or lifestyle products where chart accuracy and agent-driven copy matter.
Skip if: Products that need medical, legal, or financial advice positioning, or teams that require a hosted SaaS ephemeris with SLAs only.
What do I get? / Deliverables
Your agent can request audited chart and moon data through MCP with stdio or optional local HTTP—no API key step.
- Agent-invokable natal, transit, synastry, and moon-phase results
- Local stdio or HTTP MCP endpoint for chart workflows
- No third-party astrology API credential to manage
Recommended MCP Servers
Journey fit
Specialized domain logic belongs in build-time agent tooling when you are prototyping features and copy that depend on chart calculations. It exposes precision-audited astrology operations as MCP tools rather than shipping a standalone mobile chart app.
How it compares
Domain-specific calculation MCP, not a general datetime library skill or horoscope content marketplace.
Common Questions / FAQ
Who is astral-mcp for?
Independent developers and creators building astrology-themed apps, bots, or editorial workflows who want agent-accessible chart math without API subscriptions.
When should I use astral-mcp?
Use it during build when you are prototyping natal, transit, synastry, or moon-phase features inside Claude Code, Cursor, or a custom MCP client.
How do I add astral-mcp to my agent?
Add the npm astral-mcp server as stdio in your MCP config; for HTTP, set ASTRAL_MCP_TRANSPORT=http and optional ASTRAL_MCP_HOST, ASTRAL_MCP_PORT, and ASTRAL_MCP_ALLOWED_ORIGIN.