NatalChart.AI Astrology

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

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

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "NatalChart.AI Astrology": {
      "url": "https://www.natalchart.ai/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (10)

• natal_chart read-only

  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. Use it whenever the user gives a birth date, time and place and asks about their chart, signs, houses or aspects, and before interpreting anything; part=short is enough for the Sun, Moon and rising sign.

  Parameters:

  • birth (required) — object
  • part — string

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• daily_transits read-only

  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. Use it for a day's horoscope or what is happening for someone now: send birth for a personal answer, leave it out for the general sky of that day.

  Parameters:

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

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• sky read-only

  Planetary positions, Moon phase and the coming week's sky events for a date (?date=YYYY-MM-DD, today by default). Works without a key: try curl https://api.natalchart.ai/v1/sky Use it for where the planets are on a date, the Moon phase, or the coming retrogrades and ingresses, when no one's chart is involved.

  Parameters:

  • date — string — YYYY-MM-DD, today (UTC) by default.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• usage read-only

  Your plan, today's count and when the pool refills. Costs nothing. Use it when a call fails on the limit, or before a long series of calls, to see the plan and what is left today.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• transits read-only

  Up to 60 transit events in a window of up to 92 days, the most significant kept when there are more: exact transit-to-natal aspects by date, sign ingresses and stations. (API Pro) Use it for forecasts over weeks or months (a year is four windows); for a single day use daily_transits.

  Parameters:

  • birth (required) — object
  • to — string — At most 92 days after from; 30 days by default.
  • from — string

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• synastry read-only

  Two charts compared: inter-chart aspects with orbs, house overlays both ways and a score per life sphere. (API Pro) Use it when the user asks about compatibility or a relationship and gives birth data for both people.

  Parameters:

  • personA (required) — object
  • personB (required) — object

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• solar_return read-only

  The solar return chart for a year, cast for the birth place or another location. (API Pro) Use it for the year ahead from a birthday; it needs a birth time.

  Parameters:

  • birth (required) — object
  • year (required) — integer
  • location — object

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• best_days read-only

  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) Use it to pick dates for an activity within the next weeks.

  Parameters:

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

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• location_score read-only

  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) Use it when the user asks whether a specific city or place suits them; it needs a birth time and the place's coordinates.

  Parameters:

  • birth (required) — object
  • location (required) — object

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• best_cities read-only

  The catalogue of major cities ranked for one chart, overall or by chosen life spheres, worldwide or in one region. (API Pro) Use it when the user asks where in the world to live, work or travel; it ranks major cities, optionally by life sphere or region.

  Parameters:

  • birth (required) — object
  • focus — array
  • limit — integer
  • region — string

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.