Server definition
- Hash
- sha256:05b99b2378b33a26733029ee29cd662ab439cf2d6e0037b0c990413784c38c01
- What it is
- What a remote MCP server returned when asked what it offers: 19 tools
The blob, as servednamed by its sha256
{
"instructions": "Zodiacs calculates the sky and publishes dated Sun-sign horoscopes. Its results keep calculated facts separate from what they mean in astrology, and say when an answer depends on the time zone. Calculation details such as versions, receipts and UTC are there for questions about how something was calculated. A URL in a result is complete as returned, including the query and the whole fragment after #, and a card link works only unchanged; where no card URL is returned, the returned page link takes its place. No Zodiacs link holds a birth date, birth time, birthplace or place name; an occasion card link can hold coordinates rounded to two decimals. A birth time and a sign are taken as the person gives them, never guessed. Ask before using someone else's birth details. Zodiacs never stores or logs birth details. Links never carry a birth year, a birth time, a birthplace or the names you give; a birthday link carries only the month and day. Zodiacs is not directed at children under 13, so do not send a child's name, birth date or birthplace to its tools; they refuse a birth date less than 13 years ago. There is no horoscope for a named child under 13, meaning a particular child the request names or points to, such as someone's nine-year-old daughter: not by sign, and not for a day, a week, a month or a year. A Sun sign on its own, with no name and no birth date, gets the general horoscope for that sign. If a person or a birth date is under 18, Zodiacs gives no reading framed as romance, attraction or a sexual relationship. Scores, ratings and astrological forecasts are astrology's reading, and each comes with a \"Reading confidence NN%\" label: it says how specific the details were, never the odds that an event happens. Zodiacs gives no betting tips, sports picks, investment timing, election forecasts or health predictions, and guarantees no outcome. It does not schedule anything, pick investments or give financial or medical advice. A request for one of those is outside Zodiacs even when it names a sign, a planet, a retrograde, a birth date or a horoscope: a stock or lottery pick, an investment call, a bet, an election or a medical outcome, a guarantee, a reminder or anything scheduled. No Zodiacs tool is for such a request, not even as a first step; the answer is that Zodiacs does not do this, with no tool call. Which tool: a horoscope goes to get_horoscope even with no sign given, since the person picks the sign in its panel; a birth chart, rising sign or Moon sign asked for with no birth date in the conversation goes to open_chart_studio, which opens with no details and takes them from the person there, and to get_natal_chart once a birth date is given; two people with birth dates go to get_compatibility, as partners, friends, family or colleagues, and two Sun signs alone go to explain_astrology; the sign, decan or cusp of a calendar date goes to get_birthday; what Zodiacs can do, what can be asked of it and how it handles privacy goes to get_capabilities. Signs, dates and positions come from the tools, the well-known ones too, not from memory.",
"tools": [
{
"description": "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. Whether a retrograde, a sign or a Moon phase makes a good time to buy, sell, bet or invest is not a claim about the sky. A request for a stock or lottery pick, an investment call, a bet, an election or health forecast, or a guarantee is not a request for this tool, not even as a first step: Zodiacs does not do this, and no sky fact is checked for it. 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/.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"body": {
"enum": [
"Sun",
"Moon",
"Mercury",
"Venus",
"Mars",
"Jupiter",
"Saturn",
"Uranus",
"Neptune",
"Pluto"
],
"type": "string"
},
"date": {
"pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
"type": "string"
},
"instant": {
"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).",
"maxLength": 29,
"minLength": 20,
"type": "string"
},
"kind": {
"enum": [
"sign",
"retrograde",
"ingress",
"phase"
],
"type": "string"
},
"phase": {
"enum": [
"new",
"first-quarter",
"full",
"last-quarter"
],
"type": "string"
},
"sign": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
},
"zone": {
"description": "The person's time zone, such as Asia/Bangkok or America/New_York. Without it, times are in UTC.",
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
},
"name": "check_sky_fact",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"answer": {
"enum": [
"true",
"false",
"depends"
],
"type": "string"
},
"calculation": {
"additionalProperties": false,
"properties": {
"backend": {
"properties": {
"ephemeris": {
"properties": {
"name": {
"const": "astronomy-engine"
},
"version": {
"type": "string"
}
},
"required": [
"name",
"version"
],
"type": "object"
},
"name": {
"const": "@zodiacs/engine"
},
"version": {
"type": "string"
}
},
"required": [
"name",
"version",
"ephemeris"
],
"type": "object"
},
"cite": {
"additionalProperties": false,
"properties": {
"engine": {
"type": "string"
},
"receipt": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"url",
"receipt",
"engine",
"version"
],
"type": "object"
},
"receipt": {
"description": "The receipt for a calculation the engine writes no receipt for: the engine, its conventions and coverage as its own receipts state them, and what this request used.",
"properties": {
"conventionIds": {
"description": "Every id of the Zodiacs conventions registry (https://zodiacs.org/developers/conventions/) that this receipt's own fields name, in code-unit order, each once: each conventions and coverage field, the ephemeris, the endpoint, each ΔT source's model, how local times were read and how a search ran. The result's are left out, so the receipt holds nothing the request gave.",
"items": {
"pattern": "^[A-Za-z][A-Za-z0-9-]*:\\S+$",
"type": "string"
},
"type": "array",
"uniqueItems": true
},
"conventions": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"coverage": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"deltaT": {
"description": "The two sources of ΔT the engine's time basis uses: IERS from 1972 to the end of its UT1 table, then its model. A result that gives an instant's ΔT names which applied.",
"maxItems": 2,
"minItems": 2,
"prefixItems": [
{
"properties": {
"model": {
"const": "iers-utc/1"
},
"table": {
"type": "string"
},
"tableDigest": {
"type": "string"
}
},
"required": [
"model",
"table",
"tableDigest"
],
"type": "object"
},
{
"properties": {
"model": {
"const": "zodiacs-deltat/1"
},
"table": {
"type": "string"
},
"tableDigest": {
"type": "string"
}
},
"required": [
"model",
"table",
"tableDigest"
],
"type": "object"
}
],
"type": "array"
},
"electionSearch": {
"description": "How an election search ran: the crossing search's steps for sign changes, stations and phases; the void-of-course rule and the step of its scan for the Moon's last aspect; the house sampling; the evaluations made, where a crossing step counts once and a full calculation, all the positions at an instant or a natalChart for a house, counts as fullCalculationCost. Every window's ends are within a second, so a gap shorter than resolutionSeconds between two windows is closed and a window shorter than it is not listed: two boundaries that close may be one instant found twice.",
"properties": {
"boundarySeconds": {
"const": 1
},
"completeness": {
"const": "tested-not-proven"
},
"fullCalculationCost": {
"const": 25
},
"houseSampleMinutes": {
"const": 60
},
"maxSamples": {
"type": "integer"
},
"resolutionSeconds": {
"const": 2
},
"samples": {
"minimum": 0,
"type": "integer"
},
"solver": {
"const": "engine-longitude-crossings-and-sampled-houses"
},
"stepDays": {
"additionalProperties": {
"type": "number"
},
"type": "object"
},
"voidOfCourse": {
"properties": {
"bodies": {
"const": "modern"
},
"convention": {
"const": "last-exact-ptolemaic-aspect-to-sign-exit"
},
"scanHours": {
"type": "number"
}
},
"required": [
"convention",
"bodies",
"scanHours"
],
"type": "object"
},
"window": {
"const": "start-inclusive-end-exclusive"
}
},
"required": [
"solver",
"stepDays",
"voidOfCourse",
"houseSampleMinutes",
"boundarySeconds",
"resolutionSeconds",
"fullCalculationCost",
"samples",
"maxSamples",
"window",
"completeness"
],
"type": "object"
},
"endpoint": {
"enum": [
"chart",
"positions",
"houses",
"events",
"time",
"sky-fact",
"elections"
]
},
"engine": {
"properties": {
"ephemeris": {
"properties": {
"name": {
"const": "astronomy-engine"
},
"version": {
"type": "string"
}
},
"required": [
"name",
"version"
],
"type": "object"
},
"name": {
"const": "@zodiacs/engine"
},
"version": {
"type": "string"
}
},
"required": [
"name",
"version",
"ephemeris"
],
"type": "object"
},
"referenceSpan": {
"properties": {
"from": {
"format": "date-time",
"type": "string"
},
"to": {
"format": "date-time",
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"schema": {
"const": "zodiacs.compute-receipt.v1"
},
"search": {
"properties": {
"bisections": {
"type": "integer"
},
"completeness": {
"const": "tested-not-proven"
},
"maxSamples": {
"type": "integer"
},
"samples": {
"minimum": 0,
"type": "integer"
},
"solver": {
"const": "engine-longitude-crossings"
},
"stepDays": {
"additionalProperties": {
"type": "number"
},
"type": "object"
},
"window": {
"const": "start-exclusive-end-inclusive"
}
},
"required": [
"solver",
"stepDays",
"bisections",
"samples",
"maxSamples",
"window",
"completeness"
],
"type": "object"
},
"timeResolution": {
"properties": {
"pinnedTzdb": {
"type": "object"
},
"policy": {
"properties": {
"fold": {
"const": "earlier"
},
"gap": {
"const": "shift-forward"
}
},
"type": "object"
},
"resolver": {
"type": "string"
},
"runtimeTzdb": {
"type": [
"string",
"null"
]
}
},
"required": [
"resolver",
"policy",
"pinnedTzdb",
"runtimeTzdb"
],
"type": "object"
}
},
"required": [
"schema",
"endpoint",
"engine",
"conventions",
"coverage",
"referenceSpan",
"deltaT",
"conventionIds"
],
"type": "object"
},
"result": {
"properties": {
"answer": {
"enum": [
"true",
"false",
"depends"
]
},
"basis": {
"enum": [
"instant",
"local-day",
"any-zone-day"
]
},
"fact": {
"description": "The fact as the server read it, with the zone as tzdb spells it.",
"properties": {
"aspect": {
"enum": [
"conjunction",
"sextile",
"square",
"trine",
"opposition"
]
},
"body": {
"enum": [
"Sun",
"Moon",
"Mercury",
"Venus",
"Mars",
"Jupiter",
"Saturn",
"Uranus",
"Neptune",
"Pluto"
]
},
"date": {
"anyOf": [
{
"pattern": "^(?:18|19|20|21)\\d{2}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])$",
"type": "string"
},
{
"type": "null"
}
]
},
"instant": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
]
},
"kind": {
"enum": [
"sign",
"retrograde",
"ingress",
"phase",
"aspect"
]
},
"other": {
"enum": [
"Sun",
"Moon",
"Mercury",
"Venus",
"Mars",
"Jupiter",
"Saturn",
"Uranus",
"Neptune",
"Pluto"
]
},
"phase": {
"enum": [
"new",
"first-quarter",
"full",
"last-quarter"
]
},
"sign": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
]
},
"zone": {
"anyOf": [
{
"description": "The zone as tzdb spells it.",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"kind",
"date",
"zone"
],
"type": "object"
},
"facts": {
"description": "The computed values that decide the answer. At an instant: the body's state there, or for an aspect both bodies' states, their separation, the orb and whether it is shrinking. On a day: the state at its start and end with the sign changes, stations or aspect changes between, or the ingresses or lunations in it. flags holds outside-reference-span when the instant or the day reaches past the instant span.",
"oneOf": [
{
"description": "At an instant.",
"properties": {
"boundaryMarginArcsec": {
"description": "For a sign fact: the distance to the nearer sign boundary.",
"minimum": 0,
"type": "number"
},
"degree": {
"type": "number"
},
"deltaT": {
"description": "ΔT = TT − UT1 in seconds, with its 1-sigma band and where it came from, as the engine reports it for a chart at the instant: iers-utc/1 from 1972 to the end of the engine's UT1 table, its model zodiacs-deltat/1 otherwise.",
"properties": {
"model": {
"enum": [
"iers-utc/1",
"zodiacs-deltat/1"
]
},
"seconds": {
"type": "number"
},
"segment": {
"enum": [
"long-term",
"reconstructed",
"observed",
"predicted",
"extrapolated"
]
},
"sigma": {
"type": "number"
},
"table": {
"type": "string"
},
"tableDigest": {
"type": "string"
}
},
"required": [
"seconds",
"sigma",
"model",
"table",
"tableDigest",
"segment"
],
"type": "object"
},
"flags": {
"items": {
"const": "outside-reference-span"
},
"maxItems": 1,
"type": "array"
},
"lon": {
"type": "number"
},
"retrograde": {
"type": "boolean"
},
"sign": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
]
},
"speed": {
"type": "number"
},
"timeScale": {
"description": "How the engine read the instant, as a chart reports it. basis iers, from 1972 to the end of its UT1 table: TT is UTC plus the leap seconds and 32.184 s, and UT1 is UTC plus IERS UT1 − UTC. basis delta-t, otherwise: the instant is read as UT1, and TT is UT1 plus the ΔT model.",
"properties": {
"basis": {
"enum": [
"iers",
"delta-t"
]
},
"input": {
"const": "utc"
},
"leapSeconds": {
"anyOf": [
{
"description": "TAI − UTC in seconds from the IERS leap-second list; listed is false after the list expires and its last value is carried.",
"properties": {
"listed": {
"type": "boolean"
},
"taiMinusUtc": {
"type": "number"
}
},
"required": [
"taiMinusUtc",
"listed"
],
"type": "object"
},
{
"type": "null"
}
]
},
"ut1MinusUtc": {
"anyOf": [
{
"description": "UT1 − UTC in seconds as the engine used it, with its 1-sigma band and its source: observed or predicted by IERS, or fallback after the table ends; null before 1972.",
"properties": {
"seconds": {
"type": "number"
},
"sigma": {
"type": "number"
},
"source": {
"enum": [
"observed",
"predicted",
"fallback"
]
}
},
"required": [
"seconds",
"sigma",
"source"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"input",
"basis",
"ut1MinusUtc",
"leapSeconds"
],
"type": "object"
}
},
"required": [
"lon",
"sign",
"degree",
"speed",
"retrograde",
"deltaT",
"timeScale",
"flags"
],
"type": "object"
},
{
"description": "A sign on a day: the sign changes in the day.",
"properties": {
"atEnd": {
"description": "A body's longitude, sign, degree, speed and direction at one instant.",
"properties": {
"degree": {
"type": "number"
},
"lon": {
"type": "number"
},
"retrograde": {
"type": "boolean"
},
"sign": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
]
},
"speed": {
"type": "number"
}
},
"required": [
"lon",
"sign",
"degree",
"speed",
"retrograde"
],
"type": "object"
},
"atStart": {
"description": "A body's longitude, sign, degree, speed and direction at one instant.",
"properties": {
"degree": {
"type": "number"
},
"lon": {
"type": "number"
},
"retrograde": {
"type": "boolean"
},
"sign": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
]
},
"speed": {
"type": "number"
}
},
"required": [
"lon",
"sign",
"degree",
"speed",
"retrograde"
],
"type": "object"
},
"changes": {
"items": {
"properties": {
"at": {
"format": "date-time",
"type": "string"
},
"into": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
]
},
"retrograde": {
"type": "boolean"
}
},
"required": [
"at",
"into",
"retrograde"
],
"type": "object"
},
"type": "array"
},
"flags": {
"items": {
"const": "outside-reference-span"
},
"maxItems": 1,
"type": "array"
}
},
"required": [
"atStart",
"atEnd",
"changes",
"flags"
],
"type": "object"
},
{
"description": "Retrograde on a day: the stations in the day.",
"properties": {
"atEnd": {
"description": "A body's longitude, sign, degree, speed and direction at one instant.",
"properties": {
"degree": {
"type": "number"
},
"lon": {
"type": "number"
},
"retrograde": {
"type": "boolean"
},
"sign": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
]
},
"speed": {
"type": "number"
}
},
"required": [
"lon",
"sign",
"degree",
"speed",
"retrograde"
],
"type": "object"
},
"atStart": {
"description": "A body's longitude, sign, degree, speed and direction at one instant.",
"properties": {
"degree": {
"type": "number"
},
"lon": {
"type": "number"
},
"retrograde": {
"type": "boolean"
},
"sign": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
]
},
"speed": {
"type": "number"
}
},
"required": [
"lon",
"sign",
"degree",
"speed",
"retrograde"
],
"type": "object"
},
"flags": {
"items": {
"const": "outside-reference-span"
},
"maxItems": 1,
"type": "array"
},
"stations": {
"items": {
"properties": {
"at": {
"format": "date-time",
"type": "string"
},
"type": {
"enum": [
"retrograde",
"direct"
]
}
},
"required": [
"at",
"type"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"atStart",
"atEnd",
"stations",
"flags"
],
"type": "object"
},
{
"description": "An ingress on a day.",
"properties": {
"flags": {
"items": {
"const": "outside-reference-span"
},
"maxItems": 1,
"type": "array"
},
"ingresses": {
"items": {
"properties": {
"at": {
"format": "date-time",
"type": "string"
},
"retrograde": {
"type": "boolean"
}
},
"required": [
"at",
"retrograde"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"ingresses",
"flags"
],
"type": "object"
},
{
"description": "A phase on a day.",
"properties": {
"flags": {
"items": {
"const": "outside-reference-span"
},
"maxItems": 1,
"type": "array"
},
"lunations": {
"items": {
"properties": {
"at": {
"format": "date-time",
"type": "string"
},
"degree": {
"type": "number"
},
"lon": {
"type": "number"
},
"sign": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
]
}
},
"required": [
"at",
"lon",
"sign",
"degree"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"lunations",
"flags"
],
"type": "object"
},
{
"allOf": [
{
"description": "The two bodies at one instant and the aspect between them.",
"properties": {
"body": {
"description": "A body's longitude, sign, degree, speed and direction at one instant.",
"properties": {
"degree": {
"type": "number"
},
"lon": {
"type": "number"
},
"retrograde": {
"type": "boolean"
},
"sign": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
]
},
"speed": {
"type": "number"
}
},
"required": [
"lon",
"sign",
"degree",
"speed",
"retrograde"
],
"type": "object"
},
"motion": {
"description": "applying while the orb shrinks, separating while it grows, judged from the two daily motions; stationary when the two move at the same speed.",
"enum": [
"applying",
"separating",
"stationary"
]
},
"orb": {
"description": "How far the separation is from the aspect's exact angle, in degrees.",
"minimum": 0,
"type": "number"
},
"other": {
"description": "A body's longitude, sign, degree, speed and direction at one instant.",
"properties": {
"degree": {
"type": "number"
},
"lon": {
"type": "number"
},
"retrograde": {
"type": "boolean"
},
"sign": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
]
},
"speed": {
"type": "number"
}
},
"required": [
"lon",
"sign",
"degree",
"speed",
"retrograde"
],
"type": "object"
},
"separation": {
"description": "The angle between the two longitudes, in degrees.",
"maximum": 180,
"minimum": 0,
"type": "number"
}
},
"required": [
"body",
"other",
"separation",
"orb",
"motion"
],
"type": "object"
},
{
"properties": {
"allowedOrb": {
"description": "The widest orb at which the aspect holds between these two bodies, in degrees: the wider one when the Sun or the Moon is one of them.",
"minimum": 0,
"type": "number"
},
"deltaT": {
"description": "ΔT = TT − UT1 in seconds, with its 1-sigma band and where it came from, as the engine reports it for a chart at the instant: iers-utc/1 from 1972 to the end of the engine's UT1 table, its model zodiacs-deltat/1 otherwise.",
"properties": {
"model": {
"enum": [
"iers-utc/1",
"zodiacs-deltat/1"
]
},
"seconds": {
"type": "number"
},
"segment": {
"enum": [
"long-term",
"reconstructed",
"observed",
"predicted",
"extrapolated"
]
},
"sigma": {
"type": "number"
},
"table": {
"type": "string"
},
"tableDigest": {
"type": "string"
}
},
"required": [
"seconds",
"sigma",
"model",
"table",
"tableDigest",
"segment"
],
"type": "object"
},
"flags": {
"items": {
"const": "outside-reference-span"
},
"maxItems": 1,
"type": "array"
},
"timeScale": {
"description": "How the engine read the instant, as a chart reports it. basis iers, from 1972 to the end of its UT1 table: TT is UTC plus the leap seconds and 32.184 s, and UT1 is UTC plus IERS UT1 − UTC. basis delta-t, otherwise: the instant is read as UT1, and TT is UT1 plus the ΔT model.",
"properties": {
"basis": {
"enum": [
"iers",
"delta-t"
]
},
"input": {
"const": "utc"
},
"leapSeconds": {
"anyOf": [
{
"description": "TAI − UTC in seconds from the IERS leap-second list; listed is false after the list expires and its last value is carried.",
"properties": {
"listed": {
"type": "boolean"
},
"taiMinusUtc": {
"type": "number"
}
},
"required": [
"taiMinusUtc",
"listed"
],
"type": "object"
},
{
"type": "null"
}
]
},
"ut1MinusUtc": {
"anyOf": [
{
"description": "UT1 − UTC in seconds as the engine used it, with its 1-sigma band and its source: observed or predicted by IERS, or fallback after the table ends; null before 1972.",
"properties": {
"seconds": {
"type": "number"
},
"sigma": {
"type": "number"
},
"source": {
"enum": [
"observed",
"predicted",
"fallback"
]
}
},
"required": [
"seconds",
"sigma",
"source"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"input",
"basis",
"ut1MinusUtc",
"leapSeconds"
],
"type": "object"
}
},
"required": [
"allowedOrb",
"deltaT",
"timeScale",
"flags"
],
"type": "object"
}
],
"description": "An aspect at an instant: true when the orb is within allowedOrb."
},
{
"description": "An aspect on a day: where it begins or ends in the day, and where it is exact.",
"properties": {
"allowedOrb": {
"description": "The widest orb at which the aspect holds between these two bodies, in degrees: the wider one when the Sun or the Moon is one of them.",
"minimum": 0,
"type": "number"
},
"atEnd": {
"description": "The two bodies at one instant and the aspect between them.",
"properties": {
"body": {
"description": "A body's longitude, sign, degree, speed and direction at one instant.",
"properties": {
"degree": {
"type": "number"
},
"lon": {
"type": "number"
},
"retrograde": {
"type": "boolean"
},
"sign": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
]
},
"speed": {
"type": "number"
}
},
"required": [
"lon",
"sign",
"degree",
"speed",
"retrograde"
],
"type": "object"
},
"motion": {
"description": "applying while the orb shrinks, separating while it grows, judged from the two daily motions; stationary when the two move at the same speed.",
"enum": [
"applying",
"separating",
"stationary"
]
},
"orb": {
"description": "How far the separation is from the aspect's exact angle, in degrees.",
"minimum": 0,
"type": "number"
},
"other": {
"description": "A body's longitude, sign, degree, speed and direction at one instant.",
"properties": {
"degree": {
"type": "number"
},
"lon": {
"type": "number"
},
"retrograde": {
"type": "boolean"
},
"sign": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
]
},
"speed": {
"type": "number"
}
},
"required": [
"lon",
"sign",
"degree",
"speed",
"retrograde"
],
"type": "object"
},
"separation": {
"description": "The angle between the two longitudes, in degrees.",
"maximum": 180,
"minimum": 0,
"type": "number"
}
},
"required": [
"body",
"other",
"separation",
"orb",
"motion"
],
"type": "object"
},
"atStart": {
"description": "The two bodies at one instant and the aspect between them.",
"properties": {
"body": {
"description": "A body's longitude, sign, degree, speed and direction at one instant.",
"properties": {
"degree": {
"type": "number"
},
"lon": {
"type": "number"
},
"retrograde": {
"type": "boolean"
},
"sign": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
]
},
"speed": {
"type": "number"
}
},
"required": [
"lon",
"sign",
"degree",
"speed",
"retrograde"
],
"type": "object"
},
"motion": {
"description": "applying while the orb shrinks, separating while it grows, judged from the two daily motions; stationary when the two move at the same speed.",
"enum": [
"applying",
"separating",
"stationary"
]
},
"orb": {
"description": "How far the separation is from the aspect's exact angle, in degrees.",
"minimum": 0,
"type": "number"
},
"other": {
"description": "A body's longitude, sign, degree, speed and direction at one instant.",
"properties": {
"degree": {
"type": "number"
},
"lon": {
"type": "number"
},
"retrograde": {
"type": "boolean"
},
"sign": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
]
},
"speed": {
"type": "number"
}
},
"required": [
"lon",
"sign",
"degree",
"speed",
"retrograde"
],
"type": "object"
},
"separation": {
"description": "The angle between the two longitudes, in degrees.",
"maximum": 180,
"minimum": 0,
"type": "number"
}
},
"required": [
"body",
"other",
"separation",
"orb",
"motion"
],
"type": "object"
},
"changes": {
"items": {
"properties": {
"at": {
"format": "date-time",
"type": "string"
},
"holds": {
"description": "Whether the aspect holds from this instant on: true where it begins, false where it ends.",
"type": "boolean"
}
},
"required": [
"at",
"holds"
],
"type": "object"
},
"type": "array"
},
"exact": {
"items": {
"properties": {
"at": {
"format": "date-time",
"type": "string"
},
"body": {
"description": "A longitude, with its sign and the degree within it.",
"properties": {
"degree": {
"type": "number"
},
"lon": {
"type": "number"
},
"sign": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
]
}
},
"required": [
"lon",
"sign",
"degree"
],
"type": "object"
},
"other": {
"description": "A longitude, with its sign and the degree within it.",
"properties": {
"degree": {
"type": "number"
},
"lon": {
"type": "number"
},
"sign": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
]
}
},
"required": [
"lon",
"sign",
"degree"
],
"type": "object"
}
},
"required": [
"at",
"body",
"other"
],
"type": "object"
},
"type": "array"
},
"flags": {
"items": {
"const": "outside-reference-span"
},
"maxItems": 1,
"type": "array"
}
},
"required": [
"atStart",
"atEnd",
"allowedOrb",
"changes",
"exact",
"flags"
],
"type": "object"
}
]
},
"instant": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
]
},
"window": {
"anyOf": [
{
"description": "The day read: from its start (included) to its end (excluded).",
"properties": {
"from": {
"format": "date-time",
"type": "string"
},
"to": {
"format": "date-time",
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
{
"type": "null"
}
]
},
"zone": {
"anyOf": [
{
"description": "The two midnights of a day read in a zone.",
"properties": {
"end": {
"allOf": [
{
"description": "How a local time was read: the offset applied, the resolver's flags, the birthplace's own mean time if it was used, and which zone history gave the offset.",
"properties": {
"flags": {
"items": {
"enum": [
"dst-gap",
"dst-fold",
"lmt"
]
},
"type": "array"
},
"localMeanTime": {
"anyOf": [
{
"properties": {
"longitude": {
"type": "number"
},
"zoneOffsetMinutes": {
"type": "number"
}
},
"required": [
"longitude",
"zoneOffsetMinutes"
],
"type": "object"
},
{
"type": "null"
}
]
},
"offsetMinutes": {
"description": "Minutes east of UTC; fractional before standard time.",
"type": "number"
},
"zoneHistory": {
"enum": [
"pinned",
"runtime"
]
},
"zoneUncertain": {
"type": "boolean"
}
},
"required": [
"offsetMinutes",
"flags",
"localMeanTime",
"zoneHistory",
"zoneUncertain"
],
"type": "object"
},
{
"properties": {
"utc": {
"format": "date-time",
"type": "string"
}
},
"required": [
"utc"
],
"type": "object"
}
],
"description": "A midnight of the day in its zone: the instant, and how the local time was read."
},
"start": {
"allOf": [
{
"description": "How a local time was read: the offset applied, the resolver's flags, the birthplace's own mean time if it was used, and which zone history gave the offset.",
"properties": {
"flags": {
"items": {
"enum": [
"dst-gap",
"dst-fold",
"lmt"
]
},
"type": "array"
},
"localMeanTime": {
"anyOf": [
{
"properties": {
"longitude": {
"type": "number"
},
"zoneOffsetMinutes": {
"type": "number"
}
},
"required": [
"longitude",
"zoneOffsetMinutes"
],
"type": "object"
},
{
"type": "null"
}
]
},
"offsetMinutes": {
"description": "Minutes east of UTC; fractional before standard time.",
"type": "number"
},
"zoneHistory": {
"enum": [
"pinned",
"runtime"
]
},
"zoneUncertain": {
"type": "boolean"
}
},
"required": [
"offsetMinutes",
"flags",
"localMeanTime",
"zoneHistory",
"zoneUncertain"
],
"type": "object"
},
{
"properties": {
"utc": {
"format": "date-time",
"type": "string"
}
},
"required": [
"utc"
],
"type": "object"
}
],
"description": "A midnight of the day in its zone: the instant, and how the local time was read."
}
},
"required": [
"start",
"end"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"answer",
"basis",
"fact",
"instant",
"window",
"zone",
"facts"
],
"type": "object"
},
"schema": {
"type": "string"
}
},
"required": [
"schema",
"result",
"receipt",
"backend",
"cite"
],
"type": "object"
},
"interpretation": {
"const": "The verdict checks an astronomical proposition, not an astrological prediction.",
"type": "string"
}
},
"required": [
"answer",
"calculation",
"interpretation"
],
"type": "object"
},
"links": {
"items": {
"additionalProperties": false,
"properties": {
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"ok": {
"const": true,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"const": "check_sky_fact",
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"data",
"links"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryAfterSeconds": {
"type": "number"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"ok": {
"const": false,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"enum": [
"get_capabilities",
"get_sky",
"get_upcoming_events",
"check_sky_fact",
"get_horoscope",
"open_chart_studio",
"get_occasion_sky",
"get_life_milestones",
"get_compatibility",
"find_chart_twins",
"get_famous_chart",
"get_birthday",
"get_sky_calendar"
],
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "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. Two people with birth dates belong to get_compatibility, which compares their charts as partners, friends, family or colleagues; this tool takes two Sun signs with no birth dates. The sign of a calendar date belongs to get_birthday. 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. A guarantee about a relationship or anything else, a reading for a named child under 13, and a stock or lottery pick, an investment call, a bet, or an election or health forecast are not requests for this tool, not even as a first step: Zodiacs does not do these, and no explainer is fetched for them.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"topic": {
"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.",
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"topic"
],
"type": "object"
},
"name": "explain_astrology",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"found": {
"type": "boolean"
},
"message": {
"type": [
"string",
"null"
]
},
"note": {
"const": "An introduction to how astrology reads these ideas, not a claim that they determine anything.",
"type": "string"
},
"pages": {
"items": {
"additionalProperties": false,
"properties": {
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"paragraphs": {
"items": {
"type": "string"
},
"type": "array"
},
"query": {
"type": "string"
},
"related": {
"items": {
"type": "string"
},
"type": "array"
},
"terms": {
"items": {
"additionalProperties": false,
"properties": {
"definition": {
"type": "string"
},
"term": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"term",
"definition",
"url"
],
"type": "object"
},
"type": "array"
},
"title": {
"type": [
"string",
"null"
]
},
"topic": {
"type": [
"string",
"null"
]
},
"topics": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"found",
"query",
"topic",
"title",
"paragraphs",
"terms",
"pages",
"related",
"topics",
"message",
"note"
],
"type": "object"
},
"links": {
"items": {
"additionalProperties": false,
"properties": {
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"ok": {
"const": true,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"const": "explain_astrology",
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"data",
"links"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryAfterSeconds": {
"type": "number"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"ok": {
"const": false,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"enum": [
"get_natal_chart",
"get_horoscope_period",
"get_chinese_zodiac",
"get_personal_transits",
"explain_astrology"
],
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"country": {
"description": "Optional country when several places share the name, such as United Kingdom or Kazakhstan.",
"maxLength": 60,
"minLength": 2,
"type": "string"
},
"date": {
"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.",
"pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
"type": "string"
},
"place": {
"description": "A town or city name, such as London or Almaty. Not a street address. Nothing is stored.",
"maxLength": 80,
"minLength": 2,
"type": "string"
}
},
"required": [
"place"
],
"type": "object"
},
"name": "find_birthplace",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"country": {
"type": [
"string",
"null"
]
},
"date": {
"type": "string"
},
"message": {
"type": [
"string",
"null"
]
},
"place": {
"type": "string"
},
"places": {
"items": {
"additionalProperties": false,
"properties": {
"country": {
"type": "string"
},
"latitude": {
"type": "number"
},
"longitude": {
"type": "number"
},
"name": {
"type": "string"
},
"offset": {
"type": "string"
},
"offsetMinutes": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"region": {
"type": "string"
},
"timeZone": {
"type": "string"
}
},
"required": [
"name",
"region",
"country",
"latitude",
"longitude",
"timeZone",
"offset",
"offsetMinutes"
],
"type": "object"
},
"maxItems": 5,
"type": "array"
},
"source": {
"additionalProperties": false,
"properties": {
"licence": {
"const": "CC BY 4.0",
"type": "string"
},
"name": {
"const": "GeoNames cities15000",
"type": "string"
},
"note": {
"type": "string"
}
},
"required": [
"name",
"licence",
"note"
],
"type": "object"
}
},
"required": [
"place",
"country",
"date",
"places",
"message",
"source"
],
"type": "object"
},
"links": {
"items": {
"additionalProperties": false,
"properties": {
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"ok": {
"const": true,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"const": "find_birthplace",
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"data",
"links"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryAfterSeconds": {
"type": "number"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"ok": {
"const": false,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"enum": [
"find_birthplace"
],
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"birthDate": {
"description": "The birth date, such as 1997-03-15.",
"pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
"type": "string"
},
"latitude": {
"description": "The birthplace's latitude, if known. Give it with longitude.",
"maximum": 90,
"minimum": -90,
"type": "number"
},
"longitude": {
"description": "The birthplace's longitude, if known, for birth times before standard time.",
"maximum": 180,
"minimum": -180,
"type": "number"
},
"time": {
"description": "The birth time on the local clock, if known. Needs zone. Without it only the Sun is compared.",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
"type": "string"
},
"zone": {
"description": "The birthplace's time zone, such as Europe/London. Needed with a time.",
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
"type": "string"
}
},
"required": [
"birthDate"
],
"type": "object"
},
"name": "find_chart_twins",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"birthDate": {
"type": "string"
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"pageUrl": {
"format": "uri",
"type": "string"
},
"shareUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"timeKnown": {
"type": "boolean"
},
"total": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"twins": {
"items": {
"additionalProperties": false,
"properties": {
"born": {
"type": "string"
},
"name": {
"type": "string"
},
"shares": {
"enum": [
"sun",
"moon",
"sun-and-moon"
],
"type": "string"
},
"shortDescription": {
"type": "string"
},
"slug": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"name",
"slug",
"shortDescription",
"born",
"shares",
"url"
],
"type": "object"
},
"maxItems": 12,
"type": "array"
},
"you": {
"additionalProperties": false,
"properties": {
"moon": {
"anyOf": [
{
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
},
{
"type": "null"
}
]
},
"sun": {
"anyOf": [
{
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"sun",
"moon"
],
"type": "object"
}
},
"required": [
"birthDate",
"timeKnown",
"you",
"twins",
"total",
"notes",
"pageUrl",
"shareUrl"
],
"type": "object"
},
"links": {
"items": {
"additionalProperties": false,
"properties": {
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"ok": {
"const": true,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"const": "find_chart_twins",
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"data",
"links"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryAfterSeconds": {
"type": "number"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"ok": {
"const": false,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"enum": [
"get_capabilities",
"get_sky",
"get_upcoming_events",
"check_sky_fact",
"get_horoscope",
"open_chart_studio",
"get_occasion_sky",
"get_life_milestones",
"get_compatibility",
"find_chart_twins",
"get_famous_chart",
"get_birthday",
"get_sky_calendar"
],
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"birthDate": {
"description": "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.",
"pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
"type": "string"
},
"date": {
"description": "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.",
"pattern": "^\\d{2}-\\d{2}$",
"type": "string"
},
"longitude": {
"description": "Use only for historical birth dates when the birthplace used local mean time, to convert its clock to UTC. Needs zone. Do not request coordinates for modern birthdays.",
"maximum": 180,
"minimum": -180,
"type": "number"
},
"time": {
"description": "The birth time on the local clock, if known. Needs zone.",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
"type": "string"
},
"year": {
"description": "The year of the solar return. Defaults to the current year. Needs birthDate.",
"maximum": 2199,
"minimum": 1801,
"type": "integer"
},
"zone": {
"description": "The birthplace's time zone, such as Europe/London.",
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
"type": "string"
}
},
"type": "object"
},
"name": "get_birthday",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"boundary": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"nearestDegrees": {
"type": "number"
},
"text": {
"type": "string"
}
},
"required": [
"nearestDegrees",
"text"
],
"type": "object"
},
{
"type": "null"
}
]
},
"cusp": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"ingressUtcRange": {
"anyOf": [
{
"items": {
"type": "string"
},
"maxItems": 2,
"minItems": 2,
"type": "array"
},
{
"type": "null"
}
]
},
"reading": {
"anyOf": [
{
"anyOf": [
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "whole",
"type": "string"
},
"sign": {
"type": "string"
},
"text": {
"type": "string"
},
"year": {
"type": "number"
}
},
"required": [
"year",
"kind",
"sign",
"text"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"after": {
"type": "string"
},
"atUtc": {
"type": "string"
},
"before": {
"type": "string"
},
"kind": {
"const": "split",
"type": "string"
},
"text": {
"type": "string"
},
"year": {
"type": "number"
}
},
"required": [
"year",
"kind",
"before",
"after",
"atUtc",
"text"
],
"type": "object"
}
]
},
{
"type": "null"
}
]
},
"signs": {
"items": {
"type": "string"
},
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"splitYears": {
"type": "number"
},
"summary": {
"type": "string"
},
"wholeDayYears": {
"additionalProperties": false,
"properties": {
"first": {
"type": "number"
},
"second": {
"type": "number"
}
},
"required": [
"first",
"second"
],
"type": "object"
}
},
"required": [
"signs",
"wholeDayYears",
"splitYears",
"ingressUtcRange",
"summary",
"reading"
],
"type": "object"
},
{
"type": "null"
}
]
},
"day": {
"maximum": 31,
"minimum": 1,
"type": "integer"
},
"decan": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"first": {
"maximum": 3,
"minimum": 1,
"type": "integer"
},
"last": {
"maximum": 3,
"minimum": 1,
"type": "integer"
},
"rulers": {
"items": {
"type": "string"
},
"maxItems": 2,
"minItems": 1,
"type": "array"
},
"text": {
"type": "string"
}
},
"required": [
"first",
"last",
"rulers",
"text"
],
"type": "object"
},
{
"type": "null"
}
]
},
"famous": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"more": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"people": {
"items": {
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"name",
"url"
],
"type": "object"
},
"maxItems": 3,
"minItems": 1,
"type": "array"
}
},
"required": [
"people",
"more"
],
"type": "object"
},
{
"type": "null"
}
]
},
"label": {
"type": "string"
},
"month": {
"maximum": 12,
"minimum": 1,
"type": "integer"
},
"note": {
"const": "Facts about the Sun on this date and their traditional meanings.",
"type": "string"
},
"pageUrl": {
"format": "uri",
"type": "string"
},
"shareUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"sign": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"dates": {
"type": "string"
},
"element": {
"type": "string"
},
"meaning": {
"type": "string"
},
"modality": {
"type": "string"
},
"name": {
"type": "string"
},
"ruler": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"slug",
"name",
"element",
"modality",
"ruler",
"dates",
"meaning"
],
"type": "object"
},
{
"type": "null"
}
]
},
"signFrom": {
"anyOf": [
{
"enum": [
"date",
"birth-year",
"birth-time"
],
"type": "string"
},
{
"type": "null"
}
]
},
"solarReturn": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"instant": {
"additionalProperties": false,
"properties": {
"local": {
"type": "string"
},
"utc": {
"type": "string"
}
},
"required": [
"utc",
"local"
],
"type": "object"
},
"note": {
"type": "string"
},
"range": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"earliest": {
"additionalProperties": false,
"properties": {
"local": {
"type": "string"
},
"utc": {
"type": "string"
}
},
"required": [
"utc",
"local"
],
"type": "object"
},
"latest": {
"additionalProperties": false,
"properties": {
"local": {
"type": "string"
},
"utc": {
"type": "string"
}
},
"required": [
"utc",
"local"
],
"type": "object"
}
},
"required": [
"earliest",
"latest"
],
"type": "object"
},
{
"type": "null"
}
]
},
"timeKnown": {
"type": "boolean"
},
"year": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"year",
"instant",
"timeKnown",
"range",
"note"
],
"type": "object"
},
{
"type": "null"
}
]
},
"sunAtBirth": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"longitude": {
"type": "number"
},
"position": {
"type": "string"
},
"timeKnown": {
"type": "boolean"
}
},
"required": [
"longitude",
"position",
"timeKnown"
],
"type": "object"
},
{
"type": "null"
}
]
},
"sunSpan": {
"additionalProperties": false,
"properties": {
"from": {
"type": "string"
},
"text": {
"type": "string"
},
"to": {
"type": "string"
},
"years": {
"type": "string"
}
},
"required": [
"from",
"to",
"years",
"text"
],
"type": "object"
}
},
"required": [
"month",
"day",
"label",
"sunSpan",
"sign",
"signFrom",
"boundary",
"cusp",
"decan",
"sunAtBirth",
"famous",
"pageUrl",
"shareUrl",
"solarReturn",
"note"
],
"type": "object"
},
"links": {
"items": {
"additionalProperties": false,
"properties": {
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"ok": {
"const": true,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"const": "get_birthday",
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"data",
"links"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryAfterSeconds": {
"type": "number"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"ok": {
"const": false,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"enum": [
"get_capabilities",
"get_sky",
"get_upcoming_events",
"check_sky_fact",
"get_horoscope",
"open_chart_studio",
"get_occasion_sky",
"get_life_milestones",
"get_compatibility",
"find_chart_twins",
"get_famous_chart",
"get_birthday",
"get_sky_calendar"
],
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "get_capabilities",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"conventions": {
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"coverage": {
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"engine": {
"properties": {
"ephemeris": {
"properties": {
"name": {
"const": "astronomy-engine"
},
"version": {
"type": "string"
}
},
"required": [
"name",
"version"
],
"type": "object"
},
"name": {
"const": "@zodiacs/engine"
},
"version": {
"type": "string"
}
},
"required": [
"name",
"version",
"ephemeris"
],
"type": "object"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"limits": {
"additionalProperties": false,
"properties": {
"eventKinds": {
"items": {
"enum": [
"ingress",
"station",
"lunation"
],
"type": "string"
},
"type": "array"
},
"eventWindowDays": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"factSamples": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"from": {
"type": "string"
},
"samples": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"to": {
"type": "string"
}
},
"required": [
"from",
"to",
"eventWindowDays",
"eventKinds",
"samples",
"factSamples"
],
"type": "object"
},
"name": {
"const": "Zodiacs",
"type": "string"
},
"privacy": {
"type": "string"
},
"tools": {
"items": {
"enum": [
"get_capabilities",
"get_sky",
"get_upcoming_events",
"check_sky_fact",
"get_horoscope",
"open_chart_studio",
"get_occasion_sky",
"get_life_milestones",
"get_compatibility",
"find_chart_twins",
"get_famous_chart",
"get_birthday",
"get_sky_calendar"
],
"type": "string"
},
"type": "array"
},
"version": {
"type": "string"
}
},
"required": [
"name",
"version",
"engine",
"tools",
"limits",
"conventions",
"coverage",
"privacy",
"limitations"
],
"type": "object"
},
"links": {
"items": {
"additionalProperties": false,
"properties": {
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"ok": {
"const": true,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"const": "get_capabilities",
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"data",
"links"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryAfterSeconds": {
"type": "number"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"ok": {
"const": false,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"enum": [
"get_capabilities",
"get_sky",
"get_upcoming_events",
"check_sky_fact",
"get_horoscope",
"open_chart_studio",
"get_occasion_sky",
"get_life_milestones",
"get_compatibility",
"find_chart_twins",
"get_famous_chart",
"get_birthday",
"get_sky_calendar"
],
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"birthDate": {
"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.",
"pattern": "^(?:19|20|21)\\d{2}-\\d{2}-\\d{2}$",
"type": "string"
},
"year": {
"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.",
"maximum": 2100,
"minimum": 1901,
"type": "integer"
},
"zone": {
"description": "The person's time zone, such as Asia/Singapore, so the current year is worked out for their own date. Without it, UTC.",
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
"type": "string"
}
},
"type": "object"
},
"name": "get_chinese_zodiac",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"birthDate": {
"type": [
"string",
"null"
]
},
"boundary": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"beforeNewYear": {
"type": [
"boolean",
"null"
]
},
"earlierAnimal": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"pageUrl": {
"format": "uri",
"type": "string"
},
"slug": {
"enum": [
"rat",
"ox",
"tiger",
"rabbit",
"dragon",
"snake",
"horse",
"goat",
"monkey",
"rooster",
"dog",
"pig"
],
"type": "string"
}
},
"required": [
"slug",
"name",
"pageUrl"
],
"type": "object"
},
{
"type": "null"
}
]
},
"lunarNewYear": {
"type": "string"
},
"text": {
"type": "string"
}
},
"required": [
"lunarNewYear",
"beforeNewYear",
"earlierAnimal",
"text"
],
"type": "object"
},
{
"type": "null"
}
]
},
"current": {
"additionalProperties": false,
"properties": {
"animal": {
"additionalProperties": false,
"properties": {
"branch": {
"type": "string"
},
"branchPinyin": {
"type": "string"
},
"name": {
"type": "string"
},
"pageUrl": {
"format": "uri",
"type": "string"
},
"position": {
"maximum": 12,
"minimum": 1,
"type": "integer"
},
"slug": {
"enum": [
"rat",
"ox",
"tiger",
"rabbit",
"dragon",
"snake",
"horse",
"goat",
"monkey",
"rooster",
"dog",
"pig"
],
"type": "string"
}
},
"required": [
"slug",
"name",
"pageUrl",
"branch",
"branchPinyin",
"position"
],
"type": "object"
},
"element": {
"enum": [
"wood",
"fire",
"earth",
"metal",
"water"
],
"type": "string"
},
"ends": {
"type": "string"
},
"label": {
"type": "string"
},
"starts": {
"type": "string"
},
"stemBranch": {
"type": "string"
},
"year": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"yinYang": {
"enum": [
"yin",
"yang"
],
"type": "string"
}
},
"required": [
"year",
"animal",
"element",
"yinYang",
"stemBranch",
"label",
"starts",
"ends"
],
"type": "object"
},
"from": {
"enum": [
"birth-date",
"year",
"today"
],
"type": "string"
},
"guideUrl": {
"format": "uri",
"type": "string"
},
"note": {
"const": "Traditional associations of the Chinese calendar, for reflection: not a personality test or a prediction.",
"type": "string"
},
"person": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"animal": {
"additionalProperties": false,
"properties": {
"branch": {
"type": "string"
},
"branchPinyin": {
"type": "string"
},
"name": {
"type": "string"
},
"pageUrl": {
"format": "uri",
"type": "string"
},
"position": {
"maximum": 12,
"minimum": 1,
"type": "integer"
},
"slug": {
"enum": [
"rat",
"ox",
"tiger",
"rabbit",
"dragon",
"snake",
"horse",
"goat",
"monkey",
"rooster",
"dog",
"pig"
],
"type": "string"
}
},
"required": [
"slug",
"name",
"pageUrl",
"branch",
"branchPinyin",
"position"
],
"type": "object"
},
"association": {
"type": "string"
},
"context": {
"type": "string"
},
"element": {
"enum": [
"wood",
"fire",
"earth",
"metal",
"water"
],
"type": "string"
},
"ends": {
"type": "string"
},
"label": {
"type": "string"
},
"pairings": {
"additionalProperties": false,
"properties": {
"harmony": {
"items": {
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"pageUrl": {
"format": "uri",
"type": "string"
},
"slug": {
"enum": [
"rat",
"ox",
"tiger",
"rabbit",
"dragon",
"snake",
"horse",
"goat",
"monkey",
"rooster",
"dog",
"pig"
],
"type": "string"
}
},
"required": [
"slug",
"name",
"pageUrl"
],
"type": "object"
},
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"opposite": {
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"pageUrl": {
"format": "uri",
"type": "string"
},
"slug": {
"enum": [
"rat",
"ox",
"tiger",
"rabbit",
"dragon",
"snake",
"horse",
"goat",
"monkey",
"rooster",
"dog",
"pig"
],
"type": "string"
}
},
"required": [
"slug",
"name",
"pageUrl"
],
"type": "object"
},
"partner": {
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"pageUrl": {
"format": "uri",
"type": "string"
},
"slug": {
"enum": [
"rat",
"ox",
"tiger",
"rabbit",
"dragon",
"snake",
"horse",
"goat",
"monkey",
"rooster",
"dog",
"pig"
],
"type": "string"
}
},
"required": [
"slug",
"name",
"pageUrl"
],
"type": "object"
},
"text": {
"type": "string"
}
},
"required": [
"harmony",
"partner",
"opposite",
"text"
],
"type": "object"
},
"starts": {
"type": "string"
},
"stemBranch": {
"type": "string"
},
"year": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"yinYang": {
"enum": [
"yin",
"yang"
],
"type": "string"
}
},
"required": [
"year",
"animal",
"element",
"yinYang",
"stemBranch",
"label",
"starts",
"ends",
"association",
"context",
"pairings"
],
"type": "object"
},
{
"type": "null"
}
]
},
"today": {
"type": "string"
},
"zone": {
"type": "string"
},
"zoneNote": {
"type": [
"string",
"null"
]
}
},
"required": [
"from",
"birthDate",
"person",
"boundary",
"current",
"today",
"zone",
"zoneNote",
"guideUrl",
"note"
],
"type": "object"
},
"links": {
"items": {
"additionalProperties": false,
"properties": {
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"ok": {
"const": true,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"const": "get_chinese_zodiac",
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"data",
"links"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryAfterSeconds": {
"type": "number"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"ok": {
"const": false,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"enum": [
"get_natal_chart",
"get_horoscope_period",
"get_chinese_zodiac",
"get_personal_transits",
"explain_astrology"
],
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"a": {
"additionalProperties": false,
"description": "The first person.",
"properties": {
"birthDate": {
"description": "The birth date, such as 1994-08-21 (years 1800–2199). Needed unless famous is given.",
"pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
"type": "string"
},
"famous": {
"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.",
"maxLength": 80,
"minLength": 1,
"pattern": "^[^\\u0000-\\u001f\\u007f<>{}[\\]\\\\`]+$",
"type": "string"
},
"latitude": {
"description": "Optional. The birthplace's latitude; with a birth time it adds the rising sign. Give it with longitude and zone. Nothing is stored.",
"maximum": 90,
"minimum": -90,
"type": "number"
},
"longitude": {
"description": "Optional. The birthplace's longitude, with latitude. Nothing is stored.",
"maximum": 180,
"minimum": -180,
"type": "number"
},
"name": {
"description": "Optional first name to show on the card, only if the person wants one. Display only, not stored.",
"maxLength": 40,
"minLength": 1,
"pattern": "^[^\\u0000-\\u001f\\u007f<>{}[\\]\\\\`]+$",
"type": "string"
},
"place": {
"description": "Optional birthplace name, such as Madrid, Spain. Display only, not stored.",
"maxLength": 80,
"minLength": 1,
"pattern": "^[^\\u0000-\\u001f\\u007f<>{}[\\]\\\\`]+$",
"type": "string"
},
"time": {
"description": "The birth time on the local clock, if known. Needs zone.",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
"type": "string"
},
"zone": {
"description": "The birthplace's time zone, such as Europe/Madrid. Needed with a time or a place.",
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
"type": "string"
}
},
"type": "object"
},
"b": {
"additionalProperties": false,
"description": "The second person, or { famous: \"<name>\" } for a famous person Zodiacs publishes.",
"properties": {
"birthDate": {
"description": "The birth date, such as 1994-08-21 (years 1800–2199). Needed unless famous is given.",
"pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
"type": "string"
},
"famous": {
"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.",
"maxLength": 80,
"minLength": 1,
"pattern": "^[^\\u0000-\\u001f\\u007f<>{}[\\]\\\\`]+$",
"type": "string"
},
"latitude": {
"description": "Optional. The birthplace's latitude; with a birth time it adds the rising sign. Give it with longitude and zone. Nothing is stored.",
"maximum": 90,
"minimum": -90,
"type": "number"
},
"longitude": {
"description": "Optional. The birthplace's longitude, with latitude. Nothing is stored.",
"maximum": 180,
"minimum": -180,
"type": "number"
},
"name": {
"description": "Optional first name to show on the card, only if the person wants one. Display only, not stored.",
"maxLength": 40,
"minLength": 1,
"pattern": "^[^\\u0000-\\u001f\\u007f<>{}[\\]\\\\`]+$",
"type": "string"
},
"place": {
"description": "Optional birthplace name, such as Madrid, Spain. Display only, not stored.",
"maxLength": 80,
"minLength": 1,
"pattern": "^[^\\u0000-\\u001f\\u007f<>{}[\\]\\\\`]+$",
"type": "string"
},
"time": {
"description": "The birth time on the local clock, if known. Needs zone.",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
"type": "string"
},
"zone": {
"description": "The birthplace's time zone, such as Europe/Madrid. Needed with a time or a place.",
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
"type": "string"
}
},
"type": "object"
}
},
"required": [
"a",
"b"
],
"type": "object"
},
"name": "get_compatibility",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"additionalProperties": false,
"properties": {
"data": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"a": {
"additionalProperties": false,
"properties": {
"birthDate": {
"type": "string"
},
"famous": {
"type": "boolean"
},
"label": {
"type": "string"
},
"moon": {
"anyOf": [
{
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"type": [
"string",
"null"
]
},
"place": {
"type": [
"string",
"null"
]
},
"placed": {
"type": "boolean"
},
"rising": {
"anyOf": [
{
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
},
{
"type": "null"
}
]
},
"sun": {
"anyOf": [
{
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
},
{
"type": "null"
}
]
},
"timeKnown": {
"type": "boolean"
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"name",
"label",
"birthDate",
"timeKnown",
"placed",
"place",
"sun",
"moon",
"rising",
"famous",
"url"
],
"type": "object"
},
"b": {
"additionalProperties": false,
"properties": {
"birthDate": {
"type": "string"
},
"famous": {
"type": "boolean"
},
"label": {
"type": "string"
},
"moon": {
"anyOf": [
{
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"type": [
"string",
"null"
]
},
"place": {
"type": [
"string",
"null"
]
},
"placed": {
"type": "boolean"
},
"rising": {
"anyOf": [
{
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
},
{
"type": "null"
}
]
},
"sun": {
"anyOf": [
{
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
},
{
"type": "null"
}
]
},
"timeKnown": {
"type": "boolean"
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"name",
"label",
"birthDate",
"timeKnown",
"placed",
"place",
"sun",
"moon",
"rising",
"famous",
"url"
],
"type": "object"
},
"cardUrl": {
"type": [
"string",
"null"
]
},
"contacts": {
"items": {
"additionalProperties": false,
"properties": {
"aBody": {
"enum": [
"Sun",
"Moon",
"Mercury",
"Venus",
"Mars",
"Jupiter",
"Saturn",
"Uranus",
"Neptune",
"Pluto"
],
"type": "string"
},
"aspect": {
"enum": [
"conjunction",
"sextile",
"square",
"trine",
"opposition"
],
"type": "string"
},
"bBody": {
"enum": [
"Sun",
"Moon",
"Mercury",
"Venus",
"Mars",
"Jupiter",
"Saturn",
"Uranus",
"Neptune",
"Pluto"
],
"type": "string"
},
"generational": {
"type": "boolean"
},
"line": {
"type": "string"
},
"orb": {
"minimum": 0,
"type": "number"
}
},
"required": [
"aBody",
"bBody",
"aspect",
"orb",
"generational",
"line"
],
"type": "object"
},
"maxItems": 8,
"type": "array"
},
"counts": {
"additionalProperties": false,
"properties": {
"byAspect": {
"additionalProperties": false,
"properties": {
"conjunction": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"opposition": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"sextile": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"square": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"trine": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"conjunction",
"sextile",
"square",
"trine",
"opposition"
],
"type": "object"
},
"charged": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"easeful": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"total": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"easeful",
"charged",
"total",
"byAspect"
],
"type": "object"
},
"elements": {
"additionalProperties": false,
"properties": {
"a": {
"additionalProperties": false,
"properties": {
"air": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"earth": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"fire": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"water": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"fire",
"earth",
"air",
"water"
],
"type": "object"
},
"b": {
"additionalProperties": false,
"properties": {
"air": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"earth": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"fire": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"water": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"fire",
"earth",
"air",
"water"
],
"type": "object"
}
},
"required": [
"a",
"b"
],
"type": "object"
},
"modalities": {
"additionalProperties": false,
"properties": {
"a": {
"additionalProperties": false,
"properties": {
"cardinal": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"fixed": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"mutable": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"cardinal",
"fixed",
"mutable"
],
"type": "object"
},
"b": {
"additionalProperties": false,
"properties": {
"cardinal": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"fixed": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"mutable": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"cardinal",
"fixed",
"mutable"
],
"type": "object"
}
},
"required": [
"a",
"b"
],
"type": "object"
},
"note": {
"const": "Astrology’s reading of your two charts, for insight and fun, not a guarantee of how things will turn out.",
"type": "string"
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"pageUrl": {
"type": [
"string",
"null"
]
},
"score": {
"additionalProperties": false,
"properties": {
"areas": {
"additionalProperties": false,
"properties": {
"attraction": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"communication": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"stability": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"attraction",
"communication",
"stability"
],
"type": "object"
},
"headline": {
"type": "string"
},
"overall": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"verdict": {
"type": "string"
}
},
"required": [
"overall",
"areas",
"verdict",
"headline"
],
"type": "object"
},
"shareUrl": {
"type": [
"string",
"null"
]
},
"signPair": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"element": {
"additionalProperties": false,
"properties": {
"label": {
"type": "string"
},
"note": {
"type": "string"
}
},
"required": [
"label",
"note"
],
"type": "object"
},
"modality": {
"additionalProperties": false,
"properties": {
"label": {
"type": "string"
},
"note": {
"type": "string"
}
},
"required": [
"label",
"note"
],
"type": "object"
},
"polarity": {
"type": "string"
},
"same": {
"type": "boolean"
},
"signs": {
"items": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
},
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"slug": {
"type": "string"
}
},
"required": [
"slug",
"signs",
"same",
"element",
"modality",
"polarity"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"a",
"b",
"score",
"signPair",
"contacts",
"counts",
"elements",
"modalities",
"pageUrl",
"cardUrl",
"shareUrl",
"notes",
"note"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"directoryUrl": {
"type": "string"
},
"found": {
"const": false,
"type": "boolean"
},
"note": {
"const": "Zodiacs has no chart for this name in its famous-people directory.",
"type": "string"
},
"query": {
"type": "string"
},
"side": {
"enum": [
"a",
"b"
],
"type": "string"
}
},
"required": [
"found",
"side",
"query",
"directoryUrl",
"note"
],
"type": "object"
}
]
},
"links": {
"items": {
"additionalProperties": false,
"properties": {
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"ok": {
"const": true,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"const": "get_compatibility",
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"data",
"links"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryAfterSeconds": {
"type": "number"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"ok": {
"const": false,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"enum": [
"get_capabilities",
"get_sky",
"get_upcoming_events",
"check_sky_fact",
"get_horoscope",
"open_chart_studio",
"get_occasion_sky",
"get_life_milestones",
"get_compatibility",
"find_chart_twins",
"get_famous_chart",
"get_birthday",
"get_sky_calendar"
],
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"name": {
"description": "The person's name, such as Ada Lovelace.",
"maxLength": 80,
"minLength": 2,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "get_famous_chart",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"additionalProperties": false,
"properties": {
"data": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"alsoMatched": {
"items": {
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"name",
"slug",
"url"
],
"type": "object"
},
"maxItems": 4,
"type": "array"
},
"found": {
"const": true,
"type": "boolean"
},
"note": {
"type": "string"
},
"person": {
"additionalProperties": false,
"properties": {
"birthdayUrl": {
"format": "uri",
"type": "string"
},
"birthplace": {
"type": "string"
},
"born": {
"type": "string"
},
"lede": {
"type": "string"
},
"moon": {
"additionalProperties": false,
"properties": {
"degree": {
"type": [
"number",
"null"
]
},
"sign": {
"anyOf": [
{
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"sign",
"degree"
],
"type": "object"
},
"name": {
"type": "string"
},
"placements": {
"items": {
"additionalProperties": false,
"properties": {
"body": {
"enum": [
"Sun",
"Moon",
"Mercury",
"Venus",
"Mars",
"Jupiter",
"Saturn",
"Uranus",
"Neptune",
"Pluto"
],
"type": "string"
},
"degree": {
"type": "number"
},
"settled": {
"type": "boolean"
},
"sign": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
}
},
"required": [
"body",
"sign",
"degree",
"settled"
],
"type": "object"
},
"maxItems": 10,
"minItems": 10,
"type": "array"
},
"shortDescription": {
"type": "string"
},
"slug": {
"type": "string"
},
"sun": {
"additionalProperties": false,
"properties": {
"degree": {
"type": "number"
},
"sign": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
}
},
"required": [
"sign",
"degree"
],
"type": "object"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"name",
"slug",
"shortDescription",
"born",
"birthplace",
"sun",
"moon",
"placements",
"lede",
"url",
"birthdayUrl"
],
"type": "object"
},
"shareUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"found",
"person",
"alsoMatched",
"note",
"shareUrl"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"directoryUrl": {
"format": "uri",
"type": "string"
},
"found": {
"const": false,
"type": "boolean"
},
"note": {
"type": "string"
},
"query": {
"type": "string"
},
"suggestions": {
"items": {
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"name",
"slug",
"url"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"found",
"query",
"suggestions",
"directoryUrl",
"note"
],
"type": "object"
}
]
},
"links": {
"items": {
"additionalProperties": false,
"properties": {
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"ok": {
"const": true,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"const": "get_famous_chart",
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"data",
"links"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryAfterSeconds": {
"type": "number"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"ok": {
"const": false,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"enum": [
"get_capabilities",
"get_sky",
"get_upcoming_events",
"check_sky_fact",
"get_horoscope",
"open_chart_studio",
"get_occasion_sky",
"get_life_milestones",
"get_compatibility",
"find_chart_twins",
"get_famous_chart",
"get_birthday",
"get_sky_calendar"
],
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "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. A horoscope asked for with no sign named still belongs here: it opens with the sign left for the person to choose. 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. A request for one of those is not a request for this tool, not even as a first step: Zodiacs does not do this, and no horoscope is fetched for it. 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. There is no horoscope for a named child under 13, meaning a particular child the request names or points to, such as someone's nine-year-old daughter, whatever the sign and with or without a birth date. A Sun sign on its own, with no name and no birth date, gets the general horoscope for that sign. Birth details are used for this answer only: never stored, logged or put in a link. Zodiacs sends no notifications and schedules nothing, so a reminder or a horoscope on a schedule is not a request for this tool either. Its results include a link to the sign-up page for the daily email.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"birthDate": {
"description": "Optional: the person's birth date, for a personal forecast of their week from their own chart. Not stored.",
"pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
"type": "string"
},
"birthTime": {
"description": "Optional birth time on the local clock; needs birthZone. Not stored.",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
"type": "string"
},
"birthZone": {
"description": "Optional: the birthplace's time zone, needed with birthTime. Not stored.",
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
"type": "string"
},
"date": {
"description": "A date such as 2026-10-08. Leave it out for the person's today.",
"pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
"type": "string"
},
"focus": {
"description": "For a daily reading: general (the default), love or career.",
"enum": [
"general",
"love",
"career"
],
"type": "string"
},
"period": {
"description": "day (the default) or week.",
"enum": [
"day",
"week"
],
"type": "string"
},
"sign": {
"description": "Sun sign. Leave it out to let the person choose; never guess it.",
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
},
"zone": {
"description": "The person's time zone, such as Asia/Bangkok or America/New_York. Without it, times are in UTC.",
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
"type": "string"
}
},
"type": "object"
},
"name": "get_horoscope",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"available": {
"items": {
"additionalProperties": false,
"properties": {
"date": {
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"date",
"label"
],
"type": "object"
},
"type": "array"
},
"date": {
"type": "string"
},
"dateLabel": {
"type": "string"
},
"disclosure": {
"type": "string"
},
"focus": {
"enum": [
"general",
"love",
"career"
],
"type": "string"
},
"message": {
"type": "string"
},
"period": {
"enum": [
"day",
"week"
],
"type": "string"
},
"personal": {
"additionalProperties": false,
"properties": {
"items": {
"items": {
"additionalProperties": false,
"properties": {
"line": {
"type": "string"
},
"title": {
"type": "string"
},
"when": {
"type": "string"
}
},
"required": [
"title",
"line",
"when"
],
"type": "object"
},
"type": "array"
},
"note": {
"type": "string"
},
"timeKnown": {
"type": "boolean"
}
},
"required": [
"timeKnown",
"items",
"note"
],
"type": "object"
},
"reading": {
"additionalProperties": false,
"properties": {
"paragraphs": {
"items": {
"additionalProperties": false,
"properties": {
"heading": {
"type": "string"
},
"text": {
"type": "string"
}
},
"required": [
"text"
],
"type": "object"
},
"type": "array"
},
"title": {
"type": "string"
}
},
"required": [
"title",
"paragraphs"
],
"type": "object"
},
"shareUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"sign": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
},
"signName": {
"type": "string"
},
"status": {
"enum": [
"available",
"unavailable",
"choose-sign"
],
"type": "string"
},
"why": {
"additionalProperties": false,
"properties": {
"facts": {
"items": {
"additionalProperties": false,
"properties": {
"text": {
"type": "string"
},
"when": {
"type": "string"
}
},
"required": [
"text",
"when"
],
"type": "object"
},
"type": "array"
},
"houses": {
"items": {
"type": "string"
},
"type": "array"
},
"note": {
"type": "string"
}
},
"required": [
"note",
"facts",
"houses"
],
"type": "object"
},
"zone": {
"type": "string"
},
"zoneLabel": {
"type": "string"
},
"zoneSource": {
"enum": [
"request",
"assistant",
"default"
],
"type": "string"
}
},
"required": [
"status",
"period",
"focus",
"date",
"dateLabel",
"zone",
"zoneLabel",
"zoneSource",
"disclosure"
],
"type": "object"
},
"links": {
"items": {
"additionalProperties": false,
"properties": {
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"ok": {
"const": true,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"const": "get_horoscope",
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"data",
"links"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryAfterSeconds": {
"type": "number"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"ok": {
"const": false,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"enum": [
"get_capabilities",
"get_sky",
"get_upcoming_events",
"check_sky_fact",
"get_horoscope",
"open_chart_studio",
"get_occasion_sky",
"get_life_milestones",
"get_compatibility",
"find_chart_twins",
"get_famous_chart",
"get_birthday",
"get_sky_calendar"
],
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "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. There is no horoscope for a named child under 13, meaning a particular child the request names or points to, whatever the sign. A Sun sign on its own, with no name and no birth date, gets the general reading for that sign. 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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"date": {
"description": "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.",
"pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
"type": "string"
},
"focus": {
"description": "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.",
"enum": [
"general",
"love",
"career"
],
"type": "string"
},
"period": {
"description": "month, year or week.",
"enum": [
"month",
"year",
"week"
],
"type": "string"
},
"sign": {
"description": "Sun sign. Never guess it; ask the person if they have not said.",
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
},
"zone": {
"description": "The person's time zone, such as America/New_York, so the period and dates are their own. Without it, UTC.",
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
"type": "string"
}
},
"required": [
"sign",
"period"
],
"type": "object"
},
"name": "get_horoscope_period",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"available": {
"additionalProperties": false,
"properties": {
"months": {
"items": {
"type": "string"
},
"type": "array"
},
"years": {
"items": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"type": "array"
}
},
"required": [
"months",
"years"
],
"type": "object"
},
"confidence": {
"maximum": 95,
"minimum": 40,
"type": "integer"
},
"confidenceLabel": {
"type": "string"
},
"disclosure": {
"type": "string"
},
"focus": {
"enum": [
"general",
"love",
"career"
],
"type": "string"
},
"focusReadings": {
"items": {
"additionalProperties": false,
"properties": {
"date": {
"type": "string"
},
"paragraphs": {
"items": {
"additionalProperties": false,
"properties": {
"heading": {
"type": "string"
},
"text": {
"type": "string"
}
},
"required": [
"text"
],
"type": "object"
},
"type": "array"
},
"title": {
"type": "string"
}
},
"required": [
"date",
"title",
"paragraphs"
],
"type": "object"
},
"type": "array"
},
"from": {
"type": "string"
},
"label": {
"type": "string"
},
"message": {
"type": [
"string",
"null"
]
},
"pageUrl": {
"format": "uri",
"type": "string"
},
"period": {
"enum": [
"month",
"year",
"week"
],
"type": "string"
},
"reading": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"paragraphs": {
"items": {
"additionalProperties": false,
"properties": {
"heading": {
"type": "string"
},
"text": {
"type": "string"
}
},
"required": [
"text"
],
"type": "object"
},
"type": "array"
},
"published": {
"type": [
"string",
"null"
]
},
"title": {
"type": "string"
}
},
"required": [
"title",
"paragraphs",
"published"
],
"type": "object"
},
{
"type": "null"
}
]
},
"sign": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
},
"signName": {
"type": "string"
},
"sky": {
"items": {
"additionalProperties": false,
"properties": {
"date": {
"type": "string"
},
"house": {
"maximum": 12,
"minimum": 1,
"type": "integer"
},
"kind": {
"enum": [
"ingress",
"station",
"lunation",
"eclipse"
],
"type": "string"
},
"line": {
"type": "string"
},
"planet": {
"type": "string"
},
"sign": {
"type": "string"
},
"utc": {
"type": "string"
}
},
"required": [
"date",
"utc",
"kind",
"planet",
"sign",
"house",
"line"
],
"type": "object"
},
"type": "array"
},
"status": {
"enum": [
"available",
"sky-only"
],
"type": "string"
},
"to": {
"type": "string"
},
"zone": {
"type": "string"
},
"zoneSource": {
"enum": [
"request",
"assistant",
"default"
],
"type": "string"
}
},
"required": [
"status",
"sign",
"signName",
"period",
"focus",
"from",
"to",
"label",
"zone",
"zoneSource",
"reading",
"focusReadings",
"sky",
"message",
"available",
"pageUrl",
"confidence",
"confidenceLabel",
"disclosure"
],
"type": "object"
},
"links": {
"items": {
"additionalProperties": false,
"properties": {
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"ok": {
"const": true,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"const": "get_horoscope_period",
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"data",
"links"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryAfterSeconds": {
"type": "number"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"ok": {
"const": false,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"enum": [
"get_natal_chart",
"get_horoscope_period",
"get_chinese_zodiac",
"get_personal_transits",
"explain_astrology"
],
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"birthDate": {
"description": "The birth date, such as 1997-03-15.",
"pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
"type": "string"
},
"longitude": {
"description": "The birthplace's longitude, if known, for birth times before standard time.",
"maximum": 180,
"minimum": -180,
"type": "number"
},
"time": {
"description": "The birth time on the local clock, if known. Needs zone.",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
"type": "string"
},
"zone": {
"description": "The birthplace's time zone, such as Europe/London. Needed with a time.",
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
"type": "string"
}
},
"required": [
"birthDate"
],
"type": "object"
},
"name": "get_life_milestones",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"asOf": {
"type": "string"
},
"birthDate": {
"type": "string"
},
"cardUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"milestones": {
"items": {
"additionalProperties": false,
"properties": {
"age": {
"type": "number"
},
"first": {
"type": "string"
},
"index": {
"type": "number"
},
"kind": {
"enum": [
"jupiter-return",
"saturn-return",
"uranus-opposition"
],
"type": "string"
},
"last": {
"type": "string"
},
"name": {
"type": "string"
},
"passes": {
"items": {
"additionalProperties": false,
"properties": {
"at": {
"type": "string"
},
"retrograde": {
"type": "boolean"
}
},
"required": [
"at",
"retrograde"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"kind",
"name",
"index",
"age",
"first",
"last",
"passes"
],
"type": "object"
},
"type": "array"
},
"next": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"age": {
"type": "number"
},
"first": {
"type": "string"
},
"index": {
"type": "number"
},
"kind": {
"enum": [
"jupiter-return",
"saturn-return",
"uranus-opposition"
],
"type": "string"
},
"last": {
"type": "string"
},
"name": {
"type": "string"
},
"passes": {
"items": {
"additionalProperties": false,
"properties": {
"at": {
"type": "string"
},
"retrograde": {
"type": "boolean"
}
},
"required": [
"at",
"retrograde"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"kind",
"name",
"index",
"age",
"first",
"last",
"passes"
],
"type": "object"
},
{
"type": "null"
}
]
},
"note": {
"const": "Dates of computed crossings and their traditional astrological names. Without a birth time, a pass can move by about a day.",
"type": "string"
},
"numbers": {
"additionalProperties": false,
"properties": {
"fullMoons": {
"type": "number"
},
"jupiterReturns": {
"type": "number"
},
"mercuryRetrogrades": {
"type": "number"
}
},
"required": [
"fullMoons",
"mercuryRetrogrades",
"jupiterReturns"
],
"type": "object"
},
"shareUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"timeKnown": {
"type": "boolean"
}
},
"required": [
"birthDate",
"timeKnown",
"asOf",
"milestones",
"next",
"numbers",
"cardUrl",
"shareUrl",
"note"
],
"type": "object"
},
"links": {
"items": {
"additionalProperties": false,
"properties": {
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"ok": {
"const": true,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"const": "get_life_milestones",
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"data",
"links"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryAfterSeconds": {
"type": "number"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"ok": {
"const": false,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"enum": [
"get_capabilities",
"get_sky",
"get_upcoming_events",
"check_sky_fact",
"get_horoscope",
"open_chart_studio",
"get_occasion_sky",
"get_life_milestones",
"get_compatibility",
"find_chart_twins",
"get_famous_chart",
"get_birthday",
"get_sky_calendar"
],
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "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. A chart, a rising sign or a Moon sign asked for with no birth date in the conversation belongs to open_chart_studio, which opens with no details: the person enters them there, so nothing has to be asked for first. 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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"birthDate": {
"description": "The birth date, such as 1990-05-03 (years 1800 to 2199).",
"pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
"type": "string"
},
"latitude": {
"description": "Optional. The birthplace's latitude; with a birth time it adds the rising sign and the houses. Give it with longitude and zone. Nothing is stored.",
"maximum": 90,
"minimum": -90,
"type": "number"
},
"longitude": {
"description": "Optional. The birthplace's longitude, with latitude. Nothing is stored.",
"maximum": 180,
"minimum": -180,
"type": "number"
},
"place": {
"description": "Optional birthplace name, such as Madrid, Spain. Display only: it is not used in the calculation and is not stored.",
"maxLength": 80,
"minLength": 1,
"pattern": "^[^\\u0000-\\u001f\\u007f<>{}[\\]\\\\`]+$",
"type": "string"
},
"time": {
"description": "The birth time on the local clock, such as 08:30, only if the person knows it. Never guess it. Needs zone.",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
"type": "string"
},
"zone": {
"description": "The birthplace's time zone, such as Europe/Madrid. Needed with a time or a place.",
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
"type": "string"
}
},
"required": [
"birthDate"
],
"type": "object"
},
"name": "get_natal_chart",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"angles": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"ascendant": {
"type": "string"
},
"midheaven": {
"type": "string"
}
},
"required": [
"ascendant",
"midheaven"
],
"type": "object"
},
{
"type": "null"
}
]
},
"aspects": {
"items": {
"additionalProperties": false,
"properties": {
"a": {
"enum": [
"Sun",
"Moon",
"Mercury",
"Venus",
"Mars",
"Jupiter",
"Saturn",
"Uranus",
"Neptune",
"Pluto"
],
"type": "string"
},
"b": {
"enum": [
"Sun",
"Moon",
"Mercury",
"Venus",
"Mars",
"Jupiter",
"Saturn",
"Uranus",
"Neptune",
"Pluto"
],
"type": "string"
},
"line": {
"type": "string"
},
"orb": {
"minimum": 0,
"type": "number"
},
"type": {
"enum": [
"conjunction",
"sextile",
"square",
"trine",
"opposition"
],
"type": "string"
}
},
"required": [
"a",
"b",
"type",
"orb",
"line"
],
"type": "object"
},
"maxItems": 8,
"type": "array"
},
"balance": {
"additionalProperties": false,
"properties": {
"elements": {
"additionalProperties": false,
"properties": {
"air": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"earth": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"fire": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"water": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"fire",
"earth",
"air",
"water"
],
"type": "object"
},
"lines": {
"items": {
"type": "string"
},
"type": "array"
},
"modalities": {
"additionalProperties": false,
"properties": {
"cardinal": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"fixed": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"mutable": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"cardinal",
"fixed",
"mutable"
],
"type": "object"
}
},
"required": [
"elements",
"modalities",
"lines"
],
"type": "object"
},
"birthDate": {
"type": "string"
},
"castFor": {
"additionalProperties": false,
"properties": {
"basis": {
"enum": [
"birth-time",
"local-noon",
"utc-noon"
],
"type": "string"
},
"utc": {
"type": "string"
}
},
"required": [
"utc",
"basis"
],
"type": "object"
},
"chartUrl": {
"format": "uri",
"type": "string"
},
"houseSystem": {
"anyOf": [
{
"enum": [
"whole-sign"
],
"type": "string"
},
{
"type": "null"
}
]
},
"moon": {
"additionalProperties": false,
"properties": {
"meaning": {
"type": [
"string",
"null"
]
},
"pageUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"possibleSigns": {
"items": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
},
"type": "array"
},
"sign": {
"anyOf": [
{
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"sign",
"possibleSigns",
"meaning",
"pageUrl"
],
"type": "object"
},
"note": {
"const": "Astrology’s reading of a birth chart: tendencies to reflect on, not a prediction or a fixed destiny.",
"type": "string"
},
"place": {
"type": [
"string",
"null"
]
},
"placed": {
"type": "boolean"
},
"planets": {
"items": {
"additionalProperties": false,
"properties": {
"body": {
"enum": [
"Sun",
"Moon",
"Mercury",
"Venus",
"Mars",
"Jupiter",
"Saturn",
"Uranus",
"Neptune",
"Pluto"
],
"type": "string"
},
"house": {
"anyOf": [
{
"maximum": 12,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
]
},
"houseLine": {
"type": [
"string",
"null"
]
},
"pageUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"position": {
"type": [
"string",
"null"
]
},
"possibleSigns": {
"items": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
},
"type": "array"
},
"retrograde": {
"type": "boolean"
},
"sign": {
"anyOf": [
{
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
},
{
"type": "null"
}
]
},
"signLine": {
"type": [
"string",
"null"
]
}
},
"required": [
"body",
"sign",
"possibleSigns",
"position",
"retrograde",
"house",
"signLine",
"houseLine",
"pageUrl"
],
"type": "object"
},
"maxItems": 10,
"minItems": 10,
"type": "array"
},
"rising": {
"additionalProperties": false,
"properties": {
"meaning": {
"type": [
"string",
"null"
]
},
"pageUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"possibleSigns": {
"items": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
},
"type": "array"
},
"sign": {
"anyOf": [
{
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"sign",
"possibleSigns",
"meaning",
"pageUrl"
],
"type": "object"
},
"sun": {
"additionalProperties": false,
"properties": {
"meaning": {
"type": [
"string",
"null"
]
},
"pageUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"possibleSigns": {
"items": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
},
"type": "array"
},
"sign": {
"anyOf": [
{
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"sign",
"possibleSigns",
"meaning",
"pageUrl"
],
"type": "object"
},
"time": {
"type": [
"string",
"null"
]
},
"timeKnown": {
"type": "boolean"
},
"timeNote": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"dst-gap",
"dst-fold"
],
"type": "string"
},
"offsetUsed": {
"type": "string"
},
"shiftMinutes": {
"minimum": 0,
"type": "number"
},
"text": {
"type": "string"
}
},
"required": [
"kind",
"shiftMinutes",
"offsetUsed",
"text"
],
"type": "object"
},
"under18": {
"type": "boolean"
},
"unknown": {
"items": {
"type": "string"
},
"type": "array"
},
"zone": {
"type": [
"string",
"null"
]
}
},
"required": [
"birthDate",
"time",
"zone",
"place",
"timeKnown",
"placed",
"castFor",
"houseSystem",
"sun",
"moon",
"rising",
"planets",
"angles",
"aspects",
"balance",
"unknown",
"chartUrl",
"under18",
"note"
],
"type": "object"
},
"links": {
"items": {
"additionalProperties": false,
"properties": {
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"ok": {
"const": true,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"const": "get_natal_chart",
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"data",
"links"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryAfterSeconds": {
"type": "number"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"ok": {
"const": false,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"enum": [
"get_natal_chart",
"get_horoscope_period",
"get_chinese_zodiac",
"get_personal_transits",
"explain_astrology"
],
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"date": {
"description": "The day, such as 2027-06-12 (years 1800–2199). Needed unless searchFrom and searchTo are given.",
"pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
"type": "string"
},
"latitude": {
"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.",
"maximum": 90,
"minimum": -90,
"type": "number"
},
"longitude": {
"description": "Optional. The place's longitude, with latitude, for the evening sky. Nothing is stored.",
"maximum": 180,
"minimum": -180,
"type": "number"
},
"names": {
"description": "Optional: up to two first names to print on the card, only if the person asks for them. Display only, not stored.",
"maxLength": 60,
"minLength": 1,
"type": "string"
},
"occasion": {
"description": "What the day is: wedding, anniversary, met (the day they met), birthday, pet, home, job, graduation, retirement or gathering.",
"enum": [
"wedding",
"anniversary",
"met",
"birthday",
"pet",
"home",
"job",
"graduation",
"retirement",
"gathering"
],
"type": "string"
},
"place": {
"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.",
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"searchFrom": {
"description": "To find the best days: the first day of the window to search, such as 2027-06-01. Give it with searchTo.",
"pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
"type": "string"
},
"searchTo": {
"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.",
"pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
"type": "string"
},
"time": {
"description": "The local clock time, such as 19:00, if the person gives one. Needs zone.",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
"type": "string"
},
"zone": {
"description": "The place's time zone, such as Europe/Rome. Needed with a time or a place.",
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
"type": "string"
}
},
"required": [
"occasion"
],
"type": "object"
},
"name": "get_occasion_sky",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"bestDays": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"best": {
"items": {
"additionalProperties": false,
"properties": {
"date": {
"type": "string"
},
"reasons": {
"items": {
"type": "string"
},
"type": "array"
},
"score": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"verdict": {
"type": "string"
}
},
"required": [
"date",
"score",
"verdict",
"reasons"
],
"type": "object"
},
"maxItems": 3,
"type": "array"
},
"days": {
"maximum": 92,
"minimum": 1,
"type": "integer"
},
"from": {
"type": "string"
},
"to": {
"type": "string"
}
},
"required": [
"from",
"to",
"days",
"best"
],
"type": "object"
},
{
"type": "null"
}
]
},
"card": {
"additionalProperties": false,
"properties": {
"closing": {
"type": "string"
},
"interpretation": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"title",
"interpretation",
"closing"
],
"type": "object"
},
"cardUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"date": {
"type": "string"
},
"evening": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"civilDusk": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"local": {
"type": "string"
},
"utc": {
"type": "string"
}
},
"required": [
"utc",
"local"
],
"type": "object"
},
{
"type": "null"
}
]
},
"flags": {
"items": {
"type": "string"
},
"type": "array"
},
"goldenHour": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"end": {
"additionalProperties": false,
"properties": {
"local": {
"type": "string"
},
"utc": {
"type": "string"
}
},
"required": [
"utc",
"local"
],
"type": "object"
},
"start": {
"additionalProperties": false,
"properties": {
"local": {
"type": "string"
},
"utc": {
"type": "string"
}
},
"required": [
"utc",
"local"
],
"type": "object"
}
},
"required": [
"start",
"end"
],
"type": "object"
},
{
"type": "null"
}
]
},
"moonHighest": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"altitude": {
"type": "number"
},
"at": {
"additionalProperties": false,
"properties": {
"local": {
"type": "string"
},
"utc": {
"type": "string"
}
},
"required": [
"utc",
"local"
],
"type": "object"
}
},
"required": [
"at",
"altitude"
],
"type": "object"
},
{
"type": "null"
}
]
},
"moonrise": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"local": {
"type": "string"
},
"utc": {
"type": "string"
}
},
"required": [
"utc",
"local"
],
"type": "object"
},
{
"type": "null"
}
]
},
"moonset": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"local": {
"type": "string"
},
"utc": {
"type": "string"
}
},
"required": [
"utc",
"local"
],
"type": "object"
},
{
"type": "null"
}
]
},
"planetsAfterDusk": {
"items": {
"type": "string"
},
"type": "array"
},
"sunrise": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"local": {
"type": "string"
},
"utc": {
"type": "string"
}
},
"required": [
"utc",
"local"
],
"type": "object"
},
{
"type": "null"
}
]
},
"sunset": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"local": {
"type": "string"
},
"utc": {
"type": "string"
}
},
"required": [
"utc",
"local"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"sunrise",
"sunset",
"goldenHour",
"civilDusk",
"moonrise",
"moonset",
"moonHighest",
"planetsAfterDusk",
"flags"
],
"type": "object"
},
{
"type": "null"
}
]
},
"instant": {
"additionalProperties": false,
"properties": {
"local": {
"type": "string"
},
"utc": {
"type": "string"
}
},
"required": [
"utc",
"local"
],
"type": "object"
},
"instantIs": {
"enum": [
"given-time",
"local-noon",
"utc-noon"
],
"type": "string"
},
"moonSignChange": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
{
"type": "null"
}
]
},
"names": {
"type": [
"string",
"null"
]
},
"note": {
"const": "Astrology’s reading of the day, for insight and fun, not a guarantee of how it will go.",
"type": "string"
},
"occasion": {
"enum": [
"wedding",
"anniversary",
"met",
"birthday",
"pet",
"home",
"job",
"graduation",
"retirement",
"gathering"
],
"type": "string"
},
"place": {
"type": [
"string",
"null"
]
},
"rating": {
"additionalProperties": false,
"properties": {
"reasons": {
"items": {
"type": "string"
},
"type": "array"
},
"score": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"verdict": {
"type": "string"
}
},
"required": [
"score",
"verdict",
"reasons"
],
"type": "object"
},
"shareUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"sky": {
"additionalProperties": false,
"properties": {
"bodies": {
"items": {
"additionalProperties": false,
"properties": {
"body": {
"type": "string"
},
"degree": {
"type": "number"
},
"retrograde": {
"type": "boolean"
},
"sign": {
"type": "string"
}
},
"required": [
"body",
"sign",
"degree",
"retrograde"
],
"type": "object"
},
"type": "array"
},
"moon": {
"additionalProperties": false,
"properties": {
"illuminationPercent": {
"type": "number"
},
"phase": {
"type": "string"
},
"waxing": {
"type": "boolean"
}
},
"required": [
"phase",
"illuminationPercent",
"waxing"
],
"type": "object"
},
"retrograde": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"bodies",
"moon",
"retrograde"
],
"type": "object"
},
"time": {
"type": [
"string",
"null"
]
},
"zone": {
"type": [
"string",
"null"
]
}
},
"required": [
"occasion",
"date",
"time",
"zone",
"place",
"names",
"card",
"instant",
"instantIs",
"sky",
"moonSignChange",
"evening",
"rating",
"bestDays",
"cardUrl",
"shareUrl",
"note"
],
"type": "object"
},
"links": {
"items": {
"additionalProperties": false,
"properties": {
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"ok": {
"const": true,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"const": "get_occasion_sky",
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"data",
"links"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryAfterSeconds": {
"type": "number"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"ok": {
"const": false,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"enum": [
"get_capabilities",
"get_sky",
"get_upcoming_events",
"check_sky_fact",
"get_horoscope",
"open_chart_studio",
"get_occasion_sky",
"get_life_milestones",
"get_compatibility",
"find_chart_twins",
"get_famous_chart",
"get_birthday",
"get_sky_calendar"
],
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"birthDate": {
"description": "The birth date, such as 1990-05-03 (years 1800 to 2199).",
"pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
"type": "string"
},
"currentZone": {
"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.",
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
"type": "string"
},
"from": {
"description": "For window: the first day, such as 2026-11-01. Defaults to today.",
"pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
"type": "string"
},
"latitude": {
"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.",
"maximum": 90,
"minimum": -90,
"type": "number"
},
"longitude": {
"description": "Optional. The birthplace's longitude, with latitude. Nothing is stored.",
"maximum": 180,
"minimum": -180,
"type": "number"
},
"mode": {
"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.",
"enum": [
"window",
"year-ahead"
],
"type": "string"
},
"time": {
"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.",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
"type": "string"
},
"to": {
"description": "For window: the last day, at most 366 days after from. Defaults to a 30-day window, from included.",
"pattern": "^(?:18|19|20|21)\\d{2}-\\d{2}-\\d{2}$",
"type": "string"
},
"zone": {
"description": "The birthplace's time zone, such as Europe/Madrid. Needed with a time or a place.",
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
"type": "string"
}
},
"required": [
"birthDate"
],
"type": "object"
},
"name": "get_personal_transits",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"birthDate": {
"type": "string"
},
"contacts": {
"items": {
"additionalProperties": false,
"properties": {
"aspect": {
"enum": [
"conjunction",
"sextile",
"square",
"trine",
"opposition"
],
"type": "string"
},
"confidence": {
"maximum": 95,
"minimum": 40,
"type": "integer"
},
"confidenceLabel": {
"type": "string"
},
"date": {
"type": "string"
},
"exactUtc": {
"type": "string"
},
"firstPass": {
"type": "string"
},
"lastPass": {
"type": "string"
},
"line": {
"type": "string"
},
"pass": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"passCount": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"planet": {
"enum": [
"Sun",
"Moon",
"Mercury",
"Venus",
"Mars",
"Jupiter",
"Saturn",
"Uranus",
"Neptune",
"Pluto"
],
"type": "string"
},
"point": {
"enum": [
"Sun",
"Moon",
"Mercury",
"Venus",
"Mars",
"Jupiter",
"Saturn",
"Uranus",
"Neptune",
"Pluto",
"ASC",
"MC"
],
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"date",
"exactUtc",
"planet",
"aspect",
"point",
"pass",
"passCount",
"firstPass",
"lastPass",
"confidence",
"confidenceLabel",
"title",
"line"
],
"type": "object"
},
"maxItems": 60,
"type": "array"
},
"found": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"from": {
"type": "string"
},
"highlights": {
"items": {
"additionalProperties": false,
"properties": {
"confidence": {
"maximum": 95,
"minimum": 40,
"type": "integer"
},
"confidenceLabel": {
"type": "string"
},
"date": {
"type": "string"
},
"endDate": {
"type": [
"string",
"null"
]
},
"house": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"line": {
"type": "string"
},
"number": {
"maximum": 12,
"minimum": 1,
"type": "integer"
}
},
"required": [
"number",
"line"
],
"type": "object"
},
{
"type": "null"
}
]
},
"kind": {
"enum": [
"solar-return",
"aspect",
"ingress",
"eclipse",
"saturn-return"
],
"type": "string"
},
"line": {
"type": "string"
},
"planet": {
"type": "string"
}
},
"required": [
"date",
"endDate",
"kind",
"planet",
"line",
"confidence",
"confidenceLabel",
"house"
],
"type": "object"
},
"type": "array"
},
"limits": {
"items": {
"type": "string"
},
"type": "array"
},
"mode": {
"enum": [
"window",
"year-ahead"
],
"type": "string"
},
"note": {
"const": "Astrology’s reading of the sky meeting your birth chart, for reflection: not a guarantee, and not a forecast of health or money.",
"type": "string"
},
"pageUrl": {
"format": "uri",
"type": "string"
},
"placed": {
"type": "boolean"
},
"scanned": {
"additionalProperties": false,
"properties": {
"planets": {
"items": {
"enum": [
"Sun",
"Moon",
"Mercury",
"Venus",
"Mars",
"Jupiter",
"Saturn",
"Uranus",
"Neptune",
"Pluto"
],
"type": "string"
},
"type": "array"
},
"points": {
"items": {
"enum": [
"Sun",
"Moon",
"Mercury",
"Venus",
"Mars",
"Jupiter",
"Saturn",
"Uranus",
"Neptune",
"Pluto",
"ASC",
"MC"
],
"type": "string"
},
"type": "array"
}
},
"required": [
"planets",
"points"
],
"type": "object"
},
"sun": {
"type": [
"string",
"null"
]
},
"timeKnown": {
"type": "boolean"
},
"to": {
"type": "string"
},
"under18": {
"type": "boolean"
},
"zone": {
"type": "string"
}
},
"required": [
"mode",
"birthDate",
"timeKnown",
"placed",
"from",
"to",
"zone",
"scanned",
"contacts",
"found",
"highlights",
"limits",
"sun",
"under18",
"pageUrl",
"note"
],
"type": "object"
},
"links": {
"items": {
"additionalProperties": false,
"properties": {
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"ok": {
"const": true,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"const": "get_personal_transits",
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"data",
"links"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryAfterSeconds": {
"type": "number"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"ok": {
"const": false,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"enum": [
"get_natal_chart",
"get_horoscope_period",
"get_chinese_zodiac",
"get_personal_transits",
"explain_astrology"
],
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bodies": {
"items": {
"enum": [
"Sun",
"Moon",
"Mercury",
"Venus",
"Mars",
"Jupiter",
"Saturn",
"Uranus",
"Neptune",
"Pluto",
"North Node",
"South Node"
],
"type": "string"
},
"maxItems": 12,
"minItems": 1,
"type": "array"
},
"instant": {
"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).",
"maxLength": 29,
"minLength": 20,
"type": "string"
},
"zone": {
"description": "The person's time zone, such as Asia/Bangkok or America/New_York. Without it, times are in UTC.",
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
"type": "string"
}
},
"type": "object"
},
"name": "get_sky",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"calculation": {
"additionalProperties": false,
"properties": {
"backend": {
"properties": {
"ephemeris": {
"properties": {
"name": {
"const": "astronomy-engine"
},
"version": {
"type": "string"
}
},
"required": [
"name",
"version"
],
"type": "object"
},
"name": {
"const": "@zodiacs/engine"
},
"version": {
"type": "string"
}
},
"required": [
"name",
"version",
"ephemeris"
],
"type": "object"
},
"cite": {
"additionalProperties": false,
"properties": {
"engine": {
"type": "string"
},
"receipt": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"url",
"receipt",
"engine",
"version"
],
"type": "object"
},
"receipt": {
"description": "The receipt for a calculation the engine writes no receipt for: the engine, its conventions and coverage as its own receipts state them, and what this request used.",
"properties": {
"conventionIds": {
"description": "Every id of the Zodiacs conventions registry (https://zodiacs.org/developers/conventions/) that this receipt's own fields name, in code-unit order, each once: each conventions and coverage field, the ephemeris, the endpoint, each ΔT source's model, how local times were read and how a search ran. The result's are left out, so the receipt holds nothing the request gave.",
"items": {
"pattern": "^[A-Za-z][A-Za-z0-9-]*:\\S+$",
"type": "string"
},
"type": "array",
"uniqueItems": true
},
"conventions": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"coverage": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"deltaT": {
"description": "The two sources of ΔT the engine's time basis uses: IERS from 1972 to the end of its UT1 table, then its model. A result that gives an instant's ΔT names which applied.",
"maxItems": 2,
"minItems": 2,
"prefixItems": [
{
"properties": {
"model": {
"const": "iers-utc/1"
},
"table": {
"type": "string"
},
"tableDigest": {
"type": "string"
}
},
"required": [
"model",
"table",
"tableDigest"
],
"type": "object"
},
{
"properties": {
"model": {
"const": "zodiacs-deltat/1"
},
"table": {
"type": "string"
},
"tableDigest": {
"type": "string"
}
},
"required": [
"model",
"table",
"tableDigest"
],
"type": "object"
}
],
"type": "array"
},
"electionSearch": {
"description": "How an election search ran: the crossing search's steps for sign changes, stations and phases; the void-of-course rule and the step of its scan for the Moon's last aspect; the house sampling; the evaluations made, where a crossing step counts once and a full calculation, all the positions at an instant or a natalChart for a house, counts as fullCalculationCost. Every window's ends are within a second, so a gap shorter than resolutionSeconds between two windows is closed and a window shorter than it is not listed: two boundaries that close may be one instant found twice.",
"properties": {
"boundarySeconds": {
"const": 1
},
"completeness": {
"const": "tested-not-proven"
},
"fullCalculationCost": {
"const": 25
},
"houseSampleMinutes": {
"const": 60
},
"maxSamples": {
"type": "integer"
},
"resolutionSeconds": {
"const": 2
},
"samples": {
"minimum": 0,
"type": "integer"
},
"solver": {
"const": "engine-longitude-crossings-and-sampled-houses"
},
"stepDays": {
"additionalProperties": {
"type": "number"
},
"type": "object"
},
"voidOfCourse": {
"properties": {
"bodies": {
"const": "modern"
},
"convention": {
"const": "last-exact-ptolemaic-aspect-to-sign-exit"
},
"scanHours": {
"type": "number"
}
},
"required": [
"convention",
"bodies",
"scanHours"
],
"type": "object"
},
"window": {
"const": "start-inclusive-end-exclusive"
}
},
"required": [
"solver",
"stepDays",
"voidOfCourse",
"houseSampleMinutes",
"boundarySeconds",
"resolutionSeconds",
"fullCalculationCost",
"samples",
"maxSamples",
"window",
"completeness"
],
"type": "object"
},
"endpoint": {
"enum": [
"chart",
"positions",
"houses",
"events",
"time",
"sky-fact",
"elections"
]
},
"engine": {
"properties": {
"ephemeris": {
"properties": {
"name": {
"const": "astronomy-engine"
},
"version": {
"type": "string"
}
},
"required": [
"name",
"version"
],
"type": "object"
},
"name": {
"const": "@zodiacs/engine"
},
"version": {
"type": "string"
}
},
"required": [
"name",
"version",
"ephemeris"
],
"type": "object"
},
"referenceSpan": {
"properties": {
"from": {
"format": "date-time",
"type": "string"
},
"to": {
"format": "date-time",
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"schema": {
"const": "zodiacs.compute-receipt.v1"
},
"search": {
"properties": {
"bisections": {
"type": "integer"
},
"completeness": {
"const": "tested-not-proven"
},
"maxSamples": {
"type": "integer"
},
"samples": {
"minimum": 0,
"type": "integer"
},
"solver": {
"const": "engine-longitude-crossings"
},
"stepDays": {
"additionalProperties": {
"type": "number"
},
"type": "object"
},
"window": {
"const": "start-exclusive-end-inclusive"
}
},
"required": [
"solver",
"stepDays",
"bisections",
"samples",
"maxSamples",
"window",
"completeness"
],
"type": "object"
},
"timeResolution": {
"properties": {
"pinnedTzdb": {
"type": "object"
},
"policy": {
"properties": {
"fold": {
"const": "earlier"
},
"gap": {
"const": "shift-forward"
}
},
"type": "object"
},
"resolver": {
"type": "string"
},
"runtimeTzdb": {
"type": [
"string",
"null"
]
}
},
"required": [
"resolver",
"policy",
"pinnedTzdb",
"runtimeTzdb"
],
"type": "object"
}
},
"required": [
"schema",
"endpoint",
"engine",
"conventions",
"coverage",
"referenceSpan",
"deltaT",
"conventionIds"
],
"type": "object"
},
"result": {
"additionalProperties": false,
"properties": {
"instants": {
"items": {
"additionalProperties": false,
"properties": {
"bodies": {
"items": {
"additionalProperties": false,
"properties": {
"body": {
"type": "string"
},
"degree": {
"type": "number"
},
"lat": {
"type": "number"
},
"lon": {
"type": "number"
},
"retrograde": {
"type": "boolean"
},
"sign": {
"type": "string"
},
"speed": {
"type": "number"
}
},
"required": [
"body",
"lon",
"lat",
"speed",
"retrograde",
"sign",
"degree"
],
"type": "object"
},
"type": "array"
},
"deltaT": {
"description": "ΔT = TT − UT1 in seconds, with its 1-sigma band and where it came from, as the engine reports it for a chart at the instant: iers-utc/1 from 1972 to the end of the engine's UT1 table, its model zodiacs-deltat/1 otherwise.",
"properties": {
"model": {
"enum": [
"iers-utc/1",
"zodiacs-deltat/1"
]
},
"seconds": {
"type": "number"
},
"segment": {
"enum": [
"long-term",
"reconstructed",
"observed",
"predicted",
"extrapolated"
]
},
"sigma": {
"type": "number"
},
"table": {
"type": "string"
},
"tableDigest": {
"type": "string"
}
},
"required": [
"seconds",
"sigma",
"model",
"table",
"tableDigest",
"segment"
],
"type": "object"
},
"flags": {
"items": {
"type": "string"
},
"type": "array"
},
"instant": {
"type": "string"
},
"timeScale": {
"description": "How the engine read the instant, as a chart reports it. basis iers, from 1972 to the end of its UT1 table: TT is UTC plus the leap seconds and 32.184 s, and UT1 is UTC plus IERS UT1 − UTC. basis delta-t, otherwise: the instant is read as UT1, and TT is UT1 plus the ΔT model.",
"properties": {
"basis": {
"enum": [
"iers",
"delta-t"
]
},
"input": {
"const": "utc"
},
"leapSeconds": {
"anyOf": [
{
"description": "TAI − UTC in seconds from the IERS leap-second list; listed is false after the list expires and its last value is carried.",
"properties": {
"listed": {
"type": "boolean"
},
"taiMinusUtc": {
"type": "number"
}
},
"required": [
"taiMinusUtc",
"listed"
],
"type": "object"
},
{
"type": "null"
}
]
},
"ut1MinusUtc": {
"anyOf": [
{
"description": "UT1 − UTC in seconds as the engine used it, with its 1-sigma band and its source: observed or predicted by IERS, or fallback after the table ends; null before 1972.",
"properties": {
"seconds": {
"type": "number"
},
"sigma": {
"type": "number"
},
"source": {
"enum": [
"observed",
"predicted",
"fallback"
]
}
},
"required": [
"seconds",
"sigma",
"source"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"input",
"basis",
"ut1MinusUtc",
"leapSeconds"
],
"type": "object"
}
},
"required": [
"instant",
"bodies",
"deltaT",
"timeScale",
"flags"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"instants"
],
"type": "object"
},
"schema": {
"type": "string"
}
},
"required": [
"schema",
"result",
"receipt",
"backend",
"cite"
],
"type": "object"
},
"interpretation": {
"const": "Astronomical calculations; no personal prediction is supplied.",
"type": "string"
},
"mode": {
"enum": [
"current-instant",
"requested-instant"
],
"type": "string"
},
"moonPhase": {
"additionalProperties": false,
"properties": {
"angle": {
"type": "number"
},
"illumination": {
"type": "number"
},
"name": {
"type": "string"
}
},
"required": [
"name",
"angle",
"illumination"
],
"type": "object"
},
"time": {
"additionalProperties": false,
"properties": {
"display": {
"type": "string"
},
"utc": {
"type": "string"
},
"zone": {
"type": "string"
}
},
"required": [
"utc",
"zone",
"display"
],
"type": "object"
}
},
"required": [
"mode",
"time",
"calculation",
"moonPhase",
"interpretation"
],
"type": "object"
},
"links": {
"items": {
"additionalProperties": false,
"properties": {
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"ok": {
"const": true,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"const": "get_sky",
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"data",
"links"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryAfterSeconds": {
"type": "number"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"ok": {
"const": false,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"enum": [
"get_capabilities",
"get_sky",
"get_upcoming_events",
"check_sky_fact",
"get_horoscope",
"open_chart_studio",
"get_occasion_sky",
"get_life_milestones",
"get_compatibility",
"find_chart_twins",
"get_famous_chart",
"get_birthday",
"get_sky_calendar"
],
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"language": {
"description": "The language of the event titles: en (the default), es, pt, fr, it or ru.",
"enum": [
"en",
"es",
"pt",
"fr",
"it",
"ru"
],
"type": "string"
}
},
"type": "object"
},
"name": "get_sky_calendar",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"contains": {
"items": {
"type": "string"
},
"minItems": 1,
"type": "array"
},
"covers": {
"additionalProperties": false,
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"feedUrl": {
"format": "uri",
"type": "string"
},
"howTo": {
"additionalProperties": false,
"properties": {
"apple": {
"type": "string"
},
"google": {
"type": "string"
},
"outlook": {
"type": "string"
}
},
"required": [
"google",
"apple",
"outlook"
],
"type": "object"
},
"language": {
"enum": [
"en",
"es",
"pt",
"fr",
"it",
"ru"
],
"type": "string"
},
"next": {
"items": {
"additionalProperties": false,
"properties": {
"end": {
"type": [
"string",
"null"
]
},
"start": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"title",
"start",
"end"
],
"type": "object"
},
"maxItems": 3,
"type": "array"
},
"note": {
"type": "string"
},
"pageUrl": {
"format": "uri",
"type": "string"
},
"shareUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"subscribeUrl": {
"format": "uri",
"type": "string"
}
},
"required": [
"language",
"feedUrl",
"subscribeUrl",
"pageUrl",
"shareUrl",
"contains",
"covers",
"next",
"howTo",
"note"
],
"type": "object"
},
"links": {
"items": {
"additionalProperties": false,
"properties": {
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"ok": {
"const": true,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"const": "get_sky_calendar",
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"data",
"links"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryAfterSeconds": {
"type": "number"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"ok": {
"const": false,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"enum": [
"get_capabilities",
"get_sky",
"get_upcoming_events",
"check_sky_fact",
"get_horoscope",
"open_chart_studio",
"get_occasion_sky",
"get_life_milestones",
"get_compatibility",
"find_chart_twins",
"get_famous_chart",
"get_birthday",
"get_sky_calendar"
],
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "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. It lists dates and makes no prediction. A request to set a reminder or an alert, or to schedule anything, is not a request for this tool, not even to look the date up first: Zodiacs sets no reminders and schedules nothing. Nor is a stock or lottery pick, an investment call, a bet, an election or health forecast, or a guarantee. 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:32 UTC, where Horizons gives 17:35 UTC.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bodies": {
"items": {
"enum": [
"Sun",
"Moon",
"Mercury",
"Venus",
"Mars",
"Jupiter",
"Saturn",
"Uranus",
"Neptune",
"Pluto"
],
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
},
"from": {
"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).",
"maxLength": 29,
"minLength": 20,
"type": "string"
},
"kinds": {
"items": {
"enum": [
"ingress",
"station",
"lunation"
],
"type": "string"
},
"maxItems": 3,
"minItems": 1,
"type": "array"
},
"to": {
"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).",
"maxLength": 29,
"minLength": 20,
"type": "string"
},
"zone": {
"description": "The person's time zone, such as Asia/Bangkok or America/New_York. Without it, times are in UTC.",
"maxLength": 64,
"minLength": 1,
"pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,3}$",
"type": "string"
}
},
"type": "object"
},
"name": "get_upcoming_events",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"calculation": {
"additionalProperties": false,
"properties": {
"backend": {
"properties": {
"ephemeris": {
"properties": {
"name": {
"const": "astronomy-engine"
},
"version": {
"type": "string"
}
},
"required": [
"name",
"version"
],
"type": "object"
},
"name": {
"const": "@zodiacs/engine"
},
"version": {
"type": "string"
}
},
"required": [
"name",
"version",
"ephemeris"
],
"type": "object"
},
"cite": {
"additionalProperties": false,
"properties": {
"engine": {
"type": "string"
},
"receipt": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"url",
"receipt",
"engine",
"version"
],
"type": "object"
},
"receipt": {
"description": "The receipt for a calculation the engine writes no receipt for: the engine, its conventions and coverage as its own receipts state them, and what this request used.",
"properties": {
"conventionIds": {
"description": "Every id of the Zodiacs conventions registry (https://zodiacs.org/developers/conventions/) that this receipt's own fields name, in code-unit order, each once: each conventions and coverage field, the ephemeris, the endpoint, each ΔT source's model, how local times were read and how a search ran. The result's are left out, so the receipt holds nothing the request gave.",
"items": {
"pattern": "^[A-Za-z][A-Za-z0-9-]*:\\S+$",
"type": "string"
},
"type": "array",
"uniqueItems": true
},
"conventions": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"coverage": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"deltaT": {
"description": "The two sources of ΔT the engine's time basis uses: IERS from 1972 to the end of its UT1 table, then its model. A result that gives an instant's ΔT names which applied.",
"maxItems": 2,
"minItems": 2,
"prefixItems": [
{
"properties": {
"model": {
"const": "iers-utc/1"
},
"table": {
"type": "string"
},
"tableDigest": {
"type": "string"
}
},
"required": [
"model",
"table",
"tableDigest"
],
"type": "object"
},
{
"properties": {
"model": {
"const": "zodiacs-deltat/1"
},
"table": {
"type": "string"
},
"tableDigest": {
"type": "string"
}
},
"required": [
"model",
"table",
"tableDigest"
],
"type": "object"
}
],
"type": "array"
},
"electionSearch": {
"description": "How an election search ran: the crossing search's steps for sign changes, stations and phases; the void-of-course rule and the step of its scan for the Moon's last aspect; the house sampling; the evaluations made, where a crossing step counts once and a full calculation, all the positions at an instant or a natalChart for a house, counts as fullCalculationCost. Every window's ends are within a second, so a gap shorter than resolutionSeconds between two windows is closed and a window shorter than it is not listed: two boundaries that close may be one instant found twice.",
"properties": {
"boundarySeconds": {
"const": 1
},
"completeness": {
"const": "tested-not-proven"
},
"fullCalculationCost": {
"const": 25
},
"houseSampleMinutes": {
"const": 60
},
"maxSamples": {
"type": "integer"
},
"resolutionSeconds": {
"const": 2
},
"samples": {
"minimum": 0,
"type": "integer"
},
"solver": {
"const": "engine-longitude-crossings-and-sampled-houses"
},
"stepDays": {
"additionalProperties": {
"type": "number"
},
"type": "object"
},
"voidOfCourse": {
"properties": {
"bodies": {
"const": "modern"
},
"convention": {
"const": "last-exact-ptolemaic-aspect-to-sign-exit"
},
"scanHours": {
"type": "number"
}
},
"required": [
"convention",
"bodies",
"scanHours"
],
"type": "object"
},
"window": {
"const": "start-inclusive-end-exclusive"
}
},
"required": [
"solver",
"stepDays",
"voidOfCourse",
"houseSampleMinutes",
"boundarySeconds",
"resolutionSeconds",
"fullCalculationCost",
"samples",
"maxSamples",
"window",
"completeness"
],
"type": "object"
},
"endpoint": {
"enum": [
"chart",
"positions",
"houses",
"events",
"time",
"sky-fact",
"elections"
]
},
"engine": {
"properties": {
"ephemeris": {
"properties": {
"name": {
"const": "astronomy-engine"
},
"version": {
"type": "string"
}
},
"required": [
"name",
"version"
],
"type": "object"
},
"name": {
"const": "@zodiacs/engine"
},
"version": {
"type": "string"
}
},
"required": [
"name",
"version",
"ephemeris"
],
"type": "object"
},
"referenceSpan": {
"properties": {
"from": {
"format": "date-time",
"type": "string"
},
"to": {
"format": "date-time",
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"schema": {
"const": "zodiacs.compute-receipt.v1"
},
"search": {
"properties": {
"bisections": {
"type": "integer"
},
"completeness": {
"const": "tested-not-proven"
},
"maxSamples": {
"type": "integer"
},
"samples": {
"minimum": 0,
"type": "integer"
},
"solver": {
"const": "engine-longitude-crossings"
},
"stepDays": {
"additionalProperties": {
"type": "number"
},
"type": "object"
},
"window": {
"const": "start-exclusive-end-inclusive"
}
},
"required": [
"solver",
"stepDays",
"bisections",
"samples",
"maxSamples",
"window",
"completeness"
],
"type": "object"
},
"timeResolution": {
"properties": {
"pinnedTzdb": {
"type": "object"
},
"policy": {
"properties": {
"fold": {
"const": "earlier"
},
"gap": {
"const": "shift-forward"
}
},
"type": "object"
},
"resolver": {
"type": "string"
},
"runtimeTzdb": {
"type": [
"string",
"null"
]
}
},
"required": [
"resolver",
"policy",
"pinnedTzdb",
"runtimeTzdb"
],
"type": "object"
}
},
"required": [
"schema",
"endpoint",
"engine",
"conventions",
"coverage",
"referenceSpan",
"deltaT",
"conventionIds"
],
"type": "object"
},
"result": {
"properties": {
"events": {
"items": {
"oneOf": [
{
"properties": {
"at": {
"format": "date-time",
"type": "string"
},
"body": {
"enum": [
"Sun",
"Moon",
"Mercury",
"Venus",
"Mars",
"Jupiter",
"Saturn",
"Uranus",
"Neptune",
"Pluto"
]
},
"kind": {
"const": "ingress"
},
"retrograde": {
"type": "boolean"
},
"sign": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
]
}
},
"required": [
"kind",
"body",
"at",
"sign",
"retrograde"
],
"type": "object"
},
{
"properties": {
"at": {
"format": "date-time",
"type": "string"
},
"body": {
"enum": [
"Sun",
"Moon",
"Mercury",
"Venus",
"Mars",
"Jupiter",
"Saturn",
"Uranus",
"Neptune",
"Pluto"
]
},
"degree": {
"type": "number"
},
"kind": {
"const": "station"
},
"lon": {
"type": "number"
},
"sign": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
]
},
"type": {
"enum": [
"retrograde",
"direct"
]
}
},
"required": [
"kind",
"body",
"at",
"type",
"lon",
"sign",
"degree"
],
"type": "object"
},
{
"properties": {
"at": {
"format": "date-time",
"type": "string"
},
"degree": {
"type": "number"
},
"kind": {
"const": "lunation"
},
"lon": {
"type": "number"
},
"sign": {
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
]
},
"type": {
"enum": [
"new",
"full"
]
}
},
"required": [
"kind",
"type",
"at",
"lon",
"sign",
"degree"
],
"type": "object"
}
]
},
"type": "array"
},
"from": {
"format": "date-time",
"type": "string"
},
"to": {
"format": "date-time",
"type": "string"
}
},
"required": [
"from",
"to",
"events"
],
"type": "object"
},
"schema": {
"type": "string"
}
},
"required": [
"schema",
"result",
"receipt",
"backend",
"cite"
],
"type": "object"
},
"completeness": {
"const": "tested-not-proven",
"type": "string"
},
"events": {
"items": {
"additionalProperties": false,
"properties": {
"at": {
"type": "string"
},
"body": {
"type": "string"
},
"degree": {
"type": "number"
},
"kind": {
"enum": [
"ingress",
"station",
"lunation"
],
"type": "string"
},
"localAt": {
"type": "string"
},
"lon": {
"type": "number"
},
"retrograde": {
"type": "boolean"
},
"sign": {
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"kind",
"at",
"localAt",
"sign"
],
"type": "object"
},
"type": "array"
},
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"zone": {
"type": "string"
}
},
"required": [
"from",
"to",
"zone",
"events",
"calculation",
"completeness"
],
"type": "object"
},
"links": {
"items": {
"additionalProperties": false,
"properties": {
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"ok": {
"const": true,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"const": "get_upcoming_events",
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"data",
"links"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryAfterSeconds": {
"type": "number"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"ok": {
"const": false,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"enum": [
"get_capabilities",
"get_sky",
"get_upcoming_events",
"check_sky_fact",
"get_horoscope",
"open_chart_studio",
"get_occasion_sky",
"get_life_milestones",
"get_compatibility",
"find_chart_twins",
"get_famous_chart",
"get_birthday",
"get_sky_calendar"
],
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "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, so it opens before any birth detail is given. It fits a request for a birth chart, a rising sign or a Moon sign when no birth date is in the conversation, and someone who wants to explore their own chart: the person enters the details in the panel, so nothing has to be asked for beforehand. The assistant sees only the parts of the chart the person chooses to share.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "open_chart_studio",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"calculation": {
"const": "browser-local",
"type": "string"
},
"initialChart": {
"const": "birth-details",
"type": "string"
},
"sharing": {
"const": "user-reviewed-selection-only",
"type": "string"
},
"title": {
"const": "Chart Studio",
"type": "string"
}
},
"required": [
"title",
"calculation",
"initialChart",
"sharing"
],
"type": "object"
},
"links": {
"items": {
"additionalProperties": false,
"properties": {
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"ok": {
"const": true,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"const": "open_chart_studio",
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"data",
"links"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryAfterSeconds": {
"type": "number"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"ok": {
"const": false,
"type": "boolean"
},
"schema": {
"const": "zodiacs.ai-tool-result.v1",
"type": "string"
},
"tool": {
"enum": [
"get_capabilities",
"get_sky",
"get_upcoming_events",
"check_sky_fact",
"get_horoscope",
"open_chart_studio",
"get_occasion_sky",
"get_life_milestones",
"get_compatibility",
"find_chart_twins",
"get_famous_chart",
"get_birthday",
"get_sky_calendar"
],
"type": "string"
}
},
"required": [
"schema",
"ok",
"tool",
"error"
],
"type": "object"
}
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:05b99b2378b33a26733029ee29cd662ab439cf2d6e0037b0c990413784c38c01 | sha256sum