NatalChart.AI Astrology

Official10 tools

by natalchart

Swiss Ephemeris astrology: natal charts, transits, synastry, solar returns and astrocartography.

ai.natalchart/astrology MCP Server

The MCP server “ai.natalchart/astrology” provides Swiss Ephemeris–based astrology capabilities, including natal charts, transits, synastry, solar returns, and astrocartography. It is described as supporting astrological computations across these charting and relationship-focused use cases.

🛠️ Key Features

Swiss Ephemeris astrology
Natal charts
Transits
Synastry
Solar returns
Astrocartography

🚀 Use Cases

Generate natal charts
Compute transit insights
Analyze synastry between individuals
Produce solar returns
Create astrocartography outputs

⚡ Developer Benefits

Exposes core astrology workflows: natal charts, transits, synastry, solar returns, and astrocartography
Grounded in Swiss Ephemeris as the underlying astrology system

⚠️ Limitations

Available information does not enumerate specific MCP tools, parameters, or response formats.

Captured live from the server via tools/list.

natal_chart

A natal chart from birth data. "part" picks what to return: full (everything: bodies with sign, degree, speed, retrograde flag and house; the angles; twelve Placidus cusps; aspects with orbs; element and quality balance; fixed-star contacts), short (Sun, Moon and Ascendant, each body's sign, retrograde bodies, dominant element and quality), or one part: planets, angles, houses, aspects, elements, fixed-stars. Full by default.

Parameters2

birth	object	required
part	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "birth": {
      "type": "object",
      "required": [
        "date",
        "latitude",
        "longitude"
      ],
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "description": "Birth date, YYYY-MM-DD, 1800 to 2399.",
          "examples": [
            "1991-09-06"
          ]
        },
        "time": {
          "type": [
            "string",
            "null"
          ],
          "description": "Local birth time, HH:mm, 24-hour. null when unknown: the chart is computed for noon and everything that depends on the time is withheld.",
          "examples": [
            "18:30"
          ]
        },
        "latitude": {
          "type": "number",
          "minimum": -90,
          "maximum": 90,
          "examples": [
            50.4501
          ]
        },
        "longitude": {
          "type": "number",
          "minimum": -180,
          "maximum": 180,
          "examples": [
            30.5234
          ]
        },
        "timezone": {
          "type": "string",
          "description": "IANA time zone. Leave it out to resolve it from the coordinates; historical daylight-saving rules are applied to the date.",
          "examples": [
            "Europe/Kyiv"
          ]
        }
      }
    },
    "part": {
      "type": "string",
      "enum": [
        "short",
        "full",
        "planets",
        "angles",
        "houses",
        "aspects",
        "elements",
        "fixed-stars"
      ],
      "default": "full"
    }
  },
  "required": [
    "birth"
  ]
}

daily_transits

The calculated day: the sky at noon UTC, the Moon's phase, the sky events of the coming week and, with birth data, every transit to the natal chart with its orb. No generated text.

Parameters2

birth	object	optional
date	string	optional	The day to compute, today (UTC) by default.

Raw schema

{
  "type": "object",
  "properties": {
    "birth": {
      "type": "object",
      "required": [
        "date",
        "latitude",
        "longitude"
      ],
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "description": "Birth date, YYYY-MM-DD, 1800 to 2399.",
          "examples": [
            "1991-09-06"
          ]
        },
        "time": {
          "type": [
            "string",
            "null"
          ],
          "description": "Local birth time, HH:mm, 24-hour. null when unknown: the chart is computed for noon and everything that depends on the time is withheld.",
          "examples": [
            "18:30"
          ]
        },
        "latitude": {
          "type": "number",
          "minimum": -90,
          "maximum": 90,
          "examples": [
            50.4501
          ]
        },
        "longitude": {
          "type": "number",
          "minimum": -180,
          "maximum": 180,
          "examples": [
            30.5234
          ]
        },
        "timezone": {
          "type": "string",
          "description": "IANA time zone. Leave it out to resolve it from the coordinates; historical daylight-saving rules are applied to the date.",
          "examples": [
            "Europe/Kyiv"
          ]
        }
      }
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "The day to compute, today (UTC) by default."
    }
  },
  "required": []
}

sky

Planetary positions, Moon phase and the coming week's sky events for a date (?date=YYYY-MM-DD, today by default).

Parameters1

date

string

optional

YYYY-MM-DD, today (UTC) by default.

Raw schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "YYYY-MM-DD, today (UTC) by default."
    }
  }
}

usage

Your plan, today's count and when the pool refills. Costs nothing.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

transits

Every transit event in a window of up to 92 days: exact transit-to-natal aspects by date, sign ingresses and stations. (API Pro)

Parameters3

birth	object	required
from	string	optional
to	string	optional	At most 92 days after from; 30 days by default.

Raw schema

{
  "type": "object",
  "properties": {
    "birth": {
      "type": "object",
      "required": [
        "date",
        "latitude",
        "longitude"
      ],
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "description": "Birth date, YYYY-MM-DD, 1800 to 2399.",
          "examples": [
            "1991-09-06"
          ]
        },
        "time": {
          "type": [
            "string",
            "null"
          ],
          "description": "Local birth time, HH:mm, 24-hour. null when unknown: the chart is computed for noon and everything that depends on the time is withheld.",
          "examples": [
            "18:30"
          ]
        },
        "latitude": {
          "type": "number",
          "minimum": -90,
          "maximum": 90,
          "examples": [
            50.4501
          ]
        },
        "longitude": {
          "type": "number",
          "minimum": -180,
          "maximum": 180,
          "examples": [
            30.5234
          ]
        },
        "timezone": {
          "type": "string",
          "description": "IANA time zone. Leave it out to resolve it from the coordinates; historical daylight-saving rules are applied to the date.",
          "examples": [
            "Europe/Kyiv"
          ]
        }
      }
    },
    "from": {
      "type": "string",
      "format": "date"
    },
    "to": {
      "type": "string",
      "format": "date",
      "description": "At most 92 days after from; 30 days by default."
    }
  },
  "required": [
    "birth"
  ]
}

synastry

Two charts compared: inter-chart aspects with orbs, house overlays both ways and a score per life sphere. (API Pro)

Parameters2

personA	object	required
personB	object	required

Raw schema

{
  "type": "object",
  "properties": {
    "personA": {
      "type": "object",
      "required": [
        "date",
        "latitude",
        "longitude"
      ],
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "description": "Birth date, YYYY-MM-DD, 1800 to 2399.",
          "examples": [
            "1991-09-06"
          ]
        },
        "time": {
          "type": [
            "string",
            "null"
          ],
          "description": "Local birth time, HH:mm, 24-hour. null when unknown: the chart is computed for noon and everything that depends on the time is withheld.",
          "examples": [
            "18:30"
          ]
        },
        "latitude": {
          "type": "number",
          "minimum": -90,
          "maximum": 90,
          "examples": [
            50.4501
          ]
        },
        "longitude": {
          "type": "number",
          "minimum": -180,
          "maximum": 180,
          "examples": [
            30.5234
          ]
        },
        "timezone": {
          "type": "string",
          "description": "IANA time zone. Leave it out to resolve it from the coordinates; historical daylight-saving rules are applied to the date.",
          "examples": [
            "Europe/Kyiv"
          ]
        }
      }
    },
    "personB": {
      "type": "object",
      "required": [
        "date",
        "latitude",
        "longitude"
      ],
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "description": "Birth date, YYYY-MM-DD, 1800 to 2399.",
          "examples": [
            "1991-09-06"
          ]
        },
        "time": {
          "type": [
            "string",
            "null"
          ],
          "description": "Local birth time, HH:mm, 24-hour. null when unknown: the chart is computed for noon and everything that depends on the time is withheld.",
          "examples": [
            "18:30"
          ]
        },
        "latitude": {
          "type": "number",
          "minimum": -90,
          "maximum": 90,
          "examples": [
            50.4501
          ]
        },
        "longitude": {
          "type": "number",
          "minimum": -180,
          "maximum": 180,
          "examples": [
            30.5234
          ]
        },
        "timezone": {
          "type": "string",
          "description": "IANA time zone. Leave it out to resolve it from the coordinates; historical daylight-saving rules are applied to the date.",
          "examples": [
            "Europe/Kyiv"
          ]
        }
      }
    }
  },
  "required": [
    "personA",
    "personB"
  ]
}

solar_return

The solar return chart for a year, cast for the birth place or another location. (API Pro)

Parameters3

birth	object	required
year	integer	required
location	object	optional

Raw schema

{
  "type": "object",
  "properties": {
    "birth": {
      "type": "object",
      "required": [
        "date",
        "latitude",
        "longitude"
      ],
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "description": "Birth date, YYYY-MM-DD, 1800 to 2399.",
          "examples": [
            "1991-09-06"
          ]
        },
        "time": {
          "type": [
            "string",
            "null"
          ],
          "description": "Local birth time, HH:mm, 24-hour. null when unknown: the chart is computed for noon and everything that depends on the time is withheld.",
          "examples": [
            "18:30"
          ]
        },
        "latitude": {
          "type": "number",
          "minimum": -90,
          "maximum": 90,
          "examples": [
            50.4501
          ]
        },
        "longitude": {
          "type": "number",
          "minimum": -180,
          "maximum": 180,
          "examples": [
            30.5234
          ]
        },
        "timezone": {
          "type": "string",
          "description": "IANA time zone. Leave it out to resolve it from the coordinates; historical daylight-saving rules are applied to the date.",
          "examples": [
            "Europe/Kyiv"
          ]
        }
      }
    },
    "year": {
      "type": "integer",
      "minimum": 1900,
      "maximum": 2100
    },
    "location": {
      "type": "object",
      "properties": {
        "latitude": {
          "type": "number"
        },
        "longitude": {
          "type": "number"
        }
      }
    }
  },
  "required": [
    "birth",
    "year"
  ]
}

best_days

Every day of a window of up to 62 days scored for one activity (general, business, romance, health, creative, travel, home, clarity): helping and hindering transits, Moon phase and sign, void of course. The five best days first. (API Pro)

Parameters5

birth	object	required
activity	string	optional
from	string	optional
to	string	optional	At most 62 days after from; 30 days by default.
timezone	string	optional	IANA zone that sets where each day begins. UTC by default.

Raw schema

{
  "type": "object",
  "properties": {
    "birth": {
      "type": "object",
      "required": [
        "date",
        "latitude",
        "longitude"
      ],
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "description": "Birth date, YYYY-MM-DD, 1800 to 2399.",
          "examples": [
            "1991-09-06"
          ]
        },
        "time": {
          "type": [
            "string",
            "null"
          ],
          "description": "Local birth time, HH:mm, 24-hour. null when unknown: the chart is computed for noon and everything that depends on the time is withheld.",
          "examples": [
            "18:30"
          ]
        },
        "latitude": {
          "type": "number",
          "minimum": -90,
          "maximum": 90,
          "examples": [
            50.4501
          ]
        },
        "longitude": {
          "type": "number",
          "minimum": -180,
          "maximum": 180,
          "examples": [
            30.5234
          ]
        },
        "timezone": {
          "type": "string",
          "description": "IANA time zone. Leave it out to resolve it from the coordinates; historical daylight-saving rules are applied to the date.",
          "examples": [
            "Europe/Kyiv"
          ]
        }
      }
    },
    "activity": {
      "type": "string",
      "enum": [
        "general",
        "business",
        "romance",
        "health",
        "creative",
        "travel",
        "home",
        "clarity"
      ]
    },
    "from": {
      "type": "string",
      "format": "date"
    },
    "to": {
      "type": "string",
      "format": "date",
      "description": "At most 62 days after from; 30 days by default."
    },
    "timezone": {
      "type": "string",
      "description": "IANA zone that sets where each day begins. UTC by default."
    }
  },
  "required": [
    "birth"
  ]
}

location_score

One place against one chart: the relocated angles, the planets on them with orbs, a score for each life sphere and an overall score. (API Pro)

Parameters2

birth	object	required
location	object	required

Raw schema

{
  "type": "object",
  "properties": {
    "birth": {
      "type": "object",
      "required": [
        "date",
        "latitude",
        "longitude"
      ],
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "description": "Birth date, YYYY-MM-DD, 1800 to 2399.",
          "examples": [
            "1991-09-06"
          ]
        },
        "time": {
          "type": [
            "string",
            "null"
          ],
          "description": "Local birth time, HH:mm, 24-hour. null when unknown: the chart is computed for noon and everything that depends on the time is withheld.",
          "examples": [
            "18:30"
          ]
        },
        "latitude": {
          "type": "number",
          "minimum": -90,
          "maximum": 90,
          "examples": [
            50.4501
          ]
        },
        "longitude": {
          "type": "number",
          "minimum": -180,
          "maximum": 180,
          "examples": [
            30.5234
          ]
        },
        "timezone": {
          "type": "string",
          "description": "IANA time zone. Leave it out to resolve it from the coordinates; historical daylight-saving rules are applied to the date.",
          "examples": [
            "Europe/Kyiv"
          ]
        }
      }
    },
    "location": {
      "type": "object",
      "required": [
        "latitude",
        "longitude"
      ],
      "properties": {
        "latitude": {
          "type": "number"
        },
        "longitude": {
          "type": "number"
        },
        "name": {
          "type": "string"
        }
      }
    }
  },
  "required": [
    "birth",
    "location"
  ]
}

best_cities

The catalogue of major cities ranked for one chart, overall or by chosen life spheres, worldwide or in one region. (API Pro)

Parameters4

birth	object	required
focus	array	optional
region	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "birth": {
      "type": "object",
      "required": [
        "date",
        "latitude",
        "longitude"
      ],
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "description": "Birth date, YYYY-MM-DD, 1800 to 2399.",
          "examples": [
            "1991-09-06"
          ]
        },
        "time": {
          "type": [
            "string",
            "null"
          ],
          "description": "Local birth time, HH:mm, 24-hour. null when unknown: the chart is computed for noon and everything that depends on the time is withheld.",
          "examples": [
            "18:30"
          ]
        },
        "latitude": {
          "type": "number",
          "minimum": -90,
          "maximum": 90,
          "examples": [
            50.4501
          ]
        },
        "longitude": {
          "type": "number",
          "minimum": -180,
          "maximum": 180,
          "examples": [
            30.5234
          ]
        },
        "timezone": {
          "type": "string",
          "description": "IANA time zone. Leave it out to resolve it from the coordinates; historical daylight-saving rules are applied to the date.",
          "examples": [
            "Europe/Kyiv"
          ]
        }
      }
    },
    "focus": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "identity",
          "love",
          "body",
          "money",
          "home",
          "mind"
        ]
      }
    },
    "region": {
      "type": "string",
      "enum": [
        "Europe",
        "North America",
        "Latin America",
        "Middle East & Africa",
        "Asia",
        "Oceania"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 3,
      "maximum": 12
    }
  },
  "required": [
    "birth"
  ]
}

Install

Tools (10)

natal_chartdaily_transitsskyusagetransitssynastrysolar_returnbest_days

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://www.natalchart.ai/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "astrology": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.natalchart.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

ai.natalchart/astrology MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

natal_chart

daily_transits

sky

usage

transits

synastry

solar_return

best_days

location_score

best_cities

Install

Remote endpoint

Related servers