Set a sun & moon alarm
set_sun_alarmDestructive
Sets a sun & moon alarm: it rings on the person's phone at a sun or moon moment at a place, or up to two hours before or after it: "an hour before sunrise in Yosemite", "golden hour in Lisbon every day", "moonrise on the next full moon", "sunrise on every June solstice", "the Perseid meteor shower", "when Mercury retrograde ends". The moment is computed for the place each day and rings for everyone at once, at the alarm's place. Once on a date, on repeating days, or, with neither, at the next one. A day the event does not happen there (a polar day or night) is skipped. People added to a friends alarm are notified. Returns the alarm, when it next rings, its link and a share picture.
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": {
"event": "<event>"
},
"name": "set_sun_alarm"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| on | No | Only on this kind of day at the place: fullMoon, newMoon, supermoon, marchEquinox, juneSolstice, septemberEquinox, decemberSolstice. With repeat_days it rings on every one; without, on the next one. "Moonrise on the full moon" is event moonrise with on fullMoon. | |
| date | No | A one-off's day at the place, "2026-11-02". Not used for a repeating alarm. | |
| note | No | A note from the person about the alarm, in their words, shown under its trigger on the alarm's page and in the Daily drop. Up to 500 characters; an empty note clears it. | |
| vibe | No | The feel of the alarm in a few words, and the kind of background and colour if the person named them: "fun poppy anime", "calm", "a simple bell", "hype for a token launch", "ocean waves, purple", "neon and chaotic". LFG picks a sound and a look from its library to match: a live, moving wallpaper when one fits, otherwise a drawn one. Wallpaper words given here replace the look's words; a colour given here makes it a plain gradient in that colour. | |
| event | Yes | A moment of the day: sunrise; sunset; goldenHour (evening golden hour starts); goldenHourEnd (morning golden hour ends); solarNoon (the sun at its highest); dawn (civil twilight starts); dusk (civil twilight ends); nightEnd (first light); night (night starts); moonrise; moonset; moonTransit (the moon at its peak, when it is up). Or a sky event, which comes round on its own and needs no days: mercuryRetrograde, mercuryDirect (Mercury retrograde ends), and the same for venus, mars, jupiter and saturn (each rings 9am on the day it turns); quadrantids, lyrids, etaAquariids, perseids, orionids, leonids, geminids (meteor showers, 2am the morning after the peak night); supermoon (at moonrise); marchEquinox, juneSolstice, septemberEquinox, decemberSolstice (at the exact minute). For a sky event, repeat_days with all seven days means every time it comes round. | |
| place | No | Where the sky is watched, only when the person named one: a city, park, beach or address, "Yosemite". Coordinates as "37.75, -119.59" work too. Left out, the person's own place is used. | |
| reach | No | Who can join: private (only the person), friends (people on its list, or with its link), public (anyone; listed in Discover). | private |
| sound | No | The shelf of our library closest to the sound they asked for, read for what they mean: lo-fi or study beats is music/chill, "make it a vibe" might be music/chill, music/rnb or music/beats, hype me up is voices/hype_man, yelling at me is voices/drill_sergeant. "own" for one of their own uploads ("my song"). "soundcloud" when they asked for SoundCloud, or no shelf is close: a genre we have no shelf for (k-pop, drum and bass), or an artist or a song by name; put what to look for in song_search, and they play SoundCloud songs and tap one. Leave it out when they said nothing about the sound. A song from Apple Music, or a song or voiceover made for them: leave this out, make the alarm, and say they get it in the alarm's Studio, under its sound, after Arm it. Never say you will make one. The wallpaper follows the song unless one is asked for. | |
| theme | No | A theme or holiday: the alarm gets a song in its moods, a new alarm a title written for it, and a wallpaper dealt for it for variety, one of the theme's pictures, a GIF, a live wallpaper or a gradient. A vibe given as well shapes that ("cozy", "degen"); wallpaper words or a title given are kept. One of: birthday (Birthday), love (Love), night_out (Night out), shopping (Shopping), winter (Winter), christmas (Christmas), hanukkah (Hanukkah), diwali (Diwali), halloween (Halloween), thanksgiving (Thanksgiving), friendsgiving (Friendsgiving), new_years (New Year's Eve). | |
| title | No | Short name for the alarm, "Half Dome sunrise". Write one that fits what they asked, fresh each time, 2 to 6 words (never just the time). When absent, LFG names it. | |
| surprise | No | For a friends alarm: keep it a surprise. People who join see a curtain instead of its title, picture, sound and note until it rings. Free on every plan. | |
| link_mode | No | For a friends alarm, what its link does: open (anyone who opens the link rides along, the default) or approve (anyone else with the link asks first and the person says yes or no). Invited people walk straight in either way. | |
| add_groups | No | For a friends alarm: names of the person's friend groups whose members to let in, "Family". Members get a notification. | |
| add_people | No | For a friends alarm: up to 20 people to let in, as usernames of the person's LFG friends or as email addresses. Friends get a notification; an email address with no LFG account gets an invitation. Any other username is refused. | |
| gif_search | No | 2 to 5 plain words to search GIFs with, written for this alarm, "solana pump celebration", "sleepy cat monday": used if the look dealt is a GIF, which has no words of its own. Fill it whenever you make an alarm. | |
| look_words | No | Short words of your own for the wallpaper, written for this alarm, "SOL TO THE MOON", "EXAM DAY", "BEACH BY 6": used if the look dealt is a live wallpaper or a gradient, in place of its own words. 2 to 4 words. Unlike wallpaper_words, the look is still dealt. Fill it whenever you make an alarm. | |
| button_link | No | ||
| repeat_days | No | Days a repeating alarm rings, ["sat","sun"]; all seven for every day. Not used for a one-off. | |
| song_search | No | With "soundcloud": what to look for there, in their words, "k-pop", "fred again". | |
| upload_name | No | With "own": the name they gave the upload, "my dog picture". Left out, one of theirs is used. | |
| words_color | No | Colour of the words as hex, any colour, "#D7FF00". | |
| hide_trigger | No | Needed with surprise, true or false: whether to also keep back when and why it rings, so people who join only know that it will. A surprise is not made until it is given. | |
| snooze_times | No | How many times it can be snoozed: 3, 10 or unlimited. | |
| silent_snooze | No | true to snooze without the spoken roast LFG plays by default. | |
| offset_minutes | No | Minutes from the event: -60 is an hour before, 30 is half an hour after, 0 is at it. | |
| snooze_minutes | No | Minutes each snooze lasts: 5, 10, 15, 30 or 60. | |
| wallpaper_kind | No | Only when they named a kind: a gradient, a live (moving) wallpaper, a gif or meme, or "own" for one of their own uploads ("my wallpaper", "the picture I uploaded"). Left out, LFG deals one of every kind in turn. | |
| send_beacons_to | No | A webhook the person got from the other side (a Discord channel's hook, a Zapier catch hook, their own agent's address): every beacon on this alarm is POSTed there as JSON, signed with the alarm's horn token. Public https only. An empty string stops it. | |
| wallpaper_color | No | Wallpaper background colour as hex, any colour, "#5B2BFF". | |
| wallpaper_words | No | Words drawn on the wallpaper, "WAKE UP"; a line break starts a new line. Up to 40 characters; it looks best as 1 to 4 short words, since the words are drawn as large as the square allows. | |
| people_confirmed | No | Whether the person has confirmed the people and groups being added. Nobody is added or told without it. |