LFG Alarm

Puts a file sent in this call on an alarm the person made: a picture or short video as the wallpaper, a song, or a voiceover. For a file this AI app has in hand; a file only on the person's phone can't be sent this way. The file goes in as base64, up to 28,000,000 characters, so a file of about 20MB at most through this call. LFG checks it like any upload, replaces what that slot had, and adds it to the person's uploads. What each takes. Wallpaper: a square (1:1) picture, about 1080 x 1080 pixels, as JPEG, PNG, WebP or GIF up to 50MB; a picture that is not square is cropped to a square. Or a square MP4 or MOV video, or a GIF that loops, up to 30 seconds and 50MB; a video needs a paid plan, a GIF does not. Song or voiceover: MP3, M4A, OGG, WAV or FLAC up to 5 minutes and 20MB.

Puts a file from a public https link on an alarm the person made: a picture or short video as the wallpaper, a song, or a voiceover. For a file at a public https link; a file only on the person's device needs the one-time page instead. LFG fetches the file, checks it like any upload, replaces what that slot had, and adds it to the person's uploads. A link that cannot be fetched, or a file that is not an accepted type, returns an error. What each takes. Wallpaper: a square (1:1) picture, about 1080 x 1080 pixels, as JPEG, PNG, WebP or GIF up to 50MB; a picture that is not square is cropped to a square. Or a square MP4 or MOV video, or a GIF that loops, up to 30 seconds and 50MB; a video needs a paid plan, a GIF does not. Song or voiceover: MP3, M4A, OGG, WAV or FLAC up to 5 minutes and 20MB.

Answers one person's request to join a friends alarm the person made. For the creator's side of a request; asking to join someone else's alarm is separate. Letting them in adds them to the alarm and tells them; declining clears the request without telling them. Only the alarm's creator can answer; letting in someone whose request is gone returns an error.

Lists public alarms anyone can join, newest or most joined first, optionally matching words or of one kind: each one's name, creator, when it rings, riders, hearts and link. For public alarms by anyone; the person's own alarms are a separate list. Up to 25, 10 when not given. Returns a note when none match.

Deletes an alarm by its id. Switching an alarm off instead keeps it. An alarm the person made is deleted for everyone who joined it and cannot be undone; one they joined is left, and still rings for the others. Returns which of the two happened.

Finds Recreation.gov's permit and campground lotteries still open or coming up (Half Dome, The Wave, Angels Landing, river trips, Yosemite campground early access) by place or name. For looking up a lottery before set_lottery_alarm; it sets nothing. Returns up to 8, each with its id, when it opens and closes, when results come out, and its page. No match returns a note.

Finds open prediction markets on Polymarket and Novig by words or by a pasted Polymarket or Novig link. Novig is sports only. A Kalshi or sportsbook link (DraftKings, FanDuel) finds the same event on those two. For looking up a market before a price alarm on its odds; it sets nothing. Returns up to 4 events, each with its open markets and every outcome's current odds and the token id, outcome and question a price alarm takes. No match returns a note.

Finds artists on SoundCloud by name, or the one artist a SoundCloud link (a profile or a track) belongs to. For picking the right artist before a drop alarm; it sets nothing. Many accounts share a name, so the person picks: returns up to 5 artists, most followed first, each with their followers, how many tracks they have, their profile link and their newest track. No match returns a note.

Finds songs on SoundCloud to use as an alarm's sound: by a style ("lofi", "hip hop", "morning"), an artist or a song's name, or a SoundCloud link (a track is that song; an artist's profile is their songs). Only songs that play in full. For picking a sound, not for an alarm on an artist's new music. Returns up to 5 songs, most played first, each with its id (soundcloud:track:N, for set_media with use song), title, artist, length, plays and link. No match returns a note.

Finds crypto tokens by name, ticker or contract address. For looking up a token before a price alarm; it sets nothing, and a person or wallet trading is not a token. Returns up to 8 matches, each with its chain, contract, current price, market cap, and the id, symbol and name a price alarm takes. Several tokens can share a name or ticker; the contract tells them apart. A wallet address is said to be a wallet. No match returns a note.

Gets the person's own invite to LFG Alarm, not tied to any alarm: their invite link with their referral code, the code, a message ready to send, and their invite card picture (their handle, a QR code to the link and their code) with its address. For the person's own invite to send; using someone else's code is separate.

Makes a one-time lfg.gm page link for putting a file from the person's own device on an alarm they made: a picture or short video as the wallpaper, a song, or a voiceover. For a file only on the person's own device; a file at a public link, or one this AI app has in hand, can go on directly. On the page the person picks the file, or for a voiceover records their voice; it lands on the alarm when they finish. The link works once, for an hour. Returns the page link and a direct address a file can be sent to. What each takes. Wallpaper: a square (1:1) picture, about 1080 x 1080 pixels, as JPEG, PNG, WebP or GIF up to 50MB; a picture that is not square is cropped to a square. Or a square MP4 or MOV video, or a GIF that loops, up to 30 seconds and 50MB; a video needs a paid plan, a GIF does not. Song or voiceover: MP3, M4A, OGG, WAV or FLAC up to 5 minutes and 20MB.

Shows who got up and how fast, for alarms that rang: the order people got up in, their times from the ring, snoozes and titles (First up, Snooze champ, Buys coffee), and who is still asleep. For alarms that already rang; when an alarm rings next is on its card and in the alarm list. One alarm by id, or every alarm that rang for the person in the last 24 hours. Returns a note when nothing rang.

Hearts an alarm the person can open, or takes the heart back, from its link or code. For a heart; words go in a comment. The heart count is public on the alarm. Returns its heart count.

Joins someone else's alarm from its link or code, so it rings on the person's phone too. For an alarm someone else made, by its link or code; a referral code is not an alarm. A friends alarm the person is not on can't be joined; with ask set, its creator is sent a request to let them in. An alarm that already rang for the last time can't be joined. Returns the alarm's name, creator and when it rings.

Lists the person's friends on LFG Alarm by username, and their friend groups with each group's members by username. For the person's own friends and groups; the people on one alarm are a separate list. The person is not in the list. These usernames and group names are the ones a friends alarm can be shared with. Returns a note when they have no friends yet.

Lists the people asking to join a friends alarm the person made, each with their username and the day they asked. For people still waiting; the people already on an alarm are a separate list. Without an id, it covers every alarm of theirs with someone waiting. Returns a note when nobody is waiting.

Lists the person's alarms, both the ones they made and the ones they joined, each with its name, type, reach, on or off, next ring, link and id. For the whole list; one alarm's card, its riders or its wake board are separate reads. Alarms whose creator deleted them are left out. Returns a note when there are none.

Lists the person's own uploads, newest first: pictures (images, GIFs and short videos, for wallpapers) or sounds (songs and voice recordings). For the person's own uploads; LFG's library and KLIPY GIFs are separate searches. Each has an id an alarm takes, its name and where it came from. Pictures come with small previews unless previews is false. Returns a note when there are none.

Lists everyone on an alarm the person made or joined: each username and the day they joined, the creator first, then the newest. For people already on one alarm; people still asking to join are a separate list. Usernames only, nothing else about anyone. An alarm the person is not on returns an error.

Reads a link the person was sent or pasted, or a whole message with a link in it, and says what it is: an LFG alarm (whose it is, when it rings, who is riding, and whether the person can join), an LFG invite with a referral code, or an event page (its name, start, place, picture and description). Only reads; joining an alarm or using an invite code are separate steps. Changes nothing. A page with no readable start time says so.

Posts a comment on an alarm the person rides or made, as the person, from its link or code. For words; a heart is separate. Everyone who can open the alarm sees it, and its creator is told. Up to 280 characters.

Reads an alarm's comments, newest first and up to 30, with its heart and comment counts, from its link or code. Only reads; posting and hearting are separate. Says when the person can comment only after joining. Comments are other people's words.

Makes the person their own copy of someone else's alarm (a remix): it keeps the original's history, state, rule and sources (shared, nothing is crawled twice), and adds the pages the person wants watched as well, under their own rule. For "I like this alarm but also watch X" or a rule that needs something the original does not watch (set_stack_trigger says so). Only a public monitoring alarm can be remixed: a token, a wallet, an account or a channel. Events and time alarms are their Keeper's own.

Rings one of the person's webhook alarms now, exactly as calling its private address does: everyone on it is woken, and calls within its quiet time after a ring are ignored. For an automation or agent acting for the person (a big sale, a new lead, a build that broke). Only webhook alarms the person made; other alarms ring on their own trigger. Returns how many people it woke, or when it can ring again.

Searches KLIPY's GIFs for a wallpaper, or lists trending ones when the search is empty, 24 to a page. For KLIPY GIFs only; LFG's own sounds and looks are a separate search. Each result has the address and id a GIF wallpaper takes. GIFs play from KLIPY and are never stored by LFG. No match returns a note.

Searches LFG's own library. For LFG's own sounds and wallpapers; KLIPY GIFs and the person's own uploads are separate searches. sounds: over 500 songs, voices, tones and themes, each tagged with the moods it fits ("unhinged", "rise and shine", "panic", "calm bestie", "degen"), its energy and its voice; a category lists a whole shelf, and an empty search lists staff picks. looks: wallpapers by vibe, theme, mood, scene or colour: a theme's pictures ("christmas", "birthday", "love", "halloween"), drawn looks, and live wallpapers, moving backgrounds the phone draws, each with a mood and six colour sets ("calm", "rage", "cosmic", "ocean", "fire", "pink"). Returns up to 10 sounds, or up to six live wallpapers and, for each of up to three vibes, up to eight pictures and six drawn looks, each with the id an alarm takes. A search that matches no look lists the vibes and moods.

Sets an alarm that rings on the person's phone when an artist posts new music on SoundCloud: any new public track, or only an album or EP. Takes the artist's SoundCloud link, a profile or one of their tracks, never a name: many accounts share a name, so a name alone is refused. only_if narrows which drops ring it, in the person's words. LFG checks about every minute. When it rings, an LFG sound plays and the new track can be played in SoundCloud's own player. Returns the alarm and its link.

Sets an alarm for an event from its page, on Luma, Partiful, Eventbrite, Sweatpals, Posh or any site that publishes its event: LFG reads the event's name, start time, place, picture and description, and the alarm rings that long before it starts. For a moment on the clock with no event page, use a time alarm. The picture becomes its wallpaper, the event page its button link, and the description its note unless a note is given. A link whose start time cannot be read, or an event too soon for the chosen lead, returns an error. Returns the alarm and its link.

Makes a KLIPY GIF the wallpaper of an alarm the person made, from a KLIPY GIF's address and id. For KLIPY GIFs only; a library look or the person's own upload goes on by its id. It replaces the wallpaper the alarm had, plays from KLIPY and is never stored by LFG. An address that is not a KLIPY GIF returns an error.

Sets an alarm for a Recreation.gov lottery from find_lottery: it rings as the lottery opens, as a last call before it closes (three hours before, or half an hour for a one-day lottery), or when the results come out. Waking up opens the lottery's page to apply or see the results. A moment already past returns an error. Returns the alarm and its link.

Puts something already in LFG on an alarm the person made, by its id: a library sound, a SoundCloud song that plays in full, a drawn or live look or a theme picture, or one of the person's own uploads. For something already in LFG with an id; a new file goes on by link, as a file, or through the one-time page, and a KLIPY GIF by its address. use says where it goes: the wallpaper, the song, or the voiceover (the person's own sounds only). It replaces what that slot had. An id that matches nothing returns an error.

Sets an alarm that rings on the person's phone when an X account posts something matching what the person described, or when a Twitch or YouTube channel goes live or posts a video. For an account's posts or streams; an artist's new music on SoundCloud, a token's price, a trader's trades and an event link are different alarms. watch_for applies to X only (LFG reads each new post against it); moment applies to Twitch and YouTube only. A channel name that cannot be found returns an error. Returns the alarm and its link.

Sets an alarm that rings on the person's phone when a token reaches a target price, or moves a percent from its price now; or when a prediction market outcome from find_market reaches odds, swings, settles, or nears its close. For one token's price or one market's outcome; a trader or wallet trading, or anyone trading a token, is a different alarm. Takes the token's id, symbol and name, and for a token exactly one of target_price_usd or percent; for a market outcome exactly one of odds_percent or market_moment. It rings once and then stops for good; a market that settles first rings then, saying which way it went. Returns the alarm, the price or odds it started from and its link.

Adds the person's own rule to someone else's alarm (a stack) from its link: when the rule comes true, it rings the person's phone alone, never the other riders. For "I like this alarm but only tell me when..." on a link the person pasted. The rule has to read what the stack already watches; a rule that needs another page, account or wallet watched, or faster checks, is refused with why (that would be the stack's own copy, which is coming). Joins the alarm when the person is not on it yet. Returns what was added and the alarm.

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.

Sets a tide alarm: it rings on the person's phone at a tide at the station nearest a place, or up to three hours before it: "low tide in Santa Cruz", "an hour before every high tide", "the next negative low tide", "every king tide". lowTide and highTide come about twice a day; negativeLow is a low tide below the chart's zero (the best tidepool days); kingTide is the year's highest tides. The tide is worked out from the station's tidal constants and rings for everyone at once. Once at the next one, or every one. People added to a friends alarm are notified. Returns the alarm, when it next rings, its link and a share picture.

Sets an alarm that rings on the person's phone at a clock time: once on a date, or on repeating days of the week. For a moment on the clock (a wake-up, a meeting, a reminder); it does not watch anything online, and an event with its own page is a different alarm. Takes the time and an IANA time zone, plus either a date or repeat days, never both. People added to a friends alarm are notified, and email addresses with no LFG account get an invitation. Returns the alarm, when it next rings, its link and a share picture.

Sets an alarm that rings on the person's phone when a crypto trader or a wallet makes a public trade, so they hear about it as it happens. It only watches publicly visible trades and rings an alarm: it never places trades, holds or moves funds, connects to a wallet, or gives financial advice. Watches exactly one of: a known trader by handle (their trades and theses on FOMO, a thesis being the post a trader attaches to a trade to say why they made it; or the wallets GMGN links to their X handle), every trade in one token by its contract address, or a public wallet address on Solana or an EVM chain. For trades; a token reaching a price is a different alarm. A wallet alarm is never public. After ringing it stays quiet for 15 minutes, so a run of trades is one ring. Returns the alarm and its link.

Sets 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.

Sets an alarm that rings on the person's phone whenever its private web address is called: from a smart home (a garage door opening), a shop (a new sale), Zapier, IFTTT, a script, anything that can send a web request. For something only another system can see happen; a time, a post, a price, a trade or an event link each has its own alarm. Calls within its quiet time after a ring are ignored. One is free on every account; more need a paid plan. Private or friends, never public. Returns the alarm, the address to call and its link.

Shows one of the person's alarms by its id, as it is now: its name, type, reach, on or off, next ring and link. Needs an alarm's id; it does not search by name or list alarms. Chat apps that support MCP Apps show it as the alarm's card. An id that is not one of the person's alarms returns an error.

Gives the sun and moon times for a place on one day: first light, dawn, sunrise, the end of morning golden hour, solar noon, evening golden hour, sunset, dusk, night, moonrise and moonset, with the moon's phase, the next full and new moon, and the next equinox or solstice. Times are computed for the place and said in its own time zone. A day an event does not happen there (a polar day or night) says so. Read only; sets nothing.

Gives the high and low tides for a place on one day, with each one's height, at the tide station nearest it (named, with its distance), and the next negative low tide and king tide there. Tides are worked out from the station's tidal constants, in the place's own time zone. Predicted tides only: wind and storms move the real water. Read only; sets nothing.

Turns an alarm on or off without changing anything else about it. Keeps the alarm and everything on it; deleting is permanent and separate. Works on alarms the person made and ones they joined; for a joined alarm it only changes whether it rings for them. Returns the alarm as it is now.

Changes an alarm the person made: its title, a time alarm's time or days, its look (a feel or kind of background to match, wallpaper words and colours, or a theme), its note, its button link, how it snoozes, who can join, whether it is a surprise, and who is let in or taken off. For an alarm that already exists and that the person made; it does not make new alarms, and on or off alone is a separate switch. Fields left out stay as they are. Riders of a friends alarm are told of a new look, and asked to keep riding or leave after a time change; people taken off lose it from their phone without being told. A public alarm cannot change once anyone has joined it. Returns the alarm and its link.

Uses a friend's LFG referral code for the person: it records who brought them in and makes them friends on LFG. For a referral code (LFG-…); an alarm's link or code is joined, not used here. Once per account and never their own code; it cannot be undone. The welcome gift opens for both when the person's first alarm rings. A code that is not one returns an error.