Tool reference
Every operation, by toolset. Each is an MCP tool and a REST route with the same name, input and output.
core
Browse, search, submit, vote, comment, and read the roadmap and changelog
| Tool | What it does | Who can call it |
|---|---|---|
| whoami | Show who I am | OwnersManagersContributorsCustomersAPI keys |
| get_workspace_overview | Get the workspace overview | OwnersManagersContributorsCustomersAPI keysVisitors |
| get_filter_guide | Get the filter guide | OwnersManagersContributorsCustomersAPI keysVisitors |
| list_boards | List boards | OwnersManagersContributorsCustomersAPI keysVisitors |
| search_posts | Search posts | OwnersManagersContributorsCustomersAPI keysVisitors |
| count_posts | Count posts | OwnersManagersContributorsCustomersAPI keysVisitors |
| list_my_activity | List my ideas | Customers |
| get_post | Get a post | OwnersManagersContributorsCustomersAPI keysVisitors |
| find_similar_posts | Find similar posts | OwnersManagersContributorsCustomersAPI keysVisitors |
| create_post | Create a post | OwnersManagersContributorsCustomersAPI keys |
| update_post | Edit a post | OwnersManagersContributorsCustomersAPI keys |
| delete_post | Delete a post | OwnersManagersContributorsCustomersAPI keys |
| create_upload | Start a file upload | OwnersManagersContributorsCustomersAPI keys |
| vote_post | Vote for a post | Customers |
| unvote_post | Remove your vote | Customers |
| list_comments | List a post's comments | OwnersManagersContributorsCustomersAPI keysVisitors |
| create_comment | Comment on a post | OwnersManagersContributorsCustomersAPI keys |
| update_comment | Edit a comment | OwnersManagersContributorsCustomersAPI keys |
| delete_comment | Delete a comment | OwnersManagersContributorsCustomersAPI keys |
| restore_post | Restore a deleted post | OwnersManagersContributorsCustomersAPI keys |
| list_notifications | List your notifications | OwnersManagersContributorsCustomers |
| mark_notifications_read | Mark notifications read | OwnersManagersContributorsCustomers |
| get_notification_preferences | Get your notification settings | OwnersManagersContributors |
| save_notification_preferences | Change your notification settings | OwnersManagersContributors |
| follow | Follow a post, board or category | OwnersManagersContributorsCustomers |
| unfollow | Unfollow a post, board or category | OwnersManagersContributorsCustomers |
| get_email_preferences | Get your email settings | Customers |
| save_email_preferences | Change your email settings | Customers |
| get_public_roadmap | Get the public roadmap | OwnersManagersContributorsCustomersAPI keysVisitors |
| list_changelog_entries | List changelog entries | OwnersManagersContributorsCustomersAPI keysVisitors |
| get_changelog_entry | Get a changelog entry | OwnersManagersContributorsCustomersAPI keysVisitors |
| subscribe_changelog | Subscribe to the changelog | Customers |
| unsubscribe_changelog | Unsubscribe from the changelog | Customers |
| get_shared_roadmap | Open a shared roadmap | OwnersManagersContributorsCustomersAPI keysVisitors |
triage
Change status, owners and tags, merge posts, moderate, edit in bulk, and vote on behalf of customers
| Tool | What it does | Who can call it |
|---|---|---|
| list_voters | List a post's voters | OwnersManagersContributorsAPI keys |
| change_post_status | Change a post's status | OwnersManagersAPI keys |
| list_moderation_queue | List posts awaiting review | OwnersManagersAPI keys |
| moderate_post | Approve or reject a post | OwnersManagersAPI keys |
| assign_post_owner | Assign a post's owner | OwnersManagersAPI keys |
| set_post_eta | Set a post's ETA | OwnersManagersAPI keys |
| add_post_tags | Tag a post | OwnersManagersContributorsAPI keys |
| remove_post_tags | Untag a post | OwnersManagersContributorsAPI keys |
| move_post | Move a post to another board | OwnersManagersAPI keys |
| merge_posts | Merge duplicate posts | OwnersManagersAPI keys |
| unmerge_post | Unmerge a post | OwnersManagersAPI keys |
| bulk_update_posts | Update many posts at once | OwnersManagersAPI keys |
| add_vote_on_behalf | Vote for a customer | OwnersManagersContributorsAPI keys |
| set_vote_priority | Set a vote's priority or note | OwnersManagersContributorsAPI keys |
| remove_vote | Remove a customer's vote | OwnersManagersAPI keys |
customers
Read and edit users, companies and segments
| Tool | What it does | Who can call it |
|---|---|---|
| block_user | Block an end user | OwnersManagersAPI keys |
| unblock_user | Unblock an end user | OwnersManagersAPI keys |
| search_users | Search customers | OwnersManagersContributorsAPI keys |
| get_user | Get a customer | OwnersManagersContributorsAPI keys |
| save_user | Create or update a customer | OwnersManagersContributorsAPI keys |
| merge_users | Merge duplicate customers | OwnersManagersAPI keys |
| delete_user | Delete a customer and their content | OwnersManagersAPI keys |
| export_user_data | Export a customer's data | OwnersManagersAPI keys |
| search_companies | Search companies | OwnersManagersContributorsAPI keys |
| get_company | Get a company | OwnersManagersContributorsAPI keys |
| save_company | Create or update a company | OwnersManagersContributorsAPI keys |
| link_user_company | Add a customer to a company | OwnersManagersContributorsAPI keys |
| unlink_user_company | Remove a customer from a company | OwnersManagersAPI keys |
| list_segments | List segments | OwnersManagersContributorsAPI keys |
| preview_segment | Preview who is in a segment | OwnersManagersContributorsAPI keys |
| save_segment | Create or update a segment | OwnersManagersAPI keys |
| delete_segment | Delete a segment | OwnersManagersAPI keys |
planning
Roadmaps, scoring, saved views, reports and exports
| Tool | What it does | Who can call it |
|---|---|---|
| list_views | List saved views | OwnersManagersContributorsAPI keys |
| run_view | Run a saved view | OwnersManagersContributorsAPI keys |
| save_view | Create or update a saved view | OwnersManagersContributorsAPI keys |
| delete_view | Delete a saved view | OwnersManagersContributorsAPI keys |
| export_data | Export a CSV | OwnersManagersAPI keys |
| get_export | Check an export | OwnersManagersAPI keys |
| list_roadmaps | List roadmaps | OwnersManagersContributorsAPI keys |
| get_roadmap | Get a roadmap | OwnersManagersContributorsAPI keys |
| save_roadmap | Create or update a roadmap | OwnersManagersAPI keys |
| delete_roadmap | Delete a roadmap | OwnersManagersAPI keys |
| add_to_roadmap | Add posts to a roadmap | OwnersManagersAPI keys |
| remove_from_roadmap | Remove posts from a roadmap | OwnersManagersAPI keys |
| configure_scoring | Configure roadmap scoring | OwnersManagersAPI keys |
| set_factor_values | Set manual factor values | OwnersManagersAPI keys |
| rank_roadmap_post | Rank a post on a roadmap | OwnersManagersAPI keys |
| get_report | Get a report | OwnersManagersContributorsAPI keys |
| create_share_link | Share a roadmap view | OwnersManagersAPI keys |
| list_share_links | List share links | OwnersManagersAPI keys |
| revoke_share_link | Revoke a share link | OwnersManagersAPI keys |
changelog
Draft and publish changelog entries
| Tool | What it does | Who can call it |
|---|---|---|
| save_changelog_entry | Save a changelog entry | OwnersManagersContributorsAPI keys |
| publish_changelog_entry | Publish a changelog entry | OwnersManagersAPI keys |
| unpublish_changelog_entry | Unpublish a changelog entry | OwnersManagersAPI keys |
| delete_changelog_entry | Delete a changelog entry | OwnersManagersAPI keys |
| list_changelog_labels | List changelog labels | OwnersManagersContributorsAPI keys |
| save_changelog_label | Save a changelog label | OwnersManagersAPI keys |
| delete_changelog_label | Delete a changelog label | OwnersManagersAPI keys |
| list_changelog_subscribers | List changelog subscribers | OwnersManagersAPI keys |
admin
Boards, categories, tags, statuses, custom fields, members and settings
| Tool | What it does | Who can call it |
|---|---|---|
| list_members | List members | Owners |
| invite_member | Invite a member | Owners |
| resend_invitation | Resend an invitation | Owners |
| revoke_invitation | Revoke an invitation | Owners |
| update_member_role | Change a member's role | Owners |
| remove_member | Remove a member | Owners |
| save_board | Save a board | OwnersManagersAPI keys |
| delete_board | Delete a board | OwnersManagersAPI keys |
| save_category | Save a category | OwnersManagersAPI keys |
| delete_category | Delete a category | OwnersManagersAPI keys |
| save_status | Save a status | OwnersManagersAPI keys |
| reorder_statuses | Reorder statuses | OwnersManagersAPI keys |
| delete_status | Delete a status | OwnersManagersAPI keys |
| save_tag | Save a tag | OwnersManagersAPI keys |
| delete_tag | Delete a tag | OwnersManagersAPI keys |
| list_custom_fields | List custom fields | OwnersManagersContributorsAPI keys |
| save_custom_field | Create or update a custom field | OwnersManagersAPI keys |
| delete_custom_field | Delete a custom field | OwnersManagersAPI keys |
| get_workspace_settings | Get workspace settings | OwnersManagersContributorsAPI keys |
| update_workspace_settings | Update workspace settings | Owners |
| check_custom_domain | Check the custom domain | Owners |
| get_setup_checklist | Get the setup checklist | OwnersManagersContributorsAPI keys |
| update_setup_checklist | Update the setup checklist | Owners |
audit
Read the audit log and undo actions
| Tool | What it does | Who can call it |
|---|---|---|
| list_audit_events | List audit events | OwnersManagersContributorsAPI keys |
| get_usage | Get usage and performance | Owners |
| undo_action | Undo an action | OwnersManagersContributorsAPI keys |