The sky on a day
get_occasion_skyDescribes 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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"occasion": "<occasion>"
},
"name": "get_occasion_sky"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | The day, such as 2027-09-18 (years 1800–2199). Needed unless searchFrom and searchTo are given. | |
| time | No | The local clock time, such as 16:30, if the person gives one. Needs zone. | |
| zone | No | The place's time zone, such as Europe/Lisbon. Needed with a time or a place. | |
| names | No | Optional: up to two first names to print on the card, only if the person asks for them. Display only, not stored. | |
| place | No | Optional place name printed on the card, such as Lisbon, Portugal. Display only: it is not used in the calculation and is not stored. | |
| latitude | No | Optional. The place's latitude, used only to work out sunset, golden hour and the evening sky there. Give it with longitude and zone. Nothing is stored. | |
| occasion | Yes | What the day is: wedding, anniversary, met (the day they met), birthday, pet, home, job, graduation, retirement or gathering. | |
| searchTo | No | The last day of the window to search, such as 2027-09-30, at most 92 days after searchFrom counting both days. Every day is rated and the three best come back. | |
| longitude | No | Optional. The place's longitude, with latitude, for the evening sky. Nothing is stored. | |
| searchFrom | No | To find the best days: the first day of the window to search, such as 2027-09-01. Give it with searchTo. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||