# NatalChart.AI Astrology

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

- name: ai.natalchart/astrology
- version: 1.0.0
- connection class: R1 (autonomous)
- trust: 83/100 flags: no-repository
- quality: 69/100 (needs work)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/ai.natalchart%2Fastrology
- tools: https://api.protogrid.dev/v1/servers/ai.natalchart%2Fastrology/tools

**An agent can connect on its own if it already holds `ASTROLOGY_TOKEN`.** Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "astrology": {
      "type": "http",
      "url": "https://www.natalchart.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${ASTROLOGY_TOKEN}"
      }
    }
  }
}
```

Placeholders to fill: `${ASTROLOGY_TOKEN}`.

## Trust

- hygiene: 80
- liveness: 100
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-100% +updated-18d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 69/100 (needs work)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 86 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 10 of 10 tools declare readOnlyHint or destructiveHint
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: natal_chart (destructiveHint); daily_transits (destructiveHint); sky (destructiveHint); …
- pass `tools.token_cost`: about 3,186 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 25 (weight 15)

- warn `stability.changes`: 11 tool changes in 30 days
- fail `stability.rug_pull`: 2 tools kept their name but changed most of their description in 30 days; review before trusting them

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 10, about 3,186 tokens to load them all
- tool set hash: 7114d3cb66ba9ac896ba9b36963ef1c2
- tools last changed: 2026-10-17T04:04:25.635Z
- badge: [![protogrid quality](https://protogrid.dev/badge/ai.natalchart/astrology.svg)](https://protogrid.dev/servers/ai.natalchart/astrology)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-17 `best_cities` changed (description)
  - before: The catalogue of major cities ranked for one chart, overall or by chosen life spheres, worldwide or in one region. (API Pro)
  - after: 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.
- 2026-10-17 `location_score` changed (description)
  - before: 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)
  - after: 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.
- 2026-10-17 `best_days` changed (description)
  - before: 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)
  - after: 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.
- 2026-10-17 `solar_return` changed (description)
  - before: The solar return chart for a year, cast for the birth place or another location. (API Pro)
  - after: 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.
- 2026-10-17 `synastry` changed (description)
  - before: Two charts compared: inter-chart aspects with orbs, house overlays both ways and a score per life sphere. (API Pro)
  - after: 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.
- 2026-10-17 `transits` changed (description) **meaning changed**
  - before: Every transit event in a window of up to 92 days: exact transit-to-natal aspects by date, sign ingresses and stations. (API Pro)
  - after: 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.
- 2026-10-17 `usage` changed (description) **meaning changed**
  - before: Your plan, today's count and when the pool refills. Costs nothing.
  - after: 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.
- 2026-10-17 `sky` changed (description)
  - before: Planetary positions, Moon phase and the coming week's sky events for a date (?date=YYYY-MM-DD, today by default).
  - after: Planetary positions, Moon phase and the coming week's sky events for a date (?date=YYYY-MM-DD, today by default). 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.
- 2026-10-17 `daily_transits` changed (description)
  - before: 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.
  - after: 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.
- 2026-10-17 `natal_chart` changed (description)
  - before: 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.
  - after: 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.

Full history: https://api.protogrid.dev/v1/servers/ai.natalchart%2Fastrology/changes

## Remotes

- https://www.natalchart.ai/mcp (streamable-http, auth api_key ${ASTROLOGY_TOKEN}, reachable true, uptime30d 1)

## Packages

_none_

## Tools (10)

- `best_cities`: 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.
- `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) Use it to pick dates for an activity within the next weeks.
- `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. 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.
- `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) Use it when the user asks whether a specific city or place suits them; it needs a birth time and the place's coordinates.
- `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. 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.
- `sky`: Planetary positions, Moon phase and the coming week's sky events for a date (?date=YYYY-MM-DD, today by default). 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.
- `solar_return`: 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.
- `synastry`: 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.
- `transits`: 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.
- `usage`: 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.