MCP tool reference
Find every hosted MCP tool, what it does, and the scope a credential needs to call it.
Tool reference
Each tool needs the listed scope on the API key or OAuth grant. tools/list returns only the tools your credential can use. Handoff actions require task write access and separate personal tool approval.
list_members and list_project_members return an object with members, hasMore, and nextCursor. When hasMore is true, pass nextCursor as cursor with the same workspace, project, and search query. An empty members array can still have another page.
Connection and account
get_tool_ artifact - Find a tool artifact's post and attachment. Requires
projects:read. list_tool_ artifacts - List the tool artifacts linked to a post or a project. Requires
projects:read. delete_tool_ artifact - Remove a tool artifact link. The post and its files stay. Requires
posts:writeandmedia:write. upsert_tool_ artifact - Link a tool artifact to its project, post and attachment. Requires
posts:writeandmedia:write. check_auth - Show your user ID, effective permissions, and the bound workspace. Requires one of .
revoke_current_ token - Revoke the API token this connection uses. Requires one of .
get_limits - Show remaining request quota without consuming it. Requires one of .
list_workspaces - List the bound workspace, or memberships with account access. Requires
profile:read. get_profile - Read your account profile. Requires
profile:read. update_profile - Update your display name, username, or name preference. Requires
profile:write. remove_avatar - Remove your profile photo. Requires
profile:write. get_feed_ preferences - Read which activity your workspace feed shows. Requires
profile:read. update_feed_ preferences - Choose which activity your workspace feed shows. Requires
profile:write. get_time_ preferences - Read your weekly target, daily reminder, and idle detection settings. Requires
profile:read. update_time_ preferences - Change your weekly target, daily reminder, and idle detection settings. Requires
profile:write. list_my_ invitations - List pending invitations to other workspaces. Requires
profile:read. accept_invitation - Join a workspace by accepting an invitation. Requires
profile:write. create_workspace - Create a workspace that you own. Requires
profile:write. list_account_ emails - List the email addresses on your account. Requires
profile:read. add_account_ email - Add an email address and send it a verification link. Requires
profile:write. resend_account_ email_ verification - Send a new verification link to an unverified address. Requires
profile:write. remove_account_ email - Remove an unverified email address. Requires
profile:write. get_account_ deletion_ status - Check whether your account can be deleted. Requires
profile:read. list_account_ sessions - List the devices and browsers signed in to your account. Requires
profile:read. revoke_account_ session - Sign out one device or browser. Requires
profile:write. list_security_ activity - List your latest sign-in and security events. Requires
profile:read. list_account_ workspaces - List your memberships. Requires account access. Requires
profile:read. list_api_ keys - List personal API token metadata, without secrets. Requires account access. Requires
api-keys:read. list_push_ subscriptions - List your notification devices. Requires account access. Requires
profile:read. delete_push_ subscription - Remove one of your notification devices. Requires account access. Requires
profile:write.
Members
list_members - List workspace members. Requires
members:read. list_project_ members - List members with access to a project. Requires
members:read. get_workspace - Read workspace settings, plan, usage, and overages. Requires
workspace:read. update_workspace - Change workspace details and feature switches. Requires
workspace:write. get_admin_ controls - Read the workspace admin controls. Requires
workspace:read. update_admin_ controls - Change workspace admin controls. Requires
workspace:write. remove_workspace_ logo - Remove the workspace logo. Requires
workspace:write. get_security_ settings - Read the workspace security settings. Requires
workspace:read. update_member_ role - Change a workspace member's role. Requires
members:write. remove_member - Remove a member from the workspace. Requires
members:write. list_invitations - List pending workspace invitations. Requires
members:read. send_invitation - Invite someone to the workspace by email. Requires
members:write. resend_invitation - Send a pending invitation email again. Requires
members:write. revoke_invitation - Cancel a pending invitation. Requires
members:write. leave_workspace - Leave the current workspace. Requires
profile:write. add_project_ member - Add a workspace member to a project with a project role. Requires
members:write. update_project_ member_ role - Change a project member's role. Requires
members:write. remove_project_ member - Remove a member from a project. Requires
members:write.
Projects
list_projects - List the projects you can open; archived ones when asked. Requires
projects:read. get_project_ task_ counts - Count a project's tasks by status. Requires
projects:readandtasks:read. get_project - Get a project by ID. Requires
projects:read. create_project - Create a project. Requires
projects:write. update_project - Update a project. Requires
projects:write. archive_project - Archive a project. Requires
projects:write. set_project_ pin - Pin a project to your sidebar or unpin it. Requires
notifications:write. delete_project - Delete a project and its content. Requires
projects:write. list_project_ links - List the links shown on a project. Requires
projects:read. add_project_ link - Add an http or https link to a project. Requires
projects:write. update_project_ link - Change a project link. Requires
projects:write. remove_project_ link - Remove a project link. Requires
projects:write. reorder_project_ links - Set the display order of a project's links. Requires
projects:write. remove_project_ icon - Remove a project's icon. Requires
projects:write. remove_project_ header_ image - Remove a project's header image. Requires
projects:write.
Posts, comments, and reactions
list_posts - List posts, filtered by project, author, tag, dates, release details, source, or text. Requires
posts:read. get_post - Get a post by ID or identifier, optionally with tags, attachments, counts, and your follow and bookmark state. Requires
posts:read. create_post - Create a post, optionally with files and release details. Requires
posts:write. update_post - Update a post, including its release details. Requires
posts:write. delete_post - Delete a post. Requires
posts:write. restore_post - Restore a deleted post. Requires
posts:write. list_bookmarks - List the posts you bookmarked. Requires
posts:read. set_post_ bookmark - Bookmark or unbookmark a post for yourself. Requires
notifications:write. list_post_ activity - List what happened to a post. Requires
posts:read. list_share_ links - List a post's share links, or every share link for workspace admins. Tokens and URLs are not included. Requires
posts:read. create_share_ link - Create a public share link for a published post. Returns its token and URL once. Requires
posts:write. revoke_share_ link - Revoke a share link. Requires
posts:write. list_post_ versions - List a post's versions, newest first. Requires
posts:read. get_post_ version - Read one version with its content. Requires
posts:read. publish_post_ version - Publish a new version of a post you wrote. Requires
posts:write. list_post_ comments - List comments on a post. Requires
comments:read. wait_for_ comments - Wait for new comments on a post, then return them. Requires
comments:read. list_comments - List comments and annotations across every post you can read, with filters for open review feedback. Requires
comments:read. resolve_all_ post_ comments - Resolve every open annotation on one media item. Requires
comments:write. create_post_ comment - Comment on a post or reply to a comment. Requires
comments:write. update_post_ comment - Edit your post comment. The annotation author, post author, or a workspace admin can also change an annotation's review status. Requires
comments:write. delete_post_ comment - Delete a post comment. Requires
comments:write. get_post_ comment - Read one comment or annotation. Requires
comments:read. get_annotation_ frame - See the frame an annotation was left on, with its marks drawn on it when available. Requires
media:readandcomments:read. create_annotation - Leave feedback on a point, time, frame, page, or lines of a post's media. Requires
comments:write. resolve_post_ comment - Mark a comment or annotation as addressed. Requires
comments:write. reopen_post_ comment - Reopen a resolved comment. Requires
comments:write. list_post_ comment_ reactions - List reaction counts on a comment. Requires
reactions:readandcomments:read. toggle_post_ comment_ reaction - Add or remove your reaction on a comment. Requires
reactions:writeandcomments:read. create_task_ from_ comment - Create a task from a comment, or link an existing task. Requires
tasks:writeandcomments:write. list_post_ reactions - List reactions on a post, optionally with who reacted. Requires
reactions:read. list_custom_ reactions - List the workspace's custom reactions. Requires
reactions:read. delete_custom_ reaction - Delete a custom reaction (workspace owners and admins). Requires
reactions:write. toggle_post_ reaction - Add or remove a reaction on a post. Requires
reactions:write. set_post_ follow_ state - Follow a post to be notified about its activity, or mute it. Requires
notifications:write.
Tasks
list_tasks - List tasks. Filter by project, status, priority, assignee, creator, tag, title words, dates, parent, or external issue, sort the result, fetch several by ID, or poll by update time. Rows leave out descriptions unless you ask for the detailed format. Requires
tasks:read. list_task_ link_ attachments - List the web links attached to a task. Requires
tasks:read. add_task_ link_ attachment - Attach a web link to a task. Requires
tasks:write. remove_task_ link_ attachment - Remove an attached web link from a task. Requires
tasks:write. list_post_ link_ attachments - List the web links attached to a post. Requires
posts:read. add_post_ link_ attachment - Attach a web link to a post. Requires
posts:write. remove_post_ link_ attachment - Remove an attached web link from a post. Requires
posts:write. get_external_ issue_ options - Check whether a GitHub or Jira issue can be created from a task. Requires
tasks:read. create_external_ issue - Create a GitHub or Jira issue from a task. Requires
tasks:write. list_post_ tasks - List the tasks linked to a post. Requires
posts:readandtasks:read. get_my_ task_ counts - Count your open tasks, with a project's attention summary. Requires
tasks:read. list_task_ views - List your saved task views. Requires
tasks:read. get_task - Get a task by ID or an identifier such as PRO-42, optionally with its subtasks and checklist. Requires
tasks:read. create_task - Create a task. Requires
tasks:write. create_tasks - Create up to 50 tasks in one call and get a result for each. Requires
tasks:write. update_task - Update a task. Requires
tasks:write. delete_task - Move a task to the trash. Accepts an ID or an identifier such as PRO-42. Requires
tasks:write. restore_task - Restore a task from the trash. Accepts an ID or an identifier such as PRO-42. Requires
tasks:write. move_task - Move a task to another column, position, or project. Accepts an ID or an identifier such as PRO-42. Requires
tasks:write. bulk_update_ tasks - Change the status, priority, assignees, due date, project, or tags of up to 50 tasks, or delete and restore them. Requires
tasks:write. list_task_ activity - List the changes made to a task, such as status, assignee, date, tag, and timer events. Requires
tasks:read. list_task_ comments - List comments on a task, optionally only those since a time. Requires
tasks:read. create_task_ comment - Comment on a task or reply to a comment. Set audience to client to share with its request submitter; the default is workspace. Requires
tasks:write. update_task_ comment - Edit your task comment. Requires
tasks:write. delete_task_ comment - Delete one task comment. Requires
tasks:write. delete_task_ comments - Delete up to 10 comments on a task: the task creator removes their own, and admins remove anyone's. Call again while hasMore is true. Requires
tasks:write. create_task_ link - Link a task to a post. Requires
tasks:write. delete_task_ links - Remove up to 200 post links from a task; call again while hasMore is true. Requires
tasks:write. list_task_ links - List the posts linked to a task. Requires
tasks:read. remove_task_ link - Unlink one post from a task. Requires
tasks:write. list_task_ references - List the docs, posts, and tasks that mention a task, plus its linked commits, pull requests, issues, and files. Requires
tasks:read. remove_task_ reference - Remove a linked commit, pull request, issue, or file. Requires
tasks:write. list_task_ attachments - List a task's files. Requires
media:readandtasks:read. list_task_ reactions - List reaction counts on a task or one of its comments. Requires
reactions:readandtasks:read. toggle_task_ reaction - Add or remove your reaction on a task or one of its comments. Requires
reactions:writeandtasks:read. list_subtasks - List a task's subtasks, without descriptions unless you ask for the detailed format. Requires
tasks:read. create_subtask - Create a subtask. Requires
tasks:write. list_checklist_ items - List a task's checklist. Accepts an ID or an identifier such as PRO-42. Requires
tasks:read. add_checklist_ item - Add a checklist item. Accepts an ID or an identifier such as PRO-42. Requires
tasks:write. update_checklist_ item - Change a checklist item's text or checked state. Requires
tasks:write. move_checklist_ item - Move a checklist item to a new position. Requires
tasks:write. delete_checklist_ item - Delete a checklist item. Requires
tasks:write. list_tags - List workspace tags and the project tags you can see. Find tags by name, filter by scope, or put the most used first. Requires one of
tags:read,tasks:read,posts:read. get_tag - Get one tag. Requires one of
tags:read,tasks:read,posts:read. create_tag - Create a workspace or project tag. Requires one of
tags:write,projects:write. update_tag - Rename, recolor, or describe a tag. Requires one of
tags:write,projects:write. delete_tag - Delete a tag. Requires one of
tags:write,projects:write. promote_tag - Turn a project tag into a workspace tag. Requires one of
tags:write,projects:write. set_post_ tags - Replace a post's tags. Requires
posts:write. list_post_ tags - List a post's tags. Requires
posts:read. add_post_ tag - Add a tag to a post. Requires
posts:write. remove_post_ provider_ file - Remove a Figma or Google Drive file from a post. Requires
posts:write. remove_post_ tag - Remove a tag from a post. Requires
posts:write. list_task_ tags - List a task's tags. Requires
tasks:read. add_task_ tag - Add a tag to a task. Requires
tasks:write. set_task_ tags - Replace a task's tags. Requires
tasks:write. remove_task_ tag - Remove a tag from a task. Requires
tasks:write.
Personal tool handoffs
get_task_ worker_ recovery - Read this connection's recovery by ownerAttemptId, or its latest recovered task attempt. Requires
tasks:read. acquire_task_ worker_ lease - Acquire exclusive task ownership for a connected worker. Requires
tasks:write. renew_task_ worker_ lease - Renew exclusive task ownership for a connected worker. Requires
tasks:write. release_task_ worker_ lease - Release exclusive task ownership for a connected worker. Requires
tasks:write. complete_task_ worker_ lease - Complete exclusive task ownership for a connected worker. Requires
tasks:write. register_personal_ tool - Register this tool for handoffs. Requires
tasks:write. get_tool_ connection - Check this tool's connection readiness and request budgets. Requires
tasks:read. list_task_ tool_ connections - List teammates' tools that can work on a task. Requires
tasks:read. request_tool_ handoff - Ask a chosen tool, or any qualified agent, to do work on a task. Requires
tasks:write. list_tool_ handoffs - Read this tool's inbox, open work it qualifies for, or handoffs you sent, one or several statuses per call. Requires
tasks:read. list_task_ handoffs - List the handoffs requested on a task. Requires
tasks:read. get_tool_ handoff - Read a handoff and its result. Requires
tasks:read. decide_tool_ handoff - Approve, accept, reject, or cancel a handoff. Requires
tasks:write. refresh_tool_ handoff_ context - Refresh requested or queued task details. Requires
tasks:write. claim_tool_ handoff - Claim approved work for five minutes. Requires
tasks:write. renew_tool_ handoff - Renew an active claim. Requires
tasks:write. ask_tool_ handoff_ question - Pause work with a question for the requester. Requires
tasks:write. answer_tool_ handoff_ question - Answer a receiving tool's question. Requires
tasks:write. submit_tool_ handoff_ result - Return a result with evidence links. Requires
tasks:write.
Docs
list_docs - List docs by space, state, parent, text, editor, or lock, with a sort. Requires
docs:read. get_doc - Read one doc with its content and link, as Markdown if asked. Requires
docs:read. create_doc - Create a doc from plain text, Markdown, Plate JSON, or a template. Requires
docs:write. get_doc_ tree - Read a space's doc hierarchy as nested pages. Requires
docs:read. list_doc_ children - List the docs directly under a doc. Requires
docs:read. get_doc_ version - Read one saved version of a doc, as Markdown if asked. Requires
docs:read. list_doc_ backlinks - List the docs, posts, and tasks that link to a doc. Requires
docs:read. list_recent_ docs - List docs by last edit, for all, yours, or ones you edited. Requires
docs:read. list_watched_ docs - List the docs you watch by last edit. Requires
docs:read. list_docs_ awaiting_ me - List docs with an unresolved comment assigned to you. Requires
docs:read. list_doc_ shares - List the members a doc is shared with. Requires
docs:read. share_doc - Give a member access to a doc or change their role. Requires
docs:write. unshare_doc - Remove a member's access to a doc. Requires
docs:write. list_doc_ templates - List built-in and custom doc templates. Requires
docs:read. get_doc_ template - Read a doc template with its content. Requires
docs:read. create_doc_ template - Create a custom doc template. Needs an owner or admin. Requires
docs:write. delete_doc_ template - Delete a custom doc template. Needs an owner or admin. Requires
docs:write. update_doc - Change a doc's title, icon, width, or visibility. Requires
docs:write. update_doc_ content - Replace a doc's content, with an optional change note. Requires
docs:write. edit_doc_ blocks - Replace, insert or delete blocks; open editors merge the change live. Requires
docs:write. move_doc - Move a doc and its subpages to another parent, position, or space. Requires
docs:write. duplicate_doc - Copy a doc into a new doc beside it. Requires
docs:write. lock_doc - Lock a doc so only owners and admins can edit it. Requires
docs:write. unlock_doc - Unlock a locked doc. Requires
docs:write. watch_doc - Watch a doc. Requires
docs:write. unwatch_doc - Stop watching a doc. Requires
docs:write. archive_doc - Archive a doc. Requires
docs:write. restore_doc - Restore an archived doc. Requires
docs:write. delete_doc - Delete a doc. Requires
docs:write. list_doc_ versions - List a doc's saved versions. Requires
docs:read. restore_doc_ version - Restore a saved version as a new version. Requires
docs:write.
Doc spaces
list_doc_ spaces - List spaces, optionally for one project. Requires
docs:read. get_doc_ space - Read one space. Requires
docs:read. create_doc_ space - Create a workspace or project space. Requires
docs:write. update_doc_ space - Rename a space or change its description, icon, or visibility. Requires
docs:write. archive_doc_ space - Archive a space and its docs. Requires
docs:write. restore_doc_ space - Restore an archived space. Requires
docs:write. delete_doc_ space - Delete an archived space with no docs in it. Requires
docs:write.
Doc comments
list_doc_ comments - List a doc's comments, replies, and inline annotations. Requires
docs:read. create_doc_ comment - Comment on a doc, reply, or anchor to marked text. Requires
docs:write. update_doc_ comment - Edit your comment. Requires
docs:write. delete_doc_ comment - Delete your comment. Owners and admins can delete any comment. Requires
docs:write. resolve_doc_ comment - Resolve a comment thread. Requires
docs:write. reopen_doc_ comment - Reopen a resolved thread. Requires
docs:write. list_doc_ comment_ reactions - List reaction counts on a comment. Requires
reactions:readanddocs:read. toggle_doc_ comment_ reaction - Add or remove your reaction on a comment. Requires
reactions:writeanddocs:read.
Canvases
list_canvases - List canvases, optionally for one project. Requires
canvas:read. get_canvas - Read a canvas with its items and connectors. Requires
canvas:read. list_canvas_ items - Page through the items on a canvas. Requires
canvas:read. create_canvas - Create a canvas in a project. Requires
canvas:write. update_canvas - Change a canvas's name, description, or visibility. Requires
canvas:write. archive_canvas - Archive a canvas. Requires
canvas:write. unarchive_canvas - Restore an archived canvas. Requires
canvas:write. delete_canvas - Delete a canvas. Requires
canvas:write. create_canvas_ item - Add a note, text, shape, link, frame, drawing, task, or post. Requires
canvas:write. update_canvas_ item - Move, restyle, frame, group, lock, or reorder an item, or set a frame's layout. Requires
canvas:write. get_canvas_ item - Read one item with its content, frame, group, and lock. Requires
canvas:read. get_canvas_ frame - Read a frame's bounds and the items inside it. Requires
canvas:read. list_canvas_ linked - List the task and post cards on a canvas. Requires
canvas:read. create_canvas_ connector - Connect two items with a line or arrow. Requires
canvas:write. update_canvas_ connector - Restyle a connector or move an end to another item. Requires
canvas:write. delete_canvas_ connector - Delete a connector. Requires
canvas:write. delete_canvas_ item - Delete an item. Requires
canvas:write.
Chat
list_chat_ rooms - List chat rooms by project or archived state. Requires
chat:read. get_chat_ room - Open the General room or a project room and read its details. Requires
chat:write. list_chat_ agents - List chat agent identities. Requires
chat:read. create_chat_ agent - Create a chat agent identity. Needs a workspace owner or admin. Requires
chat:write. update_chat_ agent - Change or disable a chat agent. Needs a workspace owner or admin. Requires
chat:write. list_chat_ messages - List recent messages in a room or thread. Requires
chat:read. list_chat_ thread_ links - List the items linked to a discussion. Requires
chat:read. send_chat_ message - Start a discussion or reply, with an optional title, linked items and files. Requires
chat:write. list_chat_ threads - List discussions in a room or across every room by status or pinned. Requires
chat:read. search_chat_ messages - Search message text across rooms or in one room. Requires
chat:read. list_chat_ attachments - List the files attached to a discussion. Requires
chat:read. mark_chat_ thread_ read - Mark a discussion read, optionally only through one message. Requires
chat:readand one ofchat:write,notifications:write. get_chat_ thread - Read one discussion. Requires
chat:read. update_chat_ thread - Rename, resolve, reopen, pin, or follow a discussion. Requires
chat:write. set_chat_ thread_ follow_ state - Follow, mute, or stop following a discussion. Requires
chat:readand one ofchat:write,notifications:write. get_chat_ message - Read one message. Requires
chat:read. edit_chat_ message - Edit your message. Requires
chat:write. delete_chat_ message - Delete a message. Requires
chat:write. list_chat_ message_ reactions - List reaction counts on a message. Requires
reactions:readandchat:read. toggle_chat_ message_ reaction - Add or remove your reaction on a message. Requires
reactions:writeandchat:read. list_object_ discussions - List the discussions about a post, task, canvas, doc, or project. Requires
chat:read. start_object_ discussion - Start a discussion about a post, task, canvas, doc, or project. Requires
chat:write. link_chat_ thread_ object - Link an item to a discussion. Requires
chat:write. remove_chat_ thread_ link - Remove a linked item from a discussion. Requires
chat:write.
Client portals
list_portals - List portals, newest first. Owners and admins only. Requires
portals:read. get_portal - Read one portal by ID or public slug, with its settings. Requires
portals:read. list_portal_ contacts - List the guests invited to a portal. Owners and admins only. Requires
portals:read. list_portal_ items - List the posts shared on a portal with each client's latest verdict. Requires
portals:read. list_portal_ events - List what guests and the team did on a portal. Requires
portals:read. get_portal_ insights - Read a portal's visits, feedback, and who opened each shared item. Requires
portals:read. list_portal_ feedback - List client feedback threads on one portal. Requires
portals:read. get_portal_ discussion - Look up a portal's discussion thread and room without creating it. Requires
portals:read. list_open_ client_ feedback - List open client feedback across every portal. Owners and admins only. Requires
portals:read. count_open_ client_ feedback - Count open client feedback threads. Owners and admins only. Requires
portals:read. get_client_ feedback - Read one feedback thread with every reply. Requires
portals:read. list_post_ client_ feedback - List the client feedback on a post, grouped by portal. Requires
portals:read. create_client_ feedback - Start a team message thread on a shared portal item. Nothing is sent if the message mentions items the portal has not shared. Requires
portals:write. reply_to_ client_ feedback - Reply in a feedback thread, to the guests or as a team-only note. Requires
portals:write. set_client_ feedback_ resolved - Resolve or reopen a feedback thread, or close one that needs no changes. Requires
portals:write. address_client_ feedback - Tell the guest a change request was fixed in a newer shared version. Requires
portals:write. set_client_ feedback_ status - Set a thread's team status: open, needs_changes, approved, or resolved. Requires
portals:write. react_to_ client_ feedback - Add, remove, or toggle your emoji reaction on a feedback message. Requires
portals:write. list_portal_ submissions - List bug reports and requests sent through portals. Requires
portals:read. get_portal_ submission - Read one portal report with its replies and attachments. Requires
portals:read. list_task_ portal_ submissions - List the portal reports linked to a task. Requires
tasks:readandportals:read. create_task_ from_ portal_ submission - Turn a new or dismissed portal report into a backlog task and mark the report accepted. Requires
portals:write. link_portal_ submission_ to_ task - Mark a new or dismissed portal report as a duplicate of an existing task. Requires
portals:write. reply_to_ portal_ submission - Reply to the person who sent a portal report. Requires
portals:write. triage_portal_ submission - Dismiss a report, mark or unmark it as spam, or reopen it. Requires
portals:write. set_portal_ submission_ board - Show a report on a public portal's voting board or hide it. Requires
portals:write. share_post_ to_ portal - Share a published post version with a portal's guests. Requires
portals:write. revoke_portal_ item - Remove a shared post version from a portal. Requires
portals:write. request_portal_ decision - Ask guests to approve or request changes on a shared item, or withdraw the ask. Requires
portals:write. list_portal_ docs - List the docs shared on a portal with each doc's guest access level. Requires
portals:read. create_portal - Create a client portal. Owners and admins only. Requires
portals:write. update_portal - Change a portal's name, description, home doc, projects, or guest settings. Requires
portals:write. revoke_portal - Close a portal so its link stops working and guests lose access. Requires
portals:write. rotate_portal_ token - Replace a portal's link token and return the new token once. Requires
portals:write. add_portal_ contact - Invite a guest to an invited portal by email. Requires
portals:write. resend_portal_ invite - Email an active guest a fresh sign-in link. Requires
portals:write. revoke_portal_ contact - Remove a guest's access to a portal. Requires
portals:write. share_doc_ to_ portal - Show a doc to a portal's guests at view, comment, or edit access, optionally with its subpages. Requires
portals:write. update_portal_ doc_ access - Change what guests can do with a shared doc. Requires
portals:write. revoke_portal_ doc - Stop sharing a doc on a portal. Requires
portals:write. open_portal_ discussion - Create a portal's discussion thread if it has none and return its thread and room IDs. Requires
portals:write. check_portal_ slug - Check whether a public portal address is valid and free. Requires
portals:read. list_portal_ members - List the people who joined a public portal, with their block state. Requires
portals:read. list_portal_ subscribers - List the confirmed addresses on a public portal's mailing list. Requires
portals:read. remove_portal_ subscriber - Remove an address from a public portal's mailing list. Requires
portals:write. set_portal_ member_ blocked - Block a portal member from commenting, or lift the block. Requires
portals:write. list_portal_ pending_ comments - List guest comments waiting for approval on a public portal. Requires
portals:read. list_portal_ item_ comments - List the comments on one shared post by moderation state. Requires
portals:read. create_portal_ comment - Post a team comment or reply under a shared post. Requires
portals:write. moderate_portal_ comment - Approve or reject a pending comment, or hide or unhide one. Requires
portals:write. update_portal_ branding - Change a portal's theme or accent color, or remove its logo. Requires
portals:write. update_portal_ sections - Choose which sections guests see on a portal. Requires
portals:write. update_portal_ launch - Set the release date, release text and trailer on a public portal. Requires
portals:write. update_portal_ links - Replace the links shown on a portal. Requires
portals:write. update_portal_ access - Make a portal public with an address, or limit it to invited guests. Requires
portals:write. update_portal_ feedback_ config - Replace a portal's feedback form settings and categories. Requires
portals:write. update_portal_ indexing - Allow or block search engines on a public portal. Requires
portals:write. update_portal_ updates_ config - Replace a portal's updates layout, review actions and auto-publish rules. Requires
portals:write. update_portal_ moderation_ config - Set how new member comments are held and when members are trusted. Requires
portals:write. apply_portal_ template - Reset a portal's sections and updates settings to a preset. Requires
portals:write.
Search and time tracking
search- Search the projects, posts, tasks, docs, canvases, discussions, comments, annotations, media, members, and tags your scopes can read. Also matches identifiers such as PRO-42. Hybrid keyword and meaning ranking is the default, with keyword fallback when unavailable. Set mode to keyword for word matching only. Requires one of
projects:read,posts:read,tasks:read,docs:read,canvas:read,chat:read,comments:read,media:read,members:read,tags:read. list_time_ entries - List time entries by task, project, person, or date. Requires
time:read. get_time_ entry - Read one time entry. Requires
time:read. create_time_ entry - Log time on a task. Requires
time:write. update_time_ entry - Change an entry's duration, date, or note. Requires
time:write. delete_time_ entry - Delete a time entry. Requires
time:write. get_timer - Show your running timer. Requires
time:read. start_timer - Start your timer on a task. Requires
time:write. stop_timer - Stop your timer and log the time. Viewers need only time:read, and their timer is cleared without logging time. Requires
time:write. switch_timer - Stop the running timer and start one on another task. Requires
time:write. get_task_ time - Get the time tracked on a task, including its subtasks. Requires
time:readandtasks:read. summarize_time_ entries - Total logged time by user, task, or day. Requires
time:read. duplicate_time_ entry - Log a copy of a time entry. Requires
time:write. create_time_ entries - Log the same time on a task on several dates. Requires
time:write. duplicate_time_ entries - Log copies of several time entries on one date. Requires
time:write.
Notifications
list_notifications - List notifications, filtered by unread, type, project, or time. Requires
notifications:read. get_notification_ summary - Count your unread notifications by type. Requires
notifications:read. list_project_ notification_ levels - List the projects you watch or mute. Requires
notifications:read. get_unread_ count - Get the unread notification count. Requires
notifications:read. mark_all_ notifications_ read - Mark every notification as read. Requires
notifications:write. update_notification - Mark one notification read or unread. Requires
notifications:write. mark_notifications_ read - Mark up to 100 notifications as read, or all about one post. Requires
notifications:write. delete_notification - Delete one notification. Requires
notifications:write. delete_read_ notifications - Delete every read notification. Requires
notifications:write. delete_old_ notifications - Delete notifications older than a number of days. Requires
notifications:write. set_project_ notification_ level - Watch, mute, or reset one project's notifications. Requires
notifications:write. get_notification_ preferences - Get notification preferences. Requires
notifications:read. update_notification_ preferences - Update notification preferences. Requires
notifications:write.
Webhooks
list_webhooks - List webhooks. Requires
webhooks:read. get_webhook - Get a webhook by ID. Requires
webhooks:read. create_webhook - Create a webhook, one that starts an AI agent run, or one that signs with a secret the receiving service issued. Requires
webhooks:write. update_webhook - Update a webhook, its agent run destination, or its signing secret. Requires
webhooks:write. delete_webhook - Delete a webhook. Requires
webhooks:write. test_webhook - Send a test event, or a sample of a named event. Requires
webhooks:write. regenerate_webhook_ secret - Replace a webhook's signing secret. Requires
webhooks:write. list_webhook_ deliveries - Page delivery records, filtered by status, event, or time, with nextCursor. Requires
webhooks:read. get_webhook_ delivery - Get one delivery attempt with its response and request headers. Requires
webhooks:read. list_webhook_ events - List the event names a webhook can subscribe to and their fields. Requires
webhooks:read. list_events - Page stored events from the last 30 days that you can see. involvingMe keeps only replies on your own work. Requires one of
webhooks:read,tasks:read,comments:read,docs:read,chat:read. get_event - Get one stored event by its event ID. Requires
webhooks:read. replay_webhook_ events - Re-send stored events to a webhook with their original IDs. Requires
webhooks:write. retry_webhook_ delivery - Retry a failed delivery. Requires
webhooks:write.
Files
list_media - List uploaded files on posts, comments, tasks, or task comments, with filters for post files. Requires
media:read. get_media - Get a file by ID. Requires
media:read. get_media_ stats - Count the files you can see, by kind. Requires
media:read. list_media_ posts - List the posts a file appears on. Requires
media:read. retry_media_ conversion - Queue a failed 3D model conversion again. Requires
media:write. reorder_post_ media - Set the order of a post's files. Requires
media:writeandposts:write. set_post_ media_ compare - Show two images or GIFs on a post as one before/after. Requires
media:writeandposts:write. clear_post_ media_ compare - Split a before/after pair back into two files. Requires
media:writeandposts:write. prepare_media_ upload - Start an upload and get the transfer URL. Requires
media:write. complete_media_ upload - Confirm the transfer and place the file. Requires
media:write. cancel_media_ upload - Cancel an unattached upload and release its reservation. Requires
media:write. get_media_ upload - Check whether an upload finished. Requires
media:write. upload_media - Upload a file to a post. Requires
media:write. delete_media - Delete a file. Requires
media:write.
Activity
list_activity - Read the workspace activity feed. Requires
activity:read. list_my_ activity - Read the activity you caused. Requires
activity:read.
Domains and audit logs
check_dns_ records - Check a domain's DNS records. Requires
domains:read. list_domains - List custom domains and their verification state. Requires
domains:read. add_domain - Claim a custom domain and get its DNS record. Requires
domains:write. remove_domain - Remove a custom domain. Requires
domains:write. verify_domain - Verify a custom domain. Requires
domains:write. list_workspace_ api_ keys - List the workspace's active API keys without secrets. Requires
workspace:read. revoke_workspace_ api_ key - Revoke a workspace API key. Requires
workspace:write. export_audit_ logs - Export audit events as JSON, CEF, or CSV, with filters and paging. Requires
audit-logs:read. get_audit_ log_ stats - Summarize audit events by category, status, and retention. Requires
audit-logs:read. verify_audit_ log_ chain - Check that audit log entries are intact. Requires
audit-logs:read.
Reports
get_delivery_ report - Task delivery, throughput, cycle time, and aging. Requires
reports:read. get_time_ report - Tracked time by project, person, and day. Requires
reports:read. get_review_ report - Review activity and turnaround. Requires
reports:read. get_agent_ report - Agent handoff activity by connected tool. Requires
reports:read. get_attention_ report - Overdue, stalled, and waiting work. Requires
reports:read. get_workspace_ overview - Posts, comments, reactions, contributors, and member growth. Requires
reports:read. get_activity_ report - Activity by category, day, member, and project. Requires
reports:read. get_storage_ report - Files and storage added, by type and uploader. Requires
reports:read. get_agent_ access_ report - API, CLI, and MCP calls by surface, client, and member. Requires
reports:read. get_my_ stats - Your own activity over a time range. Requires
reports:read. get_project_ analytics - A project's task mix, completions, and activity. Requires
reports:read. get_project_ activity_ heatmap - A project's activity by weekday and hour. Requires
reports:read.
Exports
list_workspace_ exports - List complete workspace exports and whether a new one can start. Requires
workspace:read. get_workspace_ export - Read one export with its status and progress. Requires
workspace:read. request_workspace_ export - Start a complete workspace data export. Requires
workspace:write. revoke_workspace_ export - Revoke an export so it cannot be downloaded. Requires
workspace:write.
Chat integrations
list_integrations - List Slack and Discord connections with status and counts. Requires
integrations:read. get_integration - Read one connection and its token health. Requires
integrations:read. list_integration_ mappings - List the channels a connection maps to projects. Requires
integrations:read. create_integration_ mapping - Tie a channel to a project. Requires
integrations:write. update_integration_ mapping - Change a channel mapping. Requires
integrations:write. delete_integration_ mapping - Delete a channel mapping. Requires
integrations:write. get_betterstack_ integration - Read the Better Stack connection and settings. Requires
integrations:read. connect_betterstack - Connect Better Stack with an API token. Requires
integrations:write. update_betterstack_ integration - Turn Better Stack task creation or write-back on or off. Requires
integrations:write. disconnect_betterstack - Disconnect Better Stack and remove its webhook. Requires
integrations:write. reveal_betterstack_ status_ page_ url - Reveal the Better Stack status page webhook URL. Requires
integrations:write. list_betterstack_ sources - List Better Stack monitors, heartbeats, and status pages. Requires
integrations:read. list_betterstack_ mappings - List mapped Better Stack sources. Requires
integrations:read. create_betterstack_ mapping - Map a Better Stack source to a project. Requires
integrations:write. update_betterstack_ mapping - Move a Better Stack mapping or change its task setting. Requires
integrations:write. delete_betterstack_ mapping - Delete a Better Stack mapping. Requires
integrations:write. list_integration_ events - List recent integration events and errors. Requires
integrations:read.
Fix tool reference problems
A tool is missing from the list
tools/list returns only the tools the credential can use. Compare the tool's scope with the credential. A personal tool handoff tool also needs separate opt-in.
A list returns no results
An empty page can still have another page. Keep the same filters and pass nextCursor as cursor until hasMore is false.