These are the tools your agent can call once it’s connected. You don’t call them yourself: describe what you want and the agent picks the tools.
The permission rule
Every tool checks the same permission as the matching action in the Spool app. An agent can only see teams you can see, and can only write where your role allows it. If a call is refused, the agent gets a permission error and should tell you rather than work around it.
Two more rules apply:
- A Read only connection can call the read tools only. Write and delete tools are refused.
- Delete tools are marked as destructive, so clients that support it ask you before running them.
If you’re in more than one workspace, each tool takes a workspace (its URL slug). With one workspace it’s picked for you.
Context
| Tool | What it does | Needs |
|---|---|---|
whoami |
You, what this connection may do, and your workspaces. Agents call it first. | Signed in |
list_teams |
Teams you can see, with their keys. | Workspace member |
list_team_members |
People in a team, with the ids used for assignees and mentions. | Team member |
list_members |
Everyone in the workspace, with roles. | See the member directory |
list_roles |
Workspace and team roles. | See the member directory, or manage people or roles |
list_statuses |
A team’s statuses. | Team member |
list_work_item_types |
Work item types, with each type’s description template. | Workspace member |
Items
| Tool | What it does | Needs |
|---|---|---|
search |
Search items, docs and meetings across your teams. | Workspace member |
list_items |
One project’s items, with filters and paging. | Team member |
list_my_items |
Items assigned to you, across teams. | Workspace member |
get_item |
An item as markdown, with its links. | Can see the item |
create_item |
Create an item in a project. | Create items |
update_item |
Change an item’s fields, including its sprint. | Edit and move items |
bulk_update_items |
Apply the same change to several items in one team. | Edit and move items |
move_item |
Move an item to another project or team. | Edit and move items |
delete_item |
Permanently delete an item. | Delete items |
Comments, links and history
These work on items, docs and meetings (and artifacts, for comments on files).
| Tool | What it does | Needs |
|---|---|---|
list_comments |
Comment threads on a record. | Can see the record |
add_comment |
Comment, or reply to a comment. | Comment |
update_comment |
Edit a comment. Only its author can. | Comment |
resolve_comment |
Resolve or reopen a thread on a doc. | Comment |
delete_comment |
Delete a comment. | Comment (others’ comments need delete rights) |
list_links |
What a record is linked to. | Can see the record |
add_link |
Link two records: blocks, duplicates, relates or derived from. | Edit the record |
remove_link |
Remove a link. | Edit the record |
get_timeline |
A record’s history: who changed what, and when. | Can see the record |
Projects and sprints
| Tool | What it does | Needs |
|---|---|---|
list_projects |
A team’s projects. | Team member |
get_project |
One project’s details. | Can see the project |
create_project |
Create a project in a team. | Create projects |
update_project |
Rename a project or change its description. | Create projects |
archive_project |
Archive a project, which blocks new writes to it. | Archive projects |
list_sprints |
A project’s sprints with dates, goal, capacity and points. | Team member |
Agents plan items into a sprint through create_item, update_item and bulk_update_items. Creating, starting and completing sprints happens in the app.
Meetings
| Tool | What it does | Needs |
|---|---|---|
list_meetings |
Your meetings, or a project’s. Newest first. | Workspace member |
get_meeting |
One meeting with its summary and transcript. | Can see the meeting |
update_meeting |
Rename a meeting, replace its tags, or file it into a project. | Can edit the meeting |
Docs
| Tool | What it does | Needs |
|---|---|---|
list_docs |
A project’s docs and their state. | Team member |
get_doc |
A doc’s draft as markdown, or a published version. | Team member |
create_doc |
Create a doc. It starts as an unpublished draft. | Create docs |
update_doc |
Rename a doc or replace its draft. | Edit and publish docs |
publish_doc |
Publish the draft as the next version. Agents are told to ask you first. | Edit and publish docs |
list_doc_changes |
Who changed the draft, and when. | Team member |
Artifacts and files
| Tool | What it does | Needs |
|---|---|---|
list_artifacts |
A project’s folders, files and links. | Team member |
get_artifact |
One artifact, with a short-lived download link for files. | Team member |
create_folder |
Create a folder. | Add artifacts |
add_link_artifact |
Save a link in the project’s artifacts. | Add artifacts |
add_file |
Put an uploaded file in the project’s artifacts. | Add artifacts |
update_artifact |
Rename or move an artifact, or edit a link. | Rename and move artifacts |
delete_artifact |
Permanently delete a file, link or folder and everything in it. | Delete artifacts |
create_upload |
Start uploading a file, up to 50 MB. | Workspace member |
complete_upload |
Finish an upload and get the markdown to embed it. | Workspace member |
The “Needs” column uses the permission names from Roles in workspace settings. See Roles and permissions for which roles have them.
What agents can’t do
Agents can’t change workspace or team settings: roles, invitations, members, teams, statuses and work item types are read-only. They also can’t delete projects or docs, share docs or artifacts outside the team, or undo, restore or discard doc changes. Creating, starting and completing sprints stays in the app too.
Prompts
The server also offers two prompts you can pick in clients that support them: Write an item (how to write a clear item) and Log a decision (record a decision and its reasons on the right item).