Available tools
The 35 tools available to connected assistants, with required permissions.
Moves
| Tool | Permission | What it does |
|---|---|---|
moves_home | moves:read | Read your open move, ideas, and bounded feed of moves shared with you. |
move_get | moves:read | Read a visible live move by moveId; unavailable moves return null. |
move_create | moves:write | Share an open move or idea with a chosen audience. |
move_update | moves:write | Edit your live move's title or timing. |
move_end | moves:write | End your move and remove it from live feeds. |
move_set_interest | moves:write | Set or withdraw your interest in a move shared with you. |
Creating an open move ends your previous open move; you can have up to five live
ideas. Choose now, tonight, or weekend, or use later for an idea with dates.
expiresAt is a future Unix timestamp in milliseconds, chosen for the user's
intended time and timezone. Later dates use { kind: "month" | "dates", startDate, endDate } with YYYY-MM-DD strings. The backend validates the date range and expiry.
title is text up to 80 characters or null. Updates leave omitted fields unchanged;
null clears a title. Changing timing may also require changing expiresAt.
Audiences are friends, friendsOfFriends, or selected. For selected, pass
selectedUserIds from your mutual friends. To share with a crew, read its
memberIds and pass them as selectedUserIds; crewId alone only updates recency.
The audience is fixed when a move is created, and editing a crew does not change it.
Interest is private: only the move's author sees who responded. Other viewers see the count and their own response. Interest can notify the author and is not an RSVP or a commitment to attend.
Friends and activity
| Tool | Permission | What it does |
|---|---|---|
friends_list | connections:read | List mutual friends and their user IDs. |
connections_incoming | connections:read | List people waiting for you to add them back. |
connections_list | connections:read | Read incoming, outgoing, and mutual relationship states. |
connection_add | connections:write | Add a known user; becomes a friendship if they already added you. |
connection_remove | connections:write | Remove your connection and its friendship access. |
activity_get | activity:read | Read incoming adds and private interest in your live moves, up to 50 each. |
Adding someone may notify them. Removing a friendship also removes each person from the other's live move audiences, interests, and crews. The tools do not upload contacts or search arbitrary phone numbers.
Private crews
| Tool | Permission | What it does |
|---|---|---|
crews_list | crews:read | List your crews and current friend member IDs, most recently used first. |
crew_create | crews:write | Create a crew with at least one mutual friend. |
crew_update | crews:write | Edit a crew's name, color, emoji, or member list. |
crew_set_membership | crews:write | Put one friend in exactly the specified crews you own. |
crew_remove | crews:write | Delete your crew without removing friendships. |
Crews are private audience shortcuts, not shared groups. Creation takes name,
color (blue, pink, or yellow), emoji (text or null), and memberIds.
Updating memberIds replaces the entire list; omitted fields stay unchanged.
For crew_set_membership, an empty crewIds array removes the person from all
your crews. Crew changes do not notify members or alter existing move audiences.
Connection invites
These tools invite people to become friends. They do not invite someone to attend a move.
| Tool | Permission | What it does |
|---|---|---|
invite_create | invites:write | Create an invite and return its private token once. |
invite_preview | invites:read | Preview an invite by token without accepting it. |
invites_list | invites:read | List your active invites; tokens are not recoverable. |
invite_requests | invites:read | List claims and applicants for an invite you own. |
invite_accept | invites:write | Accept a named invite or request approval for an open invite. |
invite_cancel | invites:write | Cancel your pending claim. |
invite_decide | invites:write | Approve or decline a claim on your invite. |
invite_revoke | invites:write | Stop further acceptance or approval of your invite. |
invite_create accepts optional recipientId, maxUses (1–20, default 1), and
ttlSeconds (60–604,800, default 604,800 / seven days). Named recipients require one use and can
accept directly; open invites need the creator's approval. Acceptance or approval
can create mutual friendship and notifications. Treat the returned token as a
private bearer secret and share it only with intended recipients.
Repeating acceptance returns the existing claim; it never restores a removed friendship. Cancelling marks a pending claim declined, and accepting the same invite again does not resubmit it. Decisions cannot change an already decided claim. Revoking an invite does not remove existing friendships.
Example requests
- “Who's open tonight?” —
moves:read. - “Share a coffee idea with my Weekend crew.” —
crews:readandmoves:write. - “Show who's interested in my moves.” —
activity:read. - “Create a one-hour connection invite for one person.” —
invites:write.
Confirm the intended audience and timing before sharing. After an uncertain create result, inspect moves, crews, or invites before retrying: creating again can duplicate records. An invite's raw token cannot be recovered from its list.
Profile settings
These tools work with your private settings. They do not manage other people's profiles or delete your Moves account.
| Tool | Permission | What it does |
|---|---|---|
profile_get | profile:read | Read your settings; returns null if none exist. |
profile_create | profile:write | Create settings; fails if they already exist. |
profile_update | profile:write | Change existing settings. Omitted fields stay unchanged; null clears text. |
profile_remove | profile:write | Delete your settings, not your account. |
Feedback
Assistants can only access feedback that belongs to your account.
| Tool | Permission | What it does |
|---|---|---|
feedback_get | feedback:read | Read one entry by ID; returns null if unavailable. |
feedback_list | feedback:read | List your feedback, newest first. |
feedback_create | feedback:write | Send a message of 1–5,000 characters. Category defaults to other. |
feedback_update | feedback:write | Change a message or category by ID. |
feedback_remove | feedback:write | Permanently delete an entry by ID. |
For feedback_list, request 1–100 items with paginationOpts. Start with
cursor: null; use the returned continueCursor until isDone is true.
{
"paginationOpts": {
"numItems": 10,
"cursor": null
}
}If sending feedback times out, check your feedback list before trying again. A repeated create request can create another entry.
Current screen
| Tool | Permission | What it does |
|---|---|---|
get_current_context | context:read | Read a snapshot from the source you selected for this assistant. |
The snapshot includes its update and expiry times. It can be null if you have not selected a source, the source expires, sharing stops, or the session ends. An assistant should ask what you mean when no context is available.
Tool discovery
Your assistant discovers the current argument schemas directly from the server. Tool visibility does not grant access: every call checks the connection, permission, and ownership. If a tool needs more access, your assistant must request it through a new consent flow.