# engagaloo

> Reference for the engagaloo tool of Engagaloo: every action and what it does.

Source: https://engagaloo.tech/docs/reference/engagaloo/

Engagaloo: Your engagement inbox: one tap to reply, quote, repost or like, and every rating teaches your agent.

Call it as the `engagaloo` tool of the Engagaloo MCP server with `action` and `args`.

## Actions

| Action | What it does |
|---|---|
| `about` | What Engagaloo is and which actions this door offers. |
| `session_create` | Changes: Push a session: rounds with a break after each (up to the plan's round size, settings_get has it; or flat items, split by the person's round size). |
| `session_list` | Reads: Your sessions, newest first, with the count of done, skipped, pending and rated moves. |
| `session_get` | Reads: One session with its rounds and every move's state (done, skipped, pending, stale, cancelled), method, stars, note and rewrite. |
| `session_close` | Changes: Close a session: its pending moves go stale. |
| `session_label` | Changes: Label a session or one round of it: description, tags (at most 10), terms = keywords (at most 20) and a flat metadata map of texts. |
| `session_handles` | Reads: The X accounts the moves of a session aimed at, ready to compare with a follower list. |
| `item_add` | Changes: Add moves to a session: into one round (roundIndex, 0-based like session_get's rounds[].index) or as new rounds. |
| `item_update` | Changes: Fix a move before the person acts: text, alt text, reason, star or excerpt. |
| `item_cancel` | Changes: Withdraw a pending move (a deleted post, a wrong target). |
| `item_status` | Reads: The state of a session's moves (with round types on: the session's type, and the pending moves per type with the gap to each target). |
| `feedback_get` | Reads: Ratings, notes, rewrites, done, skipped and lab results since a cursor (ms), oldest first, each with its move (and the X link mode it was opened with). |
| `feedback_ack` | Changes: Acknowledge feedback events you have read (their ids). |
| `rating_summary` | Reads: The stars since a time. |
| `rewrite_list` | Reads: The person's own rewrites (style examples): the original, the rewrite, the move's type, account and stars. |
| `voice_profile` | Reads: The person's voice as style examples (plus `onboarding`: each handle's voice profile from its onboarding, the same as voice_get). |
| `what_worked` | Reads: What worked since a time. |
| `settings_get` | Reads: The person's settings. |
| `settings_update` | Changes: Change the person's settings, if they allowed this agent (Settings, Agents, per area; all off until they do). |
| `device_replymethod` | Reads: The person's devices. |
| `notify_send` | Changes: Notify the person. |
| `notify_schedule` | Changes: Notify the person, not before a time (`at`, ms epoch, within 30 days). |
| `notify_cancel` | Changes: Withdraw a notification that has not gone out yet. |
| `notifications_mark_read` | Changes: Mark every notification in the person's app list read (the same as "Mark all as read" in the app). |
| `notifications_clear` | Changes: Clear the person's app notification list (the same as "Clear all" in the app, which asks the person first). |
| `launch_list` | Reads: The moves the person opened on X and has not confirmed yet (launched, not done), oldest first. |
| `item_launch` | Changes: Record that the person opened this pending move's action on X (it becomes launched; the app asks about it when they are back). |
| `item_confirm` | Changes: The answer to "Did you do it?" for a launched move. |
| `onboarding_start` | Changes: Start (or switch the mode of) a handle's onboarding: mode "express" (7 questions, a few minutes) or "detailed" (20, by theme). |
| `onboarding_question` | Reads: The next unanswered question of the handle's onboarding (key, theme, English prompt, what it feeds), or with all:true every question of its mode. |
| `onboarding_answer` | Changes: Answer one question for a handle: key and values (a list, one entry per answer, up to 10), or skip:true to skip it. |
| `onboarding_status` | Reads: Where each handle stands. |
| `onboarding_finalize` | Changes: Finish a handle's onboarding once enough questions are answered (at least 3). |
| `voice_get` | Reads: The handle's voice profile from its onboarding. |
| `voice_set` | Changes: Replace one list of a handle's voice profile (the person's edit). |
| `topics_list` | Reads: A handle's topics (or every handle's). |
| `topics_create` | Changes: Add a topic to a handle (the person's plan holds a number of topics per handle: PLAN_LIMIT otherwise). |
| `topics_update` | Changes: Change a topic: any of name, description, searchWords (keywords and hashtags), watch, tone, active, weight, hue. |
| `topics_archive` | Changes: Archive a topic: it leaves every list and no new move can take it; its moves keep it in the history. |
| `topics_focus` | Changes: Whether a handle's next sessions mix its topics or stay on one: mode mixed or single, and for single the topic to stay on. |
| `stats_get` | Reads: The person's day and streak (read-only). |
| `signals_list` | Reads: What the world did that you can turn into a move, newest first. |
| `signals_ack` | Changes: Link a signal to the move you made from it (the signal becomes used, the move carries its source tag). |
| `signals_dismiss` | Changes: Close a signal you will not act on, with a reason (a text of at most 300 characters). |
| `radar_add` | Changes: Put a fresh post on the person's radar. |
| `radar_list` | Reads: The posts on the radar, newest first. |
| `stats_analytics` | Reads: What the person's moves earned (read-only). |
| `lists_get` | Reads: The person's two lists of X accounts. |
| `lists_set` | Changes: Change one list: { list: "vip" \| "blacklist", add: [...], remove: [...] } or { list, set: [...] } for the whole list. |
| `fill_get` | Reads: How to fill the person's queue. |
| `types_list` | Reads: The person's round types (named, reusable kinds of session; the starters are "Likes only" and "Mix"). |
| `types_create` | Changes: Create a round type: a name and its rules (all optional: every move type, no counts, quotas or split, the default round size). |
| `types_update` | Changes: Change a round type, by its name or id. |
| `reports_list` | Reads: The links the person reported as not working (a bug icon on a move). |
| `report_resolve` | Changes: Record what a link report turned out to be. |
| `boost_get` | Reads: Whether the person is in Boost mode (working hours: no waits or pace reminders, one tap opens X and marks the move done). |
| `boost_set` | Changes: Switch the person's Boost mode on or off: { on: true\|false }. |
| `round_reactivate` | Changes: Make an EXPIRED round active again for `hours` from now (default 12, at most 72). |

> [!TIP]
> Ask for the exact arguments of any action with `action: "help", of: "about"`. The server answers from its own definitions, so that answer is always current.