# Natal Chart Lab

> Natal Chart Lab is an open-source MCP server for astrology. Keyless MCP server for planet positions, retrogrades, Moon phases and birth placements. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI
- **Website:** https://natalchartlab.com/astrology-api
- **Repository:** https://github.com/xucheng2024/natalchartlab-mcp
- **MCP Registry name:** io.github.xucheng2024/natalchartlab
- **Categories:** astrology
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add natalchartlab -- npx -y natalchartlab-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "natalchartlab": {
      "command": "npx",
      "args": [
        "-y",
        "natalchartlab-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "natalchartlab": {
      "command": "npx",
      "args": [
        "-y",
        "natalchartlab-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "natalchartlab": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "natalchartlab-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "natalchartlab": {
      "command": "npx",
      "args": [
        "-y",
        "natalchartlab-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "natalchartlab": {
      "command": "npx",
      "args": [
        "-y",
        "natalchartlab-mcp"
      ]
    }
  }
}
```

## Tools

- `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.

## 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

- [VedicDost: Vedic Astrology, Kundli & AI Astrologer](https://ai-powered.com/mcp/vedicdost-vedic-astrology-kundli-and-ai-astrologer): VedicDost: Vedic Astrology, Kundli & AI Astrologer is a free MCP server for astrology.
- [AstroLogics](https://ai-powered.com/mcp/astrologics): AstroLogics is a freemium MCP server for astrology.
- [GenesisCore Astrology (Western + Vedic)](https://ai-powered.com/mcp/genesiscore-astrology-western-vedic): GenesisCore Astrology (Western + Vedic) is a free MCP server for astrology.
- [Céu Natal](https://ai-powered.com/mcp/ceu-natal): Céu Natal is an open-source MCP server for astrology.
- [OIYO Korea Calculators](https://ai-powered.com/mcp/oiyo-korea-calculators): OIYO Korea Calculators is a free MCP server for finance and payments.
- [Moon Phase Software](https://ai-powered.com/mcp/moon-phase-software): Moon Phase Software is a free MCP server for astrology.
- [12 Chinese Zodiac Signs](https://ai-powered.com/mcp/12-chinese-zodiac-signs): 12 Chinese Zodiac Signs is a free MCP server for astrology.
- [Zodiac Compatibility](https://ai-powered.com/mcp/zodiac-compatibility): Zodiac Compatibility is a free MCP server for astrology.

---
Source: https://ai-powered.com/mcp/natal-chart-lab
