Servers Playground How we check Add a server Log in

Zodiacs

Working Security A

io.github.zodiacs-org/zodiacsv0.6.6 GitHub verified

Explore your birth chart, compatibility, horoscopes and the sky on days that matter.

Entertainment & Games

Watch Website

Registry entry

Open in the registry

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-11-08T09:07:53.348328Z",
      "publishedAt": "2026-11-08T09:07:53.348328Z",
      "statusChangedAt": "2026-11-08T09:07:53.348328Z"
    }
  },
  "server": {
    "name": "io.github.zodiacs-org/zodiacs",
    "icons": [
      {
        "src": "https://zodiacs.org/assets/ai/brand/zodiacs-avatar-v3.png",
        "sizes": [
          "512x512"
        ],
        "mimeType": "image/png"
      }
    ],
    "title": "Zodiacs",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "remotes": [
      {
        "url": "https://zodiacs.org/mcp",
        "type": "streamable-http"
      }
    ],
    "version": "0.6.6",
    "websiteUrl": "https://zodiacs.org/developers/ai/",
    "description": "Explore your birth chart, compatibility, horoscopes and the sky on days that matter."
  }
}

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://zodiacs.org/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

check_sky_fact Read-only

Checks a claim such as 'Is Mercury retrograde today?' or 'Did the Sun enter Libra on 23 September?' and answers yes, no, or that it depends on the time zone when the answer changes during that day. Use instant or date for sign and retrograde checks, date for ingress and Moon-phase checks. Astronomy only; it cannot check predictions. API documentation: https://zodiacs.org/developers/compute/ .

kindstring, required

bodystring

datestring

signstring

zonestring

The person's time zone, such as Asia/Bangkok or America/New_York. Without it, times are in UTC.

phasestring

instantstring

A moment as an ISO 8601 time with Z or an offset, such as 2026-10-08T09:00:00+07:00 (years 1800–2199).

Zodiacs MCP server | mcptry

Zodiacs

Working Security A

io.github.zodiacs-org/zodiacsv0.6.6 GitHub verified

Explore your birth chart, compatibility, horoscopes and the sky on days that matter.

Entertainment & Games

Watch Watch Website

Registry entry

Open in the registry

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-11-08T09:07:53.348328Z",
      "publishedAt": "2026-11-08T09:07:53.348328Z",
      "statusChangedAt": "2026-11-08T09:07:53.348328Z"
    }
  },
  "server": {
    "name": "io.github.zodiacs-org/zodiacs",
    "icons": [
      {
        "src": "https://zodiacs.org/assets/ai/brand/zodiacs-avatar-v3.png",
        "sizes": [
          "512x512"
        ],
        "mimeType": "image/png"
      }
    ],
    "title": "Zodiacs",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "remotes": [
      {
        "url": "https://zodiacs.org/mcp",
        "type": "streamable-http"
      }
    ],
    "version": "0.6.6",
    "websiteUrl": "https://zodiacs.org/developers/ai/",
    "description": "Explore your birth chart, compatibility, horoscopes and the sky on days that matter."
  }
}

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://zodiacs.org/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

check_sky_fact Read-only

kindstring, required

bodystring

datestring

signstring

zonestring

The person's time zone, such as Asia/Bangkok or America/New_York. Without it, times are in UTC.

phasestring

instantstring

A moment as an ISO 8601 time with Z or an offset, such as 2026-10-08T09:00:00+07:00 (years 1800–2199).

Tools (19)

check_sky_fact

read-only

Argument	Type	Description
body	string
date	string
kind*	string
sign	string
zone	string	The person's time zone, such as Asia/Bangkok or America/New_York. Without it, times are in UTC.
phase	string
instant	string	A moment as an ISO 8601 time with Z or an offset, such as 2026-10-08T09:00:00+07:00 (years 1800–2199).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "kind"
  ],
  "properties": {
    "body": {
      "enum": [
        "Sun",
        "Moon",
        "Mercury",
        "Venus",
        "Mars",
        "Jupiter",
        "Saturn",
        "Uranus",
        "Neptune",
        "Pluto"
      ],
      "type": "string"
    },
    "date": {
      "type": "string",
      "pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$"
    },
    "kind": {
      "enum": [
        "sign",
        "retrograde",
        "ingress",
        "phase"
      ],
      "type": "string"
    },
    "sign": {
      "enum": [
        "aries",
        "taurus",
        "gemini",
        "cancer",
        "leo",
        "virgo",
        "libra",
        "scorpio",
        "sagittarius",
        "capricorn",
        "aquarius",
        "pisces"
      ],
      "type": "string"
    },
    "zone": {
      "type": "string",
      "pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
      "maxLength": 64,
      "minLength": 1,
      "description": "The person's time zone, such as Asia/Bangkok or America/New_York. Without it, times are in UTC."
    },
    "phase": {
      "enum": [
        "new",
        "first-quarter",
        "full",
        "last-quarter"
      ],
      "type": "string"
    },
    "instant": {
      "type": "string",
      "maxLength": 29,
      "minLength": 20,
      "description": "A moment as an ISO 8601 time with Z or an offset, such as 2026-10-08T09:00:00+07:00 (years 1800–2199)."
    }
  },
  "additionalProperties": false
}

explain_astrology

Explains a basic astrology topic in plain words from Zodiacs' own pages, with links to them. Use it for what-does-X-mean questions, and for whether two Sun signs are compatible, such as Leo and Scorpio, which it answers from that sign-pair page. For two Sun signs as friends, include the word friendship: that answer is the element and modality pattern alone, with no romance, and it is the reading to give anyone under 18. For the person's own placements, use get_natal_chart. It covers a sign and its traits, a planet, a planet in a sign or a house, the houses or one house, aspects or one aspect, retrogrades and Mercury retrograde, Moon phases, the void-of-course Moon, eclipses, the rising sign or one sign rising, the Midheaven, the big three, cusps, the Saturn return, the solar return, elements, modalities, transits, synastry, Sun-sign pairs or the Chinese zodiac. Give the topic in a few words. If nothing matches, or the topic is tarot, numerology, horary, Vedic astrology or another system Zodiacs does not cover, it returns found: false with the topics it does explain; do not present an explainer of your own as Zodiacs'. If either person is under 18, give the friendship reading and do not frame the pair as romance or attraction.

read-only

Argument	Type	Description
topic*	string	What to explain, in a few words: a sign (leo), a planet (Mercury), a placement (Moon in Scorpio, Jupiter in the 12th), the houses or one house (seventh house), aspects or one aspect (square), retrogrades or Mercury retrograde, Moon phases, the rising sign or a sign rising (Leo rising), the Midheaven, the big three, cusps, Saturn return, elements, modalities, transits, synastry, eclipses or the Chinese zodiac.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "topic"
  ],
  "properties": {
    "topic": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "What to explain, in a few words: a sign (leo), a planet (Mercury), a placement (Moon in Scorpio, Jupiter in the 12th), the houses or one house (seventh house), aspects or one aspect (square), retrogrades or Mercury retrograde, Moon phases, the rising sign or a sign rising (Leo rising), the Midheaven, the big three, cusps, Saturn return, elements, modalities, transits, synastry, eclipses or the Chinese zodiac."
    }
  },
  "additionalProperties": false
}

find_birthplace

Resolves a public town or city name only, so the chart tools can use its coordinates and time zone. Give the place name, and a country when several places share it. It does not take a street address. Results come from the GeoNames list of places of 15,000 people or more, bundled with Zodiacs, so the name is not sent anywhere else, and nothing is stored. Each place includes a region, a country, coordinates rounded to two decimals, an IANA time zone, and the UTC offset for an optional date (historical daylight saving included). Pass that latitude, longitude and time zone to get_natal_chart, get_personal_transits, get_compatibility or get_occasion_sky. Never guess a birth time from a place.

read-only

Argument	Type	Description
date	string	Optional date, such as 1990-05-03 (years 1800 to 2199), for the UTC offset in force that day. Without it, the offset is for today.
place*	string	A town or city name, such as London or Almaty. Not a street address. Nothing is stored.
country	string	Optional country when several places share the name, such as United Kingdom or Kazakhstan.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "place"
  ],
  "properties": {
    "date": {
      "type": "string",
      "pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
      "description": "Optional date, such as 1990-05-03 (years 1800 to 2199), for the UTC offset in force that day. Without it, the offset is for today."
    },
    "place": {
      "type": "string",
      "maxLength": 80,
      "minLength": 2,
      "description": "A town or city name, such as London or Almaty. Not a street address. Nothing is stored."
    },
    "country": {
      "type": "string",
      "maxLength": 60,
      "minLength": 2,
      "description": "Optional country when several places share the name, such as United Kingdom or Kazakhstan."
    }
  },
  "additionalProperties": false
}

find_chart_twins

Finds famous people whose birth charts share the person's Sun sign, Moon sign or both, from the people Zodiacs publishes charts for, with a link to each person's chart. A birth date is enough for the Sun; the Moon needs the birth time and time zone. Use it when someone asks which famous people share their sign or chart. If they want to share it, give them the returned shareUrl exactly; it carries their signs, never the birth date.

read-only

Argument	Type	Description
time	string	The birth time on the local clock, if known. Needs zone. Without it only the Sun is compared.
zone	string	The birthplace's time zone, such as Europe/London. Needed with a time.
latitude	number	The birthplace's latitude, if known. Give it with longitude.
birthDate*	string	The birth date, such as 1997-03-15.
longitude	number	The birthplace's longitude, if known, for birth times before standard time.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "birthDate"
  ],
  "properties": {
    "time": {
      "type": "string",
      "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
      "description": "The birth time on the local clock, if known. Needs zone. Without it only the Sun is compared."
    },
    "zone": {
      "type": "string",
      "pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
      "maxLength": 64,
      "minLength": 1,
      "description": "The birthplace's time zone, such as Europe/London. Needed with a time."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90,
      "description": "The birthplace's latitude, if known. Give it with longitude."
    },
    "birthDate": {
      "type": "string",
      "pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
      "description": "The birth date, such as 1997-03-15."
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180,
      "description": "The birthplace's longitude, if known, for birth times before standard time."
    }
  },
  "additionalProperties": false
}

get_birthday

Describes the sky on a birthday: the Sun's sign for that date, its traditional meaning, the decan, and whether the date falls on a cusp where the sign depends on the year or time. A month and day (05-03) is enough for general birthday facts. Use a full birth date only to resolve a cusp date's sign in that birth year or calculate a solar return, the moment the Sun comes back to its birth position, with a time and time zone if known. Longitude is only for historical local mean time; do not request coordinates for modern birthdays. It links to the date's birthday page and names the famous people Zodiacs publishes who were born on that day, as the page does. It makes no prediction. If they want to share it, give them the returned shareUrl exactly; it carries the month and day, never the year.

read-only

Argument	Type	Description
date	string	A birthday without a year, as MM-DD, such as 05-03 for 3 May. This is enough for general birthday facts. Give this or birthDate.
time	string	The birth time on the local clock, if known. Needs zone.
year	integer	The year of the solar return. Defaults to the current year. Needs birthDate.
zone	string	The birthplace's time zone, such as Europe/London.
birthDate	string	The full birth date, such as 1997-05-03. Use only for the solar return or to resolve the sign of a cusp date in that birth year.
longitude

get_capabilities

Lists what Zodiacs can do, its limits and how it handles privacy. Use it when the person asks what Zodiacs can do, or when you need those details before choosing another tool. Zodiacs does not schedule anything, pick stocks or investments, make health predictions or guarantee outcomes, so do not call it to check before turning those requests down. No sign-in or birth details needed.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {},
  "additionalProperties": false
}

get_chinese_zodiac

Gives the Chinese zodiac animal, element and yin or yang for a birth date or a year, and the current year's animal. A birth date before that year's Lunar New Year belongs to the previous animal year; the answer gives the Lunar New Year date it used. With only a year, it says which animal applies to anyone born before that year's Lunar New Year. It adds the animal's traditional associations and its traditional pairings (the harmonious three, the six-harmony partner and the opposite animal), with links to the animal's page. Pass the person's time zone if you know it so the current year is their own. Without a zone the current year assumes UTC and the answer says so.

read-only

Argument	Type	Description
year	integer	A year, such as 1990, when the person gives only a year. The answer says which animal applies before that year's Lunar New Year.
zone	string	The person's time zone, such as Asia/Singapore, so the current year is worked out for their own date. Without it, UTC.
birthDate	string	The birth date, such as 1990-01-20 (1901 to 2100). A date before that year's Lunar New Year belongs to the previous animal. Give this or year.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "year": {
      "type": "integer",
      "maximum": 2100,
      "minimum": 1901,
      "description": "A year, such as 1990, when the person gives only a year. The answer says which animal applies before that year's Lunar New Year."
    },
    "zone": {
      "type": "string",
      "pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
      "maxLength": 64,
      "minLength": 1,
      "description": "The person's time zone, such as Asia/Singapore, so the current year is worked out for their own date. Without it, UTC."
    },
    "birthDate": {
      "type": "string",
      "pattern": "^(?:19|20|21)\\d{2}-\\d{2}-\\d{2}$",
      "description": "The birth date, such as 1990-01-20 (1901 to 2100). A date before that year's Lunar New Year belongs to the previous animal. Give this or year."
    }
  },
  "additionalProperties": false
}

get_compatibility

Compares two people's birth charts: their Sun, Moon and rising signs, the closest contacts between their planets with what each traditionally means, and how their elements balance. Use it when someone asks about compatibility with a partner, friend or family member, or with a famous person. Each person needs a birth date; add a birth time, time zone and birthplace coordinates when known, and first names if they want them shown. To compare someone with a famous person Zodiacs publishes, give that side as { famous: "<name>" } instead: it uses their published chart for noon on their birth date, without a Moon or rising sign, and links to their page. If Zodiacs has no chart for that name it says so (found: false); never make one up. It returns a compatibility score out of 100 with scores for attraction, communication and long-term stability, a verdict and a headline: lead with the score and verdict in plain words, then the strongest and hardest contacts. Present it as astrology's reading, never a guarantee of how the relationship will turn out. If they want to share the score, give them the returned shareUrl exactly.

read-only

Argument	Type	Description
a*	object	The first person.
b*	object	The second person, or { famous: "<name>" } for a famous person Zodiacs publishes.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "a",
    "b"
  ],
  "properties": {
    "a": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "pattern": "^[^\\u0000-\\u001f\\u007f<>{}[\\]\\\\`]+$",
          "maxLength": 40,
          "minLength": 1,
          "description": "Optional first name to show on the card, only if the person wants one. Display only, not stored."
        },
        "time": {
          "type": "string",
          "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
          "description": "The birth time on the local clock, if known. Needs zone."
        },
        "zone": {
          "type": "string",
          "pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
          "maxLength": 64,
          "minLength": 1,
          "description": "The birthplace's time zone, such as Europe/Madrid. Needed with a time or a place."
        },
        "place": {
          "type": "string",
          "pattern": "^[^\\u0000-\\u001f\\u007f<>{}[\\]\\\\`]+$",
          "maxLength": 80,
          "minLength": 1,
          "description": "Optional birthplace name, such as Madrid, Spain. Display only, not stored."
        },
        "famous": {
          "type": "string",
          "pattern": "^[^\\u0000-\\u001f\\u007f<>{}[\\]\\\\`]+$",
          "maxLength": 80,
          "minLength": 1,
          "description": "Instead of birth details: the name of a famous person Zodiacs publishes a chart for, such as Frida Kahlo. Give it alone, without birthDate or any other field."
        },
        "latitude": {
          "type": "number",
          "maximum": 90,
          "minimum": -90,
          "description": "Optional. The birthplace's latitude; with a birth time it adds the rising sign. Give it with longitude and zone. Nothing is stored."
        },
        "birthDate": {
          "type": "string",
          "pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
          "description": "The birth date, such as 1994-08-21 (years 1800–2199). Needed unless famous is given."
        },
        "longitude": {
          "type": "number",
          "maximum": 180,
          "minimum": -180,
          "description": "Optional. The birthplace's longitude, with latitude. Nothing is stored."
        }
      },
      "description": "The first person.",
      "additionalProperties": false
    },
    "b": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "pattern": "^[^\\u0000-\\u001f\\u007f<>{}[\\]\\\\`]+$",
          "maxLength": 40,
          "minLength": 1,
          "description": "Optional first name to show on the card, only if the person wants one. Display only, not stored."
        },
        "time": {
          "type": "string",
          "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
          "description": "The birth time on the local clock, if known. Needs zone."
        },
        "zone": {
          "type": "string",
          "pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
          "maxLength": 64,
          "minLength": 1,
          "description": "The birthplace's time zone, such as Europe/Madrid. Needed with a time or a place."
        },
        "place": {
          "type": "string",
          "pattern": "^[^\\u0000-\\u001f\\u007f<>{}[\\]\\\\`]+$",
          "maxLength": 80,
          "minLength": 1,
          "description": "Optional birthplace name, such as Madrid, Spain. Display only, not stored."
        },
        "famous": {
          "type": "string",
          "pattern": "^[^\\u0000-\\u001f\\u007f<>{}[\\]\\\\`]+$",
          "maxLength": 80,
          "minLength": 1,
          "description": "Instead of birth details: the name of a famous person Zodiacs publishes a chart for, such as Frida Kahlo. Give it alone, without birthDate or any other field."
        },
        "latitude": {
          "type": "number",
          "maximum": 90,
          "minimum": -90,
          "description": "Optional. The birthplace's latitude; with a birth time it adds the rising sign. Give it with longitude and zone. Nothing is stored."
        },
        "birthDate": {
          "type": "string",
          "pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
          "description": "The birth date, such as 1994-08-21 (years 1800–2199). Needed unless famous is given."
        },
        "longitude": {
          "type": "number",
          "maximum": 180,
          "minimum": -180,
          "description": "Optional. The birthplace's longitude, with latitude. Nothing is stored."
        }
      },
      "description": "The second person, or { famous: \"<name>\" } for a famous person Zodiacs publishes.",
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

get_famous_chart

Looks up the birth chart of a famous person Zodiacs publishes: Sun and Moon signs and the planets' signs for their birth date, a short introduction and a link to their page. Use it when someone asks about a well-known person's chart or sign. If Zodiacs has no chart for that person, it says so; never make one up. If they want to share the chart, give them the returned shareUrl exactly.

read-only

Argument	Type	Description
name*	string	The person's name, such as Ada Lovelace.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 80,
      "minLength": 2,
      "description": "The person's name, such as Ada Lovelace."
    }
  },
  "additionalProperties": false
}

get_horoscope

Shows a Sun-sign horoscope, general, love or career for today or general for this week, written for the person's own date. Do not call this tool for stock picks, investment advice, financial forecasts, health predictions or guaranteed outcomes, even when the request mentions a horoscope. Decline those requests without a tool call; do not offer astrology-themed investment suggestions. Use it for a horoscope or reflective reading. Leave out the sign to let them choose; never guess it. Pass their time zone if you know it. Share the reading as written and keep its dates. If the person gives their birth date (and time and birthplace zone if known), pass them too: the result adds a personal forecast for their week from their own chart. Lead with those personal lines, with their dates. If you can schedule tasks for the person, offer once, briefly, to send them their horoscope every morning; Zodiacs itself sends no notifications. If they want to share the reading, give them the returned shareUrl exactly.

read-only

Argument	Type	Description
date	string	A date such as 2026-10-08. Leave it out for the person's today.
sign	string	Sun sign. Leave it out to let the person choose; never guess it.
zone	string	The person's time zone, such as Asia/Bangkok or America/New_York. Without it, times are in UTC.
focus	string	For a daily reading: general (the default), love or career.
period	string	day (the default) or week.

get_horoscope_period

Shows a Sun-sign horoscope for a month, a year, or a love or career week: the reading Zodiacs publishes for that period and the period's sky for the sign (planets changing sign, turning retrograde or direct, new and full Moons and eclipses) placed in the sign's solar houses; a month's sky leaves out the Moon's sign changes. Monthly readings are published from the first of each month; yearly readings are published for 2026 and 2027. A week is only for focus love or career: it adds that focus's daily readings in the week and keeps the sky events that bear on it. For a general week, and for today's or tomorrow's horoscope, use get_horoscope. When a reading is not published it says so and still gives the sky; never write a reading yourself in its place. If the person is under 18, do not use focus love and do not frame the reading as romance or attraction. Share the forecast plainly and confidently, with the reading-confidence label it returns. Do not call it for stock picks, investment advice, health predictions or guaranteed outcomes. Never guess the sign.

read-only

Argument	Type	Description
date	string	Any day in the month, year or week wanted, such as 2026-12-01 for December 2026. Leave it out for the person's current month, year or week.
sign*	string	Sun sign. Never guess it; ask the person if they have not said.
zone	string	The person's time zone, such as America/New_York, so the period and dates are their own. Without it, UTC.
focus	string	general (the default), love or career. For a week it adds that focus's daily readings; for every period it keeps the sky events that bear on it.

get_life_milestones

Lists astrology's life milestones from a birth date: each Jupiter return (about every 12 years), the Saturn returns (around 29, 58 and 88) and the Uranus opposition (early forties), with dates, ages and every pass of a retrograde loop, the next one coming, and how many full Moons and Mercury retrogrades the person has lived through. A birth date is enough; add the birth time and time zone if known. It makes no prediction. If they want to share it, give them the returned shareUrl exactly; it shows the milestone the card leads with, never the birth date.

read-only

Argument	Type	Description
time	string	The birth time on the local clock, if known. Needs zone.
zone	string	The birthplace's time zone, such as Europe/London. Needed with a time.
birthDate*	string	The birth date, such as 1997-03-15.
longitude	number	The birthplace's longitude, if known, for birth times before standard time.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "birthDate"
  ],
  "properties": {
    "time": {
      "type": "string",
      "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
      "description": "The birth time on the local clock, if known. Needs zone."
    },
    "zone": {
      "type": "string",
      "pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
      "maxLength": 64,
      "minLength": 1,
      "description": "The birthplace's time zone, such as Europe/London. Needed with a time."
    },
    "birthDate": {
      "type": "string",
      "pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
      "description": "The birth date, such as 1997-03-15."
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180,
      "description": "The birthplace's longitude, if known, for birth times before standard time."
    }
  },
  "additionalProperties": false
}

get_natal_chart

Reads one person's birth chart in the conversation when they have already given their birth date. If they have not, or want to explore it themselves, use open_chart_studio. It gives the Sun, Moon and rising signs, each planet's sign and degree, its house when the birth time and place are known, the closest aspects between the planets (the tightest by orb), and the balance of elements and modes, each with what astrology traditionally reads into it. Add the birth time, the birthplace's time zone and its latitude and longitude only as the person gives them, and never guess a birth time. When they name a town or city instead of coordinates, use find_birthplace first and pass its latitude, longitude and time zone. Without a time it says plainly what is unknown: the rising sign, the houses and, on a day the Moon changed sign, the Moon sign, which it gives as the two possibilities. When the birth time fell in a daylight saving change (a skipped or a repeated hour), timeNote says which instant the chart used; tell the person. If the birth date is under 18, do not frame the chart as romance or attraction. chartUrl opens the birth chart page and does not carry the birth date, time, place or coordinates; give it as the page to open, not as a link that holds their details.

read-only

Argument	Type	Description
time	string	The birth time on the local clock, such as 08:30, only if the person knows it. Never guess it. Needs zone.
zone	string	The birthplace's time zone, such as Europe/Madrid. Needed with a time or a place.
place	string	Optional birthplace name, such as Madrid, Spain. Display only: it is not used in the calculation and is not stored.
latitude

get_occasion_sky

Shows the sky on a day that matters to the person: a wedding, anniversary, birthday, a new home or another occasion. It gives the Sun and Moon signs, the Moon's phase, any retrograde planets, a card title and short lines they can use, and, with a place, sunset, golden hour, dusk, the Moon and the planets visible that evening. It needs the date; add the local time, the place's time zone and its coordinates if the person gives them. It also rates the date from 0 to 100 with a verdict and the astrological reasons (Venus, the Moon's phase and sign, retrograde planets); share the rating and its reasons plainly. When asked for the best days for an occasion, give the window as searchFrom and searchTo (up to 92 days, such as a whole month); it rates every day in it and returns the three best-rated days with their reasons, and the card for the best one unless a date is also given. When asked which of a few named dates is best, call it for each date and compare the ratings. It never guarantees how the day will go. For the printable card, copy the returned cardUrl exactly, including every field after #; do not reconstruct it from the conversation. If cardUrl is null, use the returned page link. If they want to share the rating, give them the returned shareUrl exactly.

read-only

Argument	Type	Description
date	string	The day, such as 2027-06-12 (years 1800–2199). Needed unless searchFrom and searchTo are given.
time	string	The local clock time, such as 19:00, if the person gives one. Needs zone.
zone	string	The place's time zone, such as Europe/Rome. Needed with a time or a place.
names	string

get_personal_transits

Lists dated transits to the person's own birth chart: when the moving planets make exact aspects to their natal planets (and to the rising degree and Midheaven when the birth time and place are known), with what astrology traditionally reads into each. Use it for my transits, what's coming up for me, or my year ahead, once the person has given a birth date; for a Sun-sign horoscope use get_horoscope or get_horoscope_period. Give the birth date, and the time, birthplace time zone and coordinates only as the person gives them; never guess a birth time. When they name a town or city instead of coordinates, use find_birthplace first and pass its latitude, longitude and time zone. Pass currentZone, where they live now, so the dates fall on their own clock. By default it covers the next 30 days; give from and to for any window up to 366 days (windows over 92 days keep to Jupiter through Pluto). The window cannot start before the birth date. A retrograde contact's pass number counts the whole loop, including passes outside the window. With mode year-ahead it gives the year's highlights instead: Jupiter and Saturn on the Sun, Moon, Mercury, Venus, Mars and rising degree, Uranus, Neptune and Pluto on the Sun, Moon, Mercury, Venus and Mars, the solar return, a Saturn return, Jupiter and Saturn changing sign (with the house it falls in when the time and place are known) and eclipses near natal planets. If the birth date is under 18, do not frame the lines as romance or attraction. Present each line plainly and confidently as astrology's reading, with its reading-confidence label, never as a guarantee, and never turn a line into health, financial or medical advice.

read-only

Argument	Type	Description
to	string	For window: the last day, at most 366 days after from. Defaults to a 30-day window, from included.
from	string	For window: the first day, such as 2026-11-01. Defaults to today.

get_sky

Shows where the Sun, Moon and planets are right now, or at a moment the person names, with the Moon's phase. Pass the person's time zone if you know it so times read on their clock. Astronomy only; it makes no personal prediction.

read-only

Argument	Type	Description
zone	string	The person's time zone, such as Asia/Bangkok or America/New_York. Without it, times are in UTC.
bodies	array
instant	string	A moment as an ISO 8601 time with Z or an offset, such as 2026-10-08T09:00:00+07:00 (years 1800–2199).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "zone": {
      "type": "string",
      "pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
      "maxLength": 64,
      "minLength": 1,
      "description": "The person's time zone, such as Asia/Bangkok or America/New_York. Without it, times are in UTC."
    },
    "bodies": {
      "type": "array",
      "items": {
        "enum": [
          "Sun",
          "Moon",
          "Mercury",
          "Venus",
          "Mars",
          "Jupiter",
          "Saturn",
          "Uranus",
          "Neptune",
          "Pluto",
          "North Node",
          "South Node"
        ],
        "type": "string"
      },
      "maxItems": 12,
      "minItems": 1
    },
    "instant": {
      "type": "string",
      "maxLength": 29,
      "minLength": 20,
      "description": "A moment as an ISO 8601 time with Z or an offset, such as 2026-10-08T09:00:00+07:00 (years 1800–2199)."
    }
  },
  "additionalProperties": false
}

get_sky_calendar

Gives the link to subscribe to Zodiacs' sky calendar in Google Calendar, Apple Calendar or Outlook: new and full Moons, eclipses and retrograde periods, updated automatically, with how to add it and the next few events. Use it when someone wants these in their own calendar. Available in English, Spanish, Portuguese, French, Italian and Russian. If they want to share the calendar, give them the returned shareUrl exactly; it shows the next event.

read-only

Argument	Type	Description
language	string	The language of the event titles: en (the default), es, pt, fr, it or ru.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "language": {
      "enum": [
        "en",
        "es",
        "pt",
        "fr",
        "it",
        "ru"
      ],
      "type": "string",
      "description": "The language of the event titles: en (the default), es, pt, fr, it or ru."
    }
  },
  "additionalProperties": false
}

get_upcoming_events

Shows what changes in the sky over the coming days or weeks: planets changing sign, turning retrograde or direct, and new and full Moons, for up to 92 days. Supply from and to, and the person's time zone. With no arguments it opens the calendar for the next seven days. It does not list eclipses or every aspect.

read-only

Argument	Type	Description
to	string	A moment as an ISO 8601 time with Z or an offset, such as 2026-10-08T09:00:00+07:00 (years 1800–2199).
from	string	A moment as an ISO 8601 time with Z or an offset, such as 2026-10-08T09:00:00+07:00 (years 1800–2199).
zone	string	The person's time zone, such as Asia/Bangkok or America/New_York. Without it, times are in UTC.
kinds	array
bodies	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "to": {
      "type": "string",
      "maxLength": 29,
      "minLength": 20,
      "description": "A moment as an ISO 8601 time with Z or an offset, such as 2026-10-08T09:00:00+07:00 (years 1800–2199)."
    },
    "from": {
      "type": "string",
      "maxLength": 29,
      "minLength": 20,
      "description": "A moment as an ISO 8601 time with Z or an offset, such as 2026-10-08T09:00:00+07:00 (years 1800–2199)."
    },
    "zone": {
      "type": "string",
      "pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
      "maxLength": 64,
      "minLength": 1,
      "description": "The person's time zone, such as Asia/Bangkok or America/New_York. Without it, times are in UTC."
    },
    "kinds": {
      "type": "array",
      "items": {
        "enum": [
          "ingress",
          "station",
          "lunation"
        ],
        "type": "string"
      },
      "maxItems": 3,
      "minItems": 1
    },
    "bodies": {
      "type": "array",
      "items": {
        "enum": [
          "Sun",
          "Moon",
          "Mercury",
          "Venus",
          "Mars",
          "Jupiter",
          "Saturn",
          "Uranus",
          "Neptune",
          "Pluto"
        ],
        "type": "string"
      },
      "maxItems": 10,
      "minItems": 1
    }
  },
  "additionalProperties": false
}

open_chart_studio

Opens Chart Studio, an interactive birth chart the person fills in themselves: birth date, place, and time if they know it. Call it with no arguments and do not ask for birth details first. The chart is calculated inside the panel; you see only the parts the person chooses to share.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {},
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "date": {
      "type": "string",
      "pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
      "description": "A date such as 2026-10-08. Leave it out for the person's today."
    },
    "sign": {
      "enum": [
        "aries",
        "taurus",
        "gemini",
        "cancer",
        "leo",
        "virgo",
        "libra",
        "scorpio",
        "sagittarius",
        "capricorn",
        "aquarius",
        "pisces"
      ],
      "type": "string",
      "description": "Sun sign. Leave it out to let the person choose; never guess it."
    },
    "zone": {
      "type": "string",
      "pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
      "maxLength": 64,
      "minLength": 1,
      "description": "The person's time zone, such as Asia/Bangkok or America/New_York. Without it, times are in UTC."
    },
    "focus": {
      "enum": [
        "general",
        "love",
        "career"
      ],
      "type": "string",
      "description": "For a daily reading: general (the default), love or career."
    },
    "period": {
      "enum": [
        "day",
        "week"
      ],
      "type": "string",
      "description": "day (the default) or week."
    },
    "birthDate": {
      "type": "string",
      "pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
      "description": "Optional: the person's birth date, for a personal forecast of their week from their own chart. Not stored."
    },
    "birthTime": {
      "type": "string",
      "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
      "description": "Optional birth time on the local clock; needs birthZone. Not stored."
    },
    "birthZone": {
      "type": "string",
      "pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
      "maxLength": 64,
      "minLength": 1,
      "description": "Optional: the birthplace's time zone, needed with birthTime. Not stored."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "occasion"
  ],
  "properties": {
    "date": {
      "type": "string",
      "pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
      "description": "The day, such as 2027-06-12 (years 1800–2199). Needed unless searchFrom and searchTo are given."
    },
    "time": {
      "type": "string",
      "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
      "description": "The local clock time, such as 19:00, if the person gives one. Needs zone."
    },
    "zone": {
      "type": "string",
      "pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
      "maxLength": 64,
      "minLength": 1,
      "description": "The place's time zone, such as Europe/Rome. Needed with a time or a place."
    },
    "names": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1,
      "description": "Optional: up to two first names to print on the card, only if the person asks for them. Display only, not stored."
    },
    "place": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "Optional place name printed on the card, such as Florence, Italy. Display only: it is not used in the calculation and is not stored."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90,
      "description": "Optional. The place's latitude, used only to work out sunset, golden hour and the evening sky there. Give it with longitude and zone. Nothing is stored."
    },
    "occasion": {
      "enum": [
        "wedding",
        "anniversary",
        "met",
        "birthday",
        "pet",
        "home",
        "job",
        "graduation",
        "retirement",
        "gathering"
      ],
      "type": "string",
      "description": "What the day is: wedding, anniversary, met (the day they met), birthday, pet, home, job, graduation, retirement or gathering."
    },
    "searchTo": {
      "type": "string",
      "pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
      "description": "The last day of the window to search, such as 2027-06-30, at most 92 days after searchFrom counting both days. Every day is rated and the three best come back."
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180,
      "description": "Optional. The place's longitude, with latitude, for the evening sky. Nothing is stored."
    },
    "searchFrom": {
      "type": "string",
      "pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
      "description": "To find the best days: the first day of the window to search, such as 2027-06-01. Give it with searchTo."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "birthDate"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
      "description": "For window: the last day, at most 366 days after from. Defaults to a 30-day window, from included."
    },
    "from": {
      "type": "string",
      "pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
      "description": "For window: the first day, such as 2026-11-01. Defaults to today."
    },
    "mode": {
      "enum": [
        "window",
        "year-ahead"
      ],
      "type": "string",
      "description": "window (the default): every exact contact between from and to. year-ahead: the year from today, with Jupiter and Saturn, the solar return, a Saturn return, sign changes and eclipses near the chart."
    },
    "time": {
      "type": "string",
      "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
      "description": "The birth time on the local clock, only if the person knows it. Never guess it. Needs zone. Without it the Moon, rising degree and Midheaven are left out."
    },
    "zone": {
      "type": "string",
      "pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
      "maxLength": 64,
      "minLength": 1,
      "description": "The birthplace's time zone, such as Europe/Madrid. Needed with a time or a place."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90,
      "description": "Optional. The birthplace's latitude; with a birth time it adds the rising degree and Midheaven. Give it with longitude and zone. Nothing is stored."
    },
    "birthDate": {
      "type": "string",
      "pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
      "description": "The birth date, such as 1990-05-03 (years 1800 to 2199)."
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180,
      "description": "Optional. The birthplace's longitude, with latitude. Nothing is stored."
    },
    "currentZone": {
      "type": "string",
      "pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
      "maxLength": 64,
      "minLength": 1,
      "description": "Where the person lives now, such as Asia/Bangkok, so dates fall on their own clock. Without it, dates use the birthplace clock, or UTC if that is missing too, and the answer says which."
    }
  },
  "additionalProperties": false
}

Zodiacs

Registry entry

Try it

check_sky_fact Read-only

Zodiacs

Registry entry

Try it

check_sky_fact Read-only

Install

Tools (19)

Security checkA100/100