Watch a page
set_watch_alarmSets a monitoring alarm on a web page: Rocco checks it on a schedule, keeps what it finds, and rings the person's phone when what they are waiting for comes true (tickets go on sale, a price drops under a number, a page says delivered, reservations open). For anything on the web that no other alarm covers; a post, a price of a token, a trade or an event link each has its own alarm. Pass the page's link and, in the person's words, what to ring for. Rocco proposes what to pull from the page and how often, within the plan's limits. Returns the alarm, what it watches and its link.
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": {
"want": "<want>"
},
"name": "set_watch_alarm"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| link | No | The page to watch. Leave it out for a topic with no single page ("any AI startup raising over $10M"): Rocco finds the sources himself. | |
| 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. | |
| plan | No | A plan already shown to the person and agreed: what to check and how often. Left out, Rocco plans 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. | |
| want | Yes | What to ring for, in the person's words: "tickets go on sale", "price under $150 in size 32", "it says delivered". | |
| brief | No | A brief on a schedule as well as the alarm: Rocco gathers on the topic through the day, and the brief arrives quietly at this time, as a notification and in the Daily Drop, never a ring. The phone still rings only when the alarm's own rule matches. Makes it a monitoring alarm. For a clock alarm whose ring brings the brief, use set_time_alarm with follow instead. | |
| place | No | Where it happens, when the thing watched is somewhere they will go (a show, a game, a festival, a campsite, a trail): "Golden Gate Park, San Francisco". The brief then carries the forecast there. | |
| quiet | No | true for a monitoring alarm that should not ring: what it finds lands in the daily drop instead. Rocco decides from the request when left out (a drop or a sale rings; a slow daily thing stays quiet). | |
| reach | No | Who can ride it: private, friends (people on its list, or with its link) or public (anyone, and it is listed). | 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 | What the alarm says when it rings. Rocco names it from the request when left out. | |
| 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. | |
| 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". | |
| 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. | |
| 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. | |
| 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. |