메뉴
Install and configure the OpenEphemeris MCP server. Use when a user wants to set up OpenEphemeris, get an API key, troubleshoot installation, or connect Claude / Cursor / Windsurf / ChatGPT to the planetary calculation API.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Your personal astrologer, powered by NASA JPL DE440 ephemeris data. Natal charts, transits, synastry, eclipses, moon phases, electional timing, Human Design, and chart wheel visualization — all interpreted conversationally.
Generate and interpret astrocartography (ACG / locational astrology) — planetary lines, parans, crossings, local space, and how moving to a different location changes a chart. Use when someone asks about astrocartography, ACG, the best place to live, what city is best for their career or love life, relocation, or planetary lines.
Calculate and interpret Chinese BaZi Four Pillars / Chinese zodiac and Vedic Jyotish charts including nakshatras, dashas, yogas, and ayanamsa selection. Use when someone asks about Eastern astrology systems, their Chinese zodiac animal, BaZi, sidereal/Vedic chart, nakshatra, or dasha.
Analyze relationship compatibility between two people using synastry, composite, and Davison/midpoint charts. Use when someone asks about romantic compatibility, relationship dynamics, friendship chemistry, business partnership fit, or how two people's charts interact.
Calculate and interpret Human Design maturation transits — Saturn Return, Uranus Opposition, Chiron Return, Jupiter Return, and Uranus Return. Use when someone asks about their HD life cycles, maturation points, midlife crisis transits, or the major developmental milestones of the Human Design system.
Generate and interpret Human Design bodygraph charts including type, strategy, authority, profile, incarnation cross, defined and undefined centers, gates, and channels. Use when someone asks about their Human Design, HD type, strategy and authority, or any Human Design concept.
| name | openephemeris-setup |
| description | Install and configure the OpenEphemeris MCP server. Use when a user wants to set up OpenEphemeris, get an API key, troubleshoot installation, or connect Claude / Cursor / Windsurf / ChatGPT to the planetary calculation API. |
| version | 1.0.0 |
| updated | "2026-05-23T00:00:00.000Z" |
This skill installs the OpenEphemeris MCP server, giving any compatible LLM access to 110+ astronomical and astrological computation endpoints — natal charts, transits, returns, eclipses, synastry, Human Design, Vedic, Chinese astrology, and astrocartography.
Platform compatibility: The MCP server works with Claude (Desktop, Code, API), Cursor, Windsurf, VS Code Copilot, Cline, Continue.dev, JetBrains AI, and Amazon Q. For ChatGPT Custom GPTs and other non-MCP platforms, use the REST API directly at
api.openephemeris.comwith the OpenAPI spec.
npx -y @openephemeris/mcp-server
Or add it permanently to your MCP configuration (Claude Code shown):
claude mcp add openephemeris -- npx -y @openephemeris/mcp-server
oe_…)# macOS / Linux
export OPENEPHEMERIS_API_KEY="oe_..."
# Windows PowerShell
$env:OPENEPHEMERIS_API_KEY = "oe_..."
Ask Claude to use the ephemeris.moon_phase tool with datetime set to right now. If it returns moon phase data, setup is complete.
| Tool | Purpose |
|---|---|
ephemeris.natal_chart | Full natal chart |
ephemeris.transits | Search transit events over a date range |
ephemeris.moon_phase | Moon phase, sign, illumination |
ephemeris.next_eclipse | Next eclipse visible from a location |
ephemeris.synastry | Two-person compatibility |
ephemeris.relocation | Relocate a chart to another city |
ephemeris.electional | Find optimal timing windows |
human_design.chart | Bodygraph (type, strategy, authority, profile, gates, channels) |
For everything else (110+ endpoints), use dev.call with method + path:
| Tool | Purpose |
|---|---|
dev.call | Call any allowlisted endpoint (~28 currently on the public proxy) |
dev.list_allowed | List every endpoint reachable via dev.call |
Newer endpoints (astrocartography, predictive returns, Vedic, Chinese BaZi) may not be on the dev.call allowlist yet — call them via direct REST with header
X-Meridian-API-Key: oe_...ifdev.list_alloweddoesn't show them.
| Tier | Price | Access |
|---|---|---|
| Explorer | Free | Core ephemeris, moon, transits, geocoding |
| Developer | $29/mo | Predictive, comparative, visualization, electional, chart rendering |
| Startup | $79/mo | Batch computation |
| Scale | $199/mo | Astrocartography (ACG aspects, midpoints, crossings, declinations) |
| Enterprise | Custom | SLAs, dedicated support |
When delivering any reading, follow these defaults:
Most endpoints cost 1–5 credits per call. Heavier compounds (full natal with all options, ACG hits across many cities, transit search across a long window) can cost 10–30+. Always tell the user what you're about to run if it would exceed ~10 credits, and confirm before running batches.
| Error | Meaning | Fix |
|---|---|---|
| "OPENEPHEMERIS_API_KEY not configured" | No API key set | Set the environment variable |
401 Unauthorized | Invalid or expired key | Regenerate at Dashboard → Account |
402 Payment Required | Monthly credits exhausted | Wait for reset (1st of month) or upgrade |
403 Forbidden | Endpoint requires a higher tier | Upgrade at openephemeris.com/pay |
429 Too Many Requests | Rate limited | Back off; retry with exponential delay |