Skip to content

Tools reference

Every tool the Spool MCP server gives your agent, what each one does, and the permission it needs.

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

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

Type to search…

↑↓ navigate↵ selectEsc close