scottchronicity avatar

Ephemeris Mcp

scottchronicity/ephemeris-mcp

Wraps the Swiss Ephemeris library to give AI agents precision planetary positions in tropical zodiac coordinates. Exposes a single tool, get_planetary_positions, that takes an ISO timestamp and lat/long coordinates and returns geocentric positions for the Sun, Moon, planets, plus chart angles like Ascendant and Midheaven. Each body comes back with zodiac sign, degrees, retrograde status, speed, and declination. Reach for this when you're building astrological chart tools, need accurate historical or future planetary data, or want to answer astronomical position queries without maintaining ephemeris files yourself. Ships as a PyPI package that runs via uvx or as a Docker container.

GitHub stars
1
tool
1
transport
STDIO
last updated
Mar 27, 2026

Tools

1 tools

Public tool metadata for what this MCP can expose to an agent.

get_planetary_positionsReturns precise Tropical Zodiac positions for all planets, Sun, Moon, and chart angles.

Returns precise Tropical Zodiac positions for all planets, Sun, Moon, and chart angles.

No parameter schema in public metadata yet.

Sponsors

Readme

Ephemeris MCP 🌌

PyPI version CI License: AGPL v3

mcp-name: io.github.scottchronicity/ephemeris-mcp

Precision Astronomical Ephemeris for AI Agents.

Ephemeris MCP is a Model Context Protocol (MCP) server that provides AI agents with precision planetary positions using the Swiss Ephemeris.

To use this in Claude Desktop, add this to your claude_desktop_config.json:

"mcpServers": {
  "ephemeris": {
    "command": "uvx",
    "args": ["ephemeris-mcp"]
  }
}

Quick Start

Install via PyPI (Recommended)

# Install with uvx (recommended - fast & isolated, no local install needed)
uvx ephemeris-mcp

# Or install globally with pip
pip install ephemeris-mcp
python -m ephemeris_mcp

Register with MCP Clients

Add to your MCP client configuration (client will start server on-demand):


View the full README on GitHub

Details

Repository
github.com/scottchronicity/ephemeris-mcp
Package
ephemeris-mcp
Transport
STDIO
Registry
MCP registry, active