Natal Chart Lab
Keyless MCP server for planet positions, retrogrades, Moon phases and birth placements
- Pricing
- Open source
- Platforms
- API, CLI
- Runs
- Locally
- Version
- 1.0.0
- Listing updated
- 2 days ago
About Natal Chart Lab
Natal Chart Lab is an open-source MCP server for astrology. It runs locally on your machine and is started by your AI client.
This is a thin client over the free Natal Chart Lab astrology API, so there is no key, sign-up or stored personal data. Positions are apparent geocentric longitudes on the tropical zodiac, calculated with Astronomy Engine and compared against NASA JPL Horizons. The README reports a largest difference of 19.5 arcseconds across 50 test points. The mean North Node and mean Black Moon Lilith are included.
Five tools cover the current sky, positions for any UTC time between 1800 and 2200, signs for a local birth date and time, and retrograde and Moon phase tables for 1950 to 2050. The current-sky call also reports Moon illumination, the next sign change, void-of-course windows for seven days, and each planet's retrograde or shadow status.
It does not compute rising signs or houses, and the README points to the site's birth chart calculator for those. The retrograde, Moon phase and eclipse tables are published under CC BY 4.0 and the server code is MIT licensed. A NATALCHARTLAB_URL variable lets you point it at another deployment of the same API.
Install
Run in a terminal
claude mcp add natalchartlab -- npx -y natalchartlab-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"natalchartlab": {
"command": "npx",
"args": [
"-y",
"natalchartlab-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"natalchartlab": {
"command": "npx",
"args": [
"-y",
"natalchartlab-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"natalchartlab": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"natalchartlab-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"natalchartlab": {
"command": "npx",
"args": [
"-y",
"natalchartlab-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"natalchartlab": {
"command": "npx",
"args": [
"-y",
"natalchartlab-mcp"
]
}
}
}Tools this server provides (5)
Taken from the project documentation; the running server may differ.
- get_current_sky
- Returns Sun, Moon and planet signs now, Moon phase and void-of-course windows, and retrograde or shadow status.
- get_planet_positions
- Returns longitude, sign, degree, speed and retrograde flag for each body at any UTC time from 1800 to 2200.
- get_birth_placements
- Returns Sun, Moon and planet signs for a local birth date, time and UTC offset.
- get_retrogrades
- Lists retrogrades of Mercury to Pluto in a date range with station times and shadow dates.
- get_moon_phases
- Lists New Moons, quarters and Full Moons in a date range with sign, degree, distance and eclipses.
What it does
- Current sky
- Returns signs, Moon phase, illumination, void-of-course windows and retrograde status now.
- Positions for any time
- Gives sign, degree, speed and retrograde flag for bodies from 1800 to 2200.
- Birth placements
- Finds Sun, Moon and planet signs from a local birth date, time and UTC offset.
- Retrograde tables
- Lists Mercury to Pluto retrogrades with station times and shadow dates, 1950 to 2050.
- Moon phase tables
- Lists New, quarter and Full Moons with sign, degree, distance and eclipses.
- No key needed
- Runs through npx with no account or API key.
Good for
- Check whether Mercury is retrograde and when the next one starts
- Look up Sun, Moon and Venus signs for a birth date
- List the Full Moons of a given year with their signs
- Check if the Moon is void of course
- Add live sky data to an astrology chatbot
Pricing
Open source
Free, no key; MIT licensed code and CC BY 4.0 data tables
Prices change. Check natalchartlab.com before you buy.
Natal Chart Lab FAQ
Does it need an API key?
No. The README says there is no key, sign-up or stored personal data.
Does it compute houses or a rising sign?
No. It returns planet signs only; the site's birth chart calculator handles houses.
How accurate are the positions?
They come from Astronomy Engine and match NASA JPL Horizons to within about 20 arcseconds.
What date ranges are covered?
Positions run 1800 to 2200; retrograde and Moon phase tables cover 1950 to 2050.
Is Natal Chart Lab free?
Yes. Natal Chart Lab is open source, so you can use and self-host it for free.
How do I add Natal Chart Lab to Claude Code?
Run this command in your terminal: claude mcp add natalchartlab -- npx -y natalchartlab-mcp
What are the best alternatives to Natal Chart Lab?
The closest alternatives to Natal Chart Lab are VedicDost: Vedic Astrology, Kundli & AI Astrologer, AstroLogics, GenesisCore Astrology (Western + Vedic), Céu Natal and OIYO Korea Calculators.
Alternatives to Natal Chart Lab

Vedic astrology calculations for AI: kundli, guna milan, panchang, dosha and muhurat
- 10 tools
- Remote
- Free
- Astrology

AstroLogics
MCP serverVedic astrology calculations for AI assistants: birth chart, dasha, panchang, matching
- 23 tools
- Remote
- Freemium
- Astrology

GenesisCore Astrology (Western + Vedic)
MCP serverFree Western and Vedic chart signs, retrogrades and ingresses from a date and place
- 4 tools
- Remote
- Free
- Astrology
Céu Natal
MCP serverSwiss Ephemeris birth charts, synastry and transits inside your AI chat, in Portuguese
- 9 tools
- Remote
- Open source
- Astrology

OIYO Korea Calculators
MCP serverDeterministic Korean tax, payroll, labor and calendar calculators served over MCP
- 76 tools
- Remote
- Free
- Finance and payments

Moon Phase Software
MCP serverMoon phase, moonrise, eclipses and Moon sign for any date or city via MCP
Not checked yet- 7 tools
- Remote
- Free
- Astrology