Search / io.github.zodiacs-org/zodiacs
Zodiacs
R0· no sign-inExplore your birth chart, compatibility, horoscopes and the sky on days that matter.
v0.6.6 · active · website · descriptor JSON · versions
Search / io.github.zodiacs-org/zodiacs
R0· no sign-inExplore your birth chart, compatibility, horoscopes and the sky on days that matter.
v0.6.6 · active · website · descriptor JSON · versions
{
"mcpServers": {
"zodiacs": {
"type": "http",
"url": "https://zodiacs.org/mcp"
}
}
}claude mcp add --transport http zodiacs https://zodiacs.org/mcp[mcp_servers.zodiacs]
url = "https://zodiacs.org/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"zodiacs": {
"type": "remote",
"url": "https://zodiacs.org/mcp",
"enabled": true
}
}
}{
"mcpServers": {
"zodiacs": {
"type": "http",
"url": "https://zodiacs.org/mcp"
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=zodiacs&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vem9kaWFjcy5vcmcvbWNwIn0%3D"
}{
"servers": {
"zodiacs": {
"type": "http",
"url": "https://zodiacs.org/mcp"
}
}
}{
"mcpServers": {
"zodiacs": {
"httpUrl": "https://zodiacs.org/mcp"
}
}
}extensions:
"zodiacs":
enabled: true
name: "zodiacs"
type: streamable_http
uri: "https://zodiacs.org/mcp"
timeout: 300
protocol.modernprotocol.statelessprotocol.transportprotocol.list_ttlauth.prm, auth.as_metadata, auth.cimdauth.secret_in_urltools.descriptionstools.description_lengthtools.schemastools.annotationstools.directory_hintstools.token_costtools.api_dumptools.hidden_textstability.changes, stability.rug_pull, stability.new_linksdeps.known_vulns, deps.mcp_sdk_version, deps.resolvablefind_birthplacechangeddescriptionResolves 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.
Resolves the name of a town or city to 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. get_natal_chart, get_personal_transits, get_compatibility and get_occasion_sky take those coordinates and that time zone. It fits a birthplace or a venue named as a town or city, where a chart tool needs its coordinates and time zone. Public town and city names only; it does not take a street address. It searches 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. An unknown place returns "No town or city matches". A place gives no information about a birth time. Dates for the offset run from 1800 to 2199.
explain_astrologychangeddescriptionExplains 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.
Explains a basic astrology topic in plain words from Zodiacs' own pages, with links to them. It also answers whether two Sun signs are compatible, from that sign-pair page. It fits a "what does X mean" question: a sign and its traits, a planet, a planet in a sign or a house, the houses, aspects, retrogrades, Moon phases, the void-of-course Moon, eclipses, the rising sign, the Midheaven, the big three, cusps, the Saturn return, the solar return, elements, modalities, transits, synastry, Sun-sign pairs or the Chinese zodiac. For tarot, numerology, horary, Vedic astrology or another system Zodiacs does not cover, or when nothing matches, it returns found: false with the topics it does explain. A person's own placements belong to get_natal_chart. A Sun-sign pair is answered as a romance reading for adults unless the topic includes the word friendship; the friendship answer is the element and modality pattern alone, with no romance. For anyone under 18 there is no love or romance reading, and the friendship reading takes its place. It takes no age or birth date, so it cannot know a reader's age.
get_personal_transitschangeddescriptionLists 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.
Lists dated transits to one person's birth chart: when the moving planets make exact aspects to the natal planets, and to the rising degree and Midheaven when the birth time and place are known, each with what astrology traditionally reads into it and a "Reading confidence NN%" label that says how specific the details were, not the odds of an event. By default it covers the next 30 days. In year-ahead mode it gives the year's highlights: the slow planets on the personal planets, the solar return, a Saturn return, Jupiter and Saturn changing sign, and eclipses near natal planets. It fits "my transits", "what is coming up for me" or "my year ahead", once a birth date has been given; get_horoscope and get_horoscope_period hold the Sun-sign horoscopes. A window is at most 366 days, and a window over 92 days keeps to Jupiter through Pluto. The window cannot start before the birth date. Without a birth time the Moon, the rising degree and the Midheaven are left out. Without currentZone dates use the birthplace's clock, or UTC if that is missing too, and the answer says which. Each line is astrology's reading, not a guarantee, and not health, financial or medical advice. It refuses a birth date less than 13 years ago, so it also refuses transits to a chart of today. For a birth date under 18 romantic and attraction readings are left out and a note says so.
get_chinese_zodiacchangeddescriptionGives 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.
Gives the Chinese zodiac animal, element and yin or yang for a birth date or a year, and the current year's animal. It adds the animal's traditional associations and pairings (the harmonious three, the six-harmony partner and the opposite animal), with links to the animal's page. It fits a question about someone's Chinese zodiac animal, or the animal of a year. A birth date before that year's Lunar New Year belongs to the previous animal year, and the answer gives the Lunar New Year date it used. Years run from 1901 to 2100. Without a time zone the current year is worked out in UTC, and the answer says so. It refuses a full birth date less than 13 years ago; given only a year, it answers.
get_horoscope_periodchangeddescriptionShows 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.
Returns the Sun-sign reading Zodiacs publishes for a month, a year, or a love or career week, together with that 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 week adds that focus's daily readings. The forecast carries a "Reading confidence NN%" label that says how specific the details were, not the odds of an event. It fits a request for a sign's month or year, or for a love or career week. Monthly readings are published from the first of each month, and yearly readings exist for 2026 and 2027. When a reading is not published it says so and still gives the sky. A month's sky leaves out the Moon's sign changes. A week is for love or career only; a general week and a single day belong to get_horoscope. Limits: focus love is a romance reading for adults, so for anyone under 18 there is no love or romance reading. No betting tips, sports picks, stock picks, investment timing, election forecasts, health predictions or guaranteed outcomes. It takes no birth date, so it cannot know a reader's age. Its results include a link to the sign-up page for the daily email. Its times for a slow planet's sign change carry the same limit as get_upcoming_events.
get_natal_chartchangeddescriptionReads 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.
Reads one person's birth chart in the conversation: 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, and the balance of elements and modes, each with what astrology traditionally reads into it. It fits someone who has already given their birth date and wants the chart read out; open_chart_studio is the panel for filling one in. Without a birth time it gives no rising sign and no houses, and on a day the Moon changed sign it gives the Moon sign as two possibilities. The rising sign and houses also need the birthplace's latitude, longitude and time zone, which find_birthplace returns for a town or city. When the birth time fell in a skipped or repeated hour of a clock change, timeNote says which instant was used. Birth dates run from 1800 to 2199. It refuses a birth date less than 13 years ago, so it also refuses a chart for today or for a recent moment; for the sky at a moment there is get_sky. For a birth date under 18 romantic and attraction readings are left out and a note says so. chartUrl opens the birth chart page and carries no birth date, time, place or coordinates.
get_sky_calendarchangeddescriptionGives 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.
Returns the link for subscribing to Zodiacs' sky calendar in Google Calendar, Apple Calendar or Outlook, with how to add it and the next few events. The calendar holds new and full Moons, eclipses and retrograde periods and updates itself. It fits someone who wants these events in their own calendar. Event titles come in English, Spanish, Portuguese, French, Italian or Russian. It returns a subscription link; it adds nothing to anyone's calendar itself and schedules nothing.
get_birthdaychangeddescriptionDescribes 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.
Describes the sky on a birthday: the Sun's sign for the date, its traditional meaning, the decan, and whether the date is on a cusp where the sign depends on the year or time. With a full birth date it resolves a cusp date's sign for that year, or calculates a solar return, the moment the Sun comes back to its birth position. It links to the date's birthday page and names the published famous people born that day. It fits a question about one birthday. It makes no prediction. A month and day is enough for general facts; the full birth date is needed only for a cusp or a solar return. The longitude field is for historical dates when a birthplace kept local mean time, and has no use for a modern birthday. Solar return years run from 1801 to 2199. It refuses a birth date less than 13 years ago. Its share link carries the month and day, never the year.
get_famous_chartchangeddescriptionLooks 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.
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. It fits a question about a well-known person's chart or sign. It covers only the people Zodiacs publishes. For anyone else it says it has no chart (found: false) and returns none.
find_chart_twinschangeddescriptionFinds 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.
Finds famous people, among those Zodiacs publishes charts for, whose Sun sign, Moon sign or both match the person's, with a link to each chart. It fits a question about which famous people share someone's sign or chart. A birth date alone compares the Sun only; the Moon needs the birth time and time zone. It searches only the people Zodiacs publishes. It refuses a birth date less than 13 years ago. Its share link carries the signs and never the birth date.
Showing the latest 10. Full history: list_changes · trend: quality JSON.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+website +reachable +uptime-100% +updated-6d-ago -no-repository
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://zodiacs.org/mcp streamable-http | none | yes | 100% | 357 ms | 2026-07-28 | 2026-11-14 |
check_sky_factread-only | Checks one claim about the sky and answers yes, no, or that it depends on the time zone when the answer changes during that day. It checks four kinds of claim: a body's sign, whether a planet is retrograde, a sign change on a date, and a Moon phase on a date. It fits a question such as 'Is Mercury retrograde today?' or 'Did the Sun enter Libra on 23 September?'. It is astronomy only and cannot check a prediction. Dates run from 1800 to 2199. Its times for a slow planet's sign change carry the same limit as get_upcoming_events: it gives 14:31:41 UTC for Neptune entering Aries on 26 January 2026, where NASA JPL Horizons gives 17:35 UTC. API documentation: https://zodiacs.org/developers/compute/. |
explain_astrologyread-only | Explains a basic astrology topic in plain words from Zodiacs' own pages, with links to them. It also answers whether two Sun signs are compatible, from that sign-pair page. It fits a "what does X mean" question: a sign and its traits, a planet, a planet in a sign or a house, the houses, aspects, retrogrades, Moon phases, the void-of-course Moon, eclipses, the rising sign, the Midheaven, the big three, cusps, the Saturn return, the solar return, elements, modalities, transits, synastry, Sun-sign pairs or the Chinese zodiac. For tarot, numerology, horary, Vedic astrology or another system Zodiacs does not cover, or when nothing matches, it returns found: false with the topics it does explain. A person's own placements belong to get_natal_chart. A Sun-sign pair is answered as a romance reading for adults unless the topic includes the word friendship; the friendship answer is the element and modality pattern alone, with no romance. For anyone under 18 there is no love or romance reading, and the friendship reading takes its place. It takes no age or birth date, so it cannot know a reader's age. |
find_birthplaceread-only | Resolves the name of a town or city to 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. get_natal_chart, get_personal_transits, get_compatibility and get_occasion_sky take those coordinates and that time zone. It fits a birthplace or a venue named as a town or city, where a chart tool needs its coordinates and time zone. Public town and city names only; it does not take a street address. It searches 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. An unknown place returns "No town or city matches". A place gives no information about a birth time. Dates for the offset run from 1800 to 2199. |
find_chart_twinsread-only | Finds famous people, among those Zodiacs publishes charts for, whose Sun sign, Moon sign or both match the person's, with a link to each chart. It fits a question about which famous people share someone's sign or chart. A birth date alone compares the Sun only; the Moon needs the birth time and time zone. It searches only the people Zodiacs publishes. It refuses a birth date less than 13 years ago. Its share link carries the signs and never the birth date. |
get_birthdayread-only | Describes the sky on a birthday: the Sun's sign for the date, its traditional meaning, the decan, and whether the date is on a cusp where the sign depends on the year or time. With a full birth date it resolves a cusp date's sign for that year, or calculates a solar return, the moment the Sun comes back to its birth position. It links to the date's birthday page and names the published famous people born that day. It fits a question about one birthday. It makes no prediction. A month and day is enough for general facts; the full birth date is needed only for a cusp or a solar return. The longitude field is for historical dates when a birthplace kept local mean time, and has no use for a modern birthday. Solar return years run from 1801 to 2199. It refuses a birth date less than 13 years ago. Its share link carries the month and day, never the year. |
get_capabilitiesread-only | Returns a list of what Zodiacs can do, its limits and how it handles privacy. It takes no input and needs no sign-in or birth details. It fits a question about what Zodiacs can do, or about its limits. It describes the service and calculates nothing. Zodiacs does not schedule anything, pick stocks or investments, make health predictions or guarantee outcomes. |
get_chinese_zodiacread-only | Gives the Chinese zodiac animal, element and yin or yang for a birth date or a year, and the current year's animal. It adds the animal's traditional associations and pairings (the harmonious three, the six-harmony partner and the opposite animal), with links to the animal's page. It fits a question about someone's Chinese zodiac animal, or the animal of a year. A birth date before that year's Lunar New Year belongs to the previous animal year, and the answer gives the Lunar New Year date it used. Years run from 1901 to 2100. Without a time zone the current year is worked out in UTC, and the answer says so. It refuses a full birth date less than 13 years ago; given only a year, it answers. |
get_compatibilityread-only | Compares two birth charts: the two people's Sun, Moon and rising signs, the closest contacts between their planets with what each traditionally means, and how their elements balance. It returns a score out of 100, scores for attraction, communication and long-term stability, a verdict, a headline and a "Reading confidence NN%" label that says how specific the details were, not the odds of an event. One side can be a famous person whose chart Zodiacs publishes. shareUrl is the link for sharing the score. It fits a question about compatibility between two adults, or between a person and a published famous person. The score is astrology's reading of two charts, not a guarantee of how a relationship will go. Limits: it compares two adults, so when either birth date is under 18 there is no love or romance reading and no score. It refuses a birth date less than 13 years ago. Each person needs a birth date; without a birth time and place there is no rising sign. A famous person's chart is for noon on their birth date, with no Moon or rising sign, and an unknown name returns found: false. Birth details are used for this answer only: never stored, logged or put in a link. Its results include a link inviting a partner to compare charts on the site. |
get_famous_chartread-only | 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. It fits a question about a well-known person's chart or sign. It covers only the people Zodiacs publishes. For anyone else it says it has no chart (found: false) and returns none. |
get_horoscoperead-only | Returns the Sun-sign horoscope Zodiacs publishes for a date: general, love or career for a day, or general for the week. With a birth date it adds a personal forecast for the week from that person's own chart, in dated lines. Each reading is dated and carries a "Reading confidence NN%" label that says how specific the details were, not the odds of an event. shareUrl is the link for sharing the reading. It fits a request for a daily or weekly horoscope or a reflective reading for a sign. Daily readings exist for the day before, the day of and the day after the current edition. Limits: no betting tips, sports picks, stock picks, investment timing, financial forecasts, election forecasts, health predictions or guaranteed outcomes, including when such a request mentions a horoscope. For a birth date under 18 there is no love or romance reading: the general reading stands in, with a note that says so. With no birth date it has no way to know the reader's age. It refuses a birth date less than 13 years ago. Birth details are used for this answer only: never stored, logged or put in a link. Zodiacs sends no notifications and schedules nothing. Its results include a link to the sign-up page for the daily email. |
get_horoscope_periodread-only | Returns the Sun-sign reading Zodiacs publishes for a month, a year, or a love or career week, together with that 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 week adds that focus's daily readings. The forecast carries a "Reading confidence NN%" label that says how specific the details were, not the odds of an event. It fits a request for a sign's month or year, or for a love or career week. Monthly readings are published from the first of each month, and yearly readings exist for 2026 and 2027. When a reading is not published it says so and still gives the sky. A month's sky leaves out the Moon's sign changes. A week is for love or career only; a general week and a single day belong to get_horoscope. Limits: focus love is a romance reading for adults, so for anyone under 18 there is no love or romance reading. No betting tips, sports picks, stock picks, investment timing, election forecasts, health predictions or guaranteed outcomes. It takes no birth date, so it cannot know a reader's age. Its results include a link to the sign-up page for the daily email. Its times for a slow planet's sign change carry the same limit as get_upcoming_events. |
get_life_milestonesread-only | 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 counts of the full Moons and Mercury retrogrades since birth. It fits a question about a Saturn return or another lifetime return, from a known birth date. It makes no prediction. A birth date is enough; a birth time needs the birthplace's time zone. It refuses a birth date less than 13 years ago. Its share link shows the milestone and the age at it, never the birth date. |
get_natal_chartread-only | Reads one person's birth chart in the conversation: 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, and the balance of elements and modes, each with what astrology traditionally reads into it. It fits someone who has already given their birth date and wants the chart read out; open_chart_studio is the panel for filling one in. Without a birth time it gives no rising sign and no houses, and on a day the Moon changed sign it gives the Moon sign as two possibilities. The rising sign and houses also need the birthplace's latitude, longitude and time zone, which find_birthplace returns for a town or city. When the birth time fell in a skipped or repeated hour of a clock change, timeNote says which instant was used. Birth dates run from 1800 to 2199. It refuses a birth date less than 13 years ago, so it also refuses a chart for today or for a recent moment; for the sky at a moment there is get_sky. For a birth date under 18 romantic and attraction readings are left out and a note says so. chartUrl opens the birth chart page and carries no birth date, time, place or coordinates. |
get_occasion_skyread-only | Describes the sky on a day that matters to someone: the Sun and Moon signs, the Moon's phase and any retrograde planets, with a card title and short lines. With a place it adds sunset, golden hour, dusk, the Moon and the planets visible that evening. It rates the date from 0 to 100 with a verdict, the astrological reasons (Venus, the Moon's phase and sign, retrograde planets) and a "Reading confidence NN%" label that says how specific the details were, not the odds of an event. Given a window of up to 92 days as searchFrom and searchTo it rates every day and returns the three best-rated days. It rates one date per call. cardUrl is the complete link to the printable card, including every field after #; when cardUrl is null, the returned page link takes its place. shareUrl is the link for sharing the rating. It fits a wedding, an anniversary, the day two people met, a birthday, a pet, a new home, a job, a graduation, a retirement or a gathering. The rating is astrology's traditional reading; it never guarantees how the day will go. A birthday card for a day in the last 13 years is refused. A card's link carries the occasion's own day, time, zone and rounded coordinates, and no name. The place name and first names are printed on the card only and are not used in the calculation. |
get_personal_transitsread-only | Lists dated transits to one person's birth chart: when the moving planets make exact aspects to the natal planets, and to the rising degree and Midheaven when the birth time and place are known, each with what astrology traditionally reads into it and a "Reading confidence NN%" label that says how specific the details were, not the odds of an event. By default it covers the next 30 days. In year-ahead mode it gives the year's highlights: the slow planets on the personal planets, the solar return, a Saturn return, Jupiter and Saturn changing sign, and eclipses near natal planets. It fits "my transits", "what is coming up for me" or "my year ahead", once a birth date has been given; get_horoscope and get_horoscope_period hold the Sun-sign horoscopes. A window is at most 366 days, and a window over 92 days keeps to Jupiter through Pluto. The window cannot start before the birth date. Without a birth time the Moon, the rising degree and the Midheaven are left out. Without currentZone dates use the birthplace's clock, or UTC if that is missing too, and the answer says which. Each line is astrology's reading, not a guarantee, and not health, financial or medical advice. It refuses a birth date less than 13 years ago, so it also refuses transits to a chart of today. For a birth date under 18 romantic and attraction readings are left out and a note says so. |
get_skyread-only | Returns where the Sun, the Moon and the planets are now or at a given moment, with the Moon's phase. It fits a question about the sky at one moment, with no person's chart involved. It is astronomy only and makes no personal prediction. Moments run from 1800 to 2199. It takes an optional time zone; without one its times are in UTC. It gives positions for a moment, with no houses or rising sign. |
get_sky_calendarread-only | Returns the link for subscribing to Zodiacs' sky calendar in Google Calendar, Apple Calendar or Outlook, with how to add it and the next few events. The calendar holds new and full Moons, eclipses and retrograde periods and updates itself. It fits someone who wants these events in their own calendar. Event titles come in English, Spanish, Portuguese, French, Italian or Russian. It returns a subscription link; it adds nothing to anyone's calendar itself and schedules nothing. |
get_upcoming_eventsread-only | Lists changes in the sky over a window of up to 92 days: planets changing sign, planets turning retrograde or direct, and new and full Moons. With no input it covers the next seven days. It fits a question about what is coming up in the sky over the next days or weeks. It does not list eclipses or every aspect. The window is at most 92 days, within 1800 to 2199. Without a time zone its times are in UTC. Its times for a slow planet's sign change come from the engine and can differ from NASA JPL Horizons by hours: for Neptune entering Aries on 26 January 2026 it gives 14:31:41 UTC, where Horizons gives 17:35 UTC. |
open_chart_studioread-only | Opens Chart Studio, an interactive birth chart that the person fills in themselves with a birth date, a place and, if known, a time. The chart is calculated inside the panel. It takes no input. It fits someone who wants to explore their own chart, or who has not given birth details in the conversation. The assistant sees only the parts of the chart the person chooses to share. |
Schemas: list_tools.
{
"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."
}