
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 toolsPublic 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 🌌
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):
Details
- Repository
- github.com/scottchronicity/ephemeris-mcp
- Package
ephemeris-mcp- Transport
- STDIO
- Registry
- MCP registry, active