Skip to content

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:write and media:write.
upsert_tool_artifact
Link a tool artifact to its project, post and attachment. Requires posts:write and media: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:read and tasks: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:read and comments: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:read and comments:read.
toggle_post_comment_reaction
Add or remove your reaction on a comment. Requires reactions:write and comments:read.
create_task_from_comment
Create a task from a comment, or link an existing task. Requires tasks:write and comments: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:read and tasks: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:read and tasks:read.
list_task_reactions
List reaction counts on a task or one of its comments. Requires reactions:read and tasks:read.
toggle_task_reaction
Add or remove your reaction on a task or one of its comments. Requires reactions:write and tasks: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:read and docs:read.
toggle_doc_comment_reaction
Add or remove your reaction on a comment. Requires reactions:write and docs: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:read and one of chat: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:read and one of chat: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:read and chat:read.
toggle_chat_message_reaction
Add or remove your reaction on a message. Requires reactions:write and chat: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:read and portals: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:read and tasks: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:write and posts:write.
set_post_media_compare
Show two images or GIFs on a post as one before/after. Requires media:write and posts:write.
clear_post_media_compare
Split a before/after pair back into two files. Requires media:write and posts: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.

Image preview
100%