Developer
News and Updates
Get Support
Sign in
Get Support
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Last updated Sep 2, 2026

Supported tools

The Atlassian Rovo MCP Server supports a catalog of tools across Atlassian apps. Each tool belongs to a permission group, and each group bundles one or more tools by intent - for example, read, write, search, delete, or manage.

How the server exposes tools

Rather than sending every tool definition at connection time, the server advertises a small set of primary tools directly to agents and lets clients discover the rest of the catalog on demand. This preserves context window and lets Atlassian add tools without requiring you to reconnect.

  • Primary tools are marked (Primary) below. They're returned directly in the MCP tools/list response and are always visible to clients.
  • Deferred tools are found at runtime through the discover tool, which takes a natural-language description of what you want to do, and are then invoked with executeRead, executeWrite, or executeDestructive depending on the operation's risk tier.

If you're connecting through an MCP gateway that requires a complete tool list rather than dynamic discovery, a paginated flat list is available at https://mcp.atlassian.com/v2/mcp?tools=all.

Tool availability is dynamic

The exact set of tools available in a given session depends on your authentication method, scopes, the permission groups your organization admin has enabled, and your app access.

Permission groups and access

Organization admins grant or revoke access at the permission-group level, and each tool inherits the access of its parent group. Some tools, such as discover and the execute tools, don't belong to a permission group and are required for the overall operation of the MCP server.

Availability also depends on the authentication method in use. Groups marked API token only require authentication via API token to be enabled by your organization admin; groups marked OAuth 2.1 only can't be used with an API token.

Common tools

ToolDescription
atlassianUserInfo (Primary)Retrieve the current authenticated user's account information.
getAccessibleAtlassianResources (Primary)List the Atlassian sites and apps you can access, with their cloudId values.
discover (Primary)Search the deferred tool catalog using natural language.
executeRead, executeWrite, executeDestructive (Primary)Execution pathways for deferred tools, with agent-level confirmation.
getContentFormatGuideGet rich-content authoring format guidance for documents and whiteboards.

Jira

read_jira

  • Authentication: OAuth 2.1 and API token
  • Required scope: read:jira:agent-interface
ToolDescription
getJiraIssue (Primary)Get a work item by ID or key.
listJiraProjectsGet visible Jira spaces.
listJiraProjectIssueTypesMetadataGet the available work item types in a space.
getJiraIssueTypeMetaWithFieldsGet the schema and field metadata for a specific work item type.
listJiraIssueTransitionsGet the available workflow transitions for a work item.
listJiraIssueLinkTypesGet the available work item link types.
listJiraIssueRemoteIssueLinksGet the remote links associated with a work item.
listJiraIssueWorklogsGet paginated worklogs (logged time) for a work item.
lookupJiraAccountIdLook up a user account ID by display name or email.
findJiraIssueAssignableUsersFind users assignable to a space or work item.
listJiraIssueCommentsGet paginated comments for a work item.
listJiraIssueChangelogsGet field-change history, paginated oldest-first.
getJiraCurrentUserGet details for the current Jira user.
getJiraUserRetrieve a user profile by account ID.
listJiraStatusesList the possible work item statuses.
listJiraProjectComponentsList components with IDs, names, counts, and ownership.
getJiraProjectVersionsGet a space's releases/versions, or a single version.
getJiraProjectVersionRelatedWorkGet related work links on a space version.
listJiraBoardsList the boards visible to the current user.
getJiraBoardConfigGet a board's configuration: filter, columns, and status mappings.
getJiraBoardIssueDataGet the work items on a board, with optional filtering.
getJiraBoardSprintDataGet board plus sprint data, defaulting to the active sprint.
listJiraBoardSprintsList sprints from a board, filtered to active, future, or closed.
listJiraFiltersSearch saved filters, with their IDs and JQL.
listJiraDashboardsList the dashboards visible to the current user.
getJiraEntityPropertyRead a key/value store property on a work item, comment, worklog, dashboard item, or user.
downloadJiraIssueAttachmentGet a short-lived download URL for an attachment, plus a local save command.

write_jira

  • Authentication: OAuth 2.1 and API token
  • Required scope: write:jira:agent-interface
ToolDescription
createJiraIssue (Primary)Create a new work item.
editJiraIssue (Primary)Edit an existing work item's editable fields.
transitionJiraIssue (Primary)Transition a work item to a new status, or assign it to a sprint or the backlog.
addOrEditJiraIssueComment (Primary)Add a comment, or edit an existing one.
addOrEditJiraIssueWorklogLog time, or edit an existing worklog.
createJiraIssueLinkCreate a link between two work items.
manageJiraProjectVersionCreate, update, release, or archive a space version.
manageJiraProjectVersionRelatedWorkCreate or update related work links on a space version.
manageJiraSprintCreate, populate, start, update, or close a sprint.
createJiraBoardCreate a company-managed scrum or kanban board from a filter.
watchJiraIssueWatch or unwatch a work item.
uploadAttachmentToJiraIssueAttach a local file to a work item.
editJiraEntityPropertySet a key/value store property on a work item, comment, worklog, dashboard item, or user.

search_jira

  • Authentication: OAuth 2.1 and API token
  • Required scope: search:jira:agent-interface
ToolDescription
searchJiraIssuesUsingJql (Primary)Search work items using JQL.

delete_jira

  • Availability: Disabled by default; requires admin enablement
  • Authentication: OAuth 2.1 and API token
  • Required scope: delete:jira:agent-interface
ToolDescription
deleteJiraIssuePermanently delete a work item. This can't be undone.
deleteJiraCommentPermanently delete a comment from a work item. This can't be undone.
deleteJiraIssueAttachmentPermanently delete an attachment from a work item. This can't be undone.

manage_jira

  • Availability: Disabled by default; requires admin enablement
  • Authentication: OAuth 2.1 and API token
  • Required scope: manage:jira:agent-interface
ToolDescription
createJiraProjectCreate a new Jira space from a template.
updateJiraProjectUpdate the settings on an existing space.

Confluence

read_confluence

  • Authentication: OAuth 2.1 and API token
  • Required scope: read:confluence:agent-interface
ToolDescription
getConfluenceContent (Primary)Read any Confluence content: page, blog, live doc, comment, whiteboard, embed, database, or folder.
listConfluenceContentList content of one type within a single space.
listConfluenceSpacesList accessible spaces.
getConfluenceSpaceRetrieve a space by ID or key, with its enabled types and instructions.
getConfluenceSpaceInstructionsGet the instructions for a space.
getConfluencePersonalSpaceGet the current user's personal space.
listConfluenceCommentsList the comments on a page or blog post.
getConfluenceCommentGet a single comment by ID.
listConfluenceContentVersionsGet version history, newest first.
getConfluenceContentVersionGet one historical version.
diffConfluenceContentVersionsGet a unified diff between two versions.
listConfluenceAttachmentsList attachment metadata for a content item.
getConfluenceAttachmentGet attachment metadata by ID.
downloadConfluenceAttachmentGet an attachment download URL, plus a curl command.
exportConfluenceContentExport content as PDF or Word and return a download link.
getConfluenceContentPermissionsGet explicit content-level permission grants as operation and principal pairs.
getConfluenceContentRestrictionStateGet the general access level: OPEN, EDIT_RESTRICTED, or fully restricted.
getConfluencePublicLinkStatusGet the external public-link (anonymous share) status.
getConfluenceReactionsGet the emoji reactions on content.
getConfluenceTaskGet a single inline task by ID.
listConfluenceTasksList inline tasks, optionally scoped and filtered by status.
listConfluenceTemplatesList templates and blueprints.
getConfluenceTemplateGet a template body.
resolveConfluenceContentMacrosResolve macro wrappers into per-macro HTML.

write_confluence

  • Authentication: OAuth 2.1 and API token
  • Required scope: write:confluence:agent-interface

Whiteboard and database model quality

For whiteboards, Sonnet 4.6 is recommended. GPT 5.5 is compatible, but other models have not been tested for quality.

For databases, Sonnet 4.6 and Opus 4.6 are recommended.

ToolDescription
createConfluenceContent (Primary)Create a page, blog post, live doc, whiteboard, database, embed, smart link, or folder.
updateConfluenceContent (Primary)Update docs, whiteboards, or databases via replacement or granular edits.
createConfluenceSpaceCreate a space. The response includes its ID, key, and homepage ID.
setConfluenceSpaceInstructionsSet the instructions for a space.
copyConfluenceContentCopy a page, whiteboard, database, folder, or embed to a new parent.
moveConfluenceContentMove a page, whiteboard, database, folder, or embed to a new parent or position.
archiveConfluenceContentArchive a single content entity.
unarchiveConfluenceContentUnarchive (restore) a single content entity.
restoreConfluenceContentVersionRestore an earlier version as the new latest version.
convertConfluenceContentModeConvert a page or live doc between classic and live-doc mode.
setConfluenceContentStatusSet the content state (status) of a page or blog post.
createConfluenceCommentCreate or reply to a footer or inline comment.
updateConfluenceCommentUpdate an existing footer or inline comment.
updateConfluenceCommentResolutionResolve or reopen a footer or inline comment.
createConfluenceAttachmentPrepare an attachment upload and return a curl command.
addLabelsToConfluenceContentAdd labels to any content.
addConfluenceReactionAdd an emoji reaction to content.
addConfluenceContentPermissionsAdd content-level grants, preserving existing grants.
removeConfluenceContentPermissionsRemove content-level grants, optionally narrowed by operation or principal.
replaceConfluenceContentPermissionsReplace all content-level grants with the supplied set.
setConfluenceContentRestrictionStateSet the high-level restriction state.
enableConfluencePublicLinkEnable the external public link for a page.
disableConfluencePublicLinkDisable the external public link.
completeConfluenceTaskMark an action item as done.
reopenConfluenceTaskMark a completed action item as not done.
starConfluenceContent / unstarConfluenceContentStar or unstar a page.
starConfluenceSpace / unstarConfluenceSpaceStar or unstar a space.
watchConfluenceContent / unwatchConfluenceContentSubscribe to or unsubscribe from updates on a page.
watchConfluenceSpace / unwatchConfluenceSpaceSubscribe to or unsubscribe from updates in a space.
watchConfluenceLabel / unwatchConfluenceLabelSubscribe to or unsubscribe from updates on content with a label.

search_confluence

  • Authentication: OAuth 2.1 and API token
  • Required scope: search:confluence:agent-interface
ToolDescription
searchConfluence (Primary)Search Confluence content with CQL.

Jira Service Management

API token authentication only

Jira Service Management tools are available only via API token authentication, which your organization admin must enable.

read_jsm

  • Authentication: API token only
ToolRequired scopesDescription
getJsmOpsAlertsread:ops-alert:jira-service-management, read:ops-config:jira-service-management, read:jira-userGet an operations alert by ID, alias, or search query.
getJsmOpsScheduleInforead:ops-config:jira-service-management, read:jira-userList on-call schedules, or get the current or next responders.
getJsmOpsTeamInforead:ops-config:jira-service-management, read:jira-userList operations teams and team details.

write_jsm

  • Authentication: API token only
ToolRequired scopesDescription
updateJsmOpsAlertread:ops-alert:jira-service-management, write:ops-alert:jira-service-managementPerform alert actions: acknowledge, unacknowledge, close, or escalate.

Bitbucket Cloud

Workspace linking required

Bitbucket tools require the Bitbucket workspace to be linked to an Atlassian organization.

read_bitbucket

  • Authentication: OAuth 2.1 and API token
  • Required scope: read:bitbucket:agent-interface
ToolDescription
listBitbucketWorkspacesList the workspaces the user is a member of.
getBitbucketWorkspaceGet a workspace.
listBitbucketRepositoriesList the repositories in a workspace.
getBitbucketRepositoryGet a repository.
getBitbucketRepoDefaultReviewersGet the effective default reviewers for a repository.
getBitbucketRepoFileContentGet file or directory content.
getBitbucketRepoBranchGet a branch.
getBitbucketRepoCommitGet a commit.
listBitbucketRepoCommitReportsList the code-insights reports on a commit.
getBitbucketRepoCommitReportGet a code-insights report on a commit.
getBitbucketRepoCommitReportAnnotationsGet the annotations of a commit report.
listBitbucketRepoPullRequestsList the pull requests in a repository.
getBitbucketRepoPullRequestGet a pull request.
getBitbucketRepoPullRequestDiffGet the diff of a pull request.
listBitbucketRepoPullRequestCommentsList the comments on a pull request.
listBitbucketRepoPullRequestTasksList the tasks on a pull request.
listBitbucketRepoPipelinesList the pipelines for a repository.
getBitbucketRepoPipelineGet a pipeline.
listBitbucketRepoPipelineStepsList the steps of a pipeline.
getBitbucketRepoPipelineStepGet a pipeline step.
getBitbucketRepoPipelineStepLogGet the log of a pipeline step.
listBitbucketRepoDeploymentsList the deployments for a repository.
getBitbucketRepoDeploymentGet a deployment.
listBitbucketRepoEnvironmentsList the deployment environments for a repository.
getBitbucketRepoEnvironmentGet a deployment environment.

write_bitbucket

  • Authentication: OAuth 2.1 and API token
  • Required scope: write:bitbucket:agent-interface
ToolDescription
createBitbucketRepoPullRequestCreate a pull request.
updateBitbucketRepoPullRequestUpdate a pull request.
mergeBitbucketRepoPullRequestMerge a pull request.
approveBitbucketRepoPullRequestApprove a pull request.
requestChangesOnBitbucketRepoPullRequestRequest changes on a pull request.
addBitbucketRepoPullRequestCommentAdd a comment to a pull request.
resolveBitbucketRepoPullRequestCommentResolve a comment thread on a pull request.
reopenBitbucketRepoPullRequestCommentReopen a resolved comment thread.
createBitbucketRepoPullRequestTaskCreate a task on a pull request.
setBitbucketRepoPullRequestTaskStateResolve or reopen a pull request task.
createBitbucketRepoBranchCreate a branch.
createBitbucketRepoCommitCreate a commit.
runBitbucketRepoPipelineRun a pipeline.

Atlassian platform

read_teamwork_graph

  • Authentication: OAuth 2.1 and API token
  • Required scope: read:all:twg
  • Credits: May consume up to 10 Rovo credits per call
ToolDescription
getTeamworkGraphContext (Primary)Retrieve connected context from Teamwork Graph for any Atlassian entity, returning its relationships and linked objects. Supported entry points include Jira work items, spaces, sprints, versions, and comments; Confluence pages, blogposts, whiteboards, databases, and spaces; goals, projects, focus areas, tags, and updates; people, teams, and organizations; DevOps pull requests, repositories, deployments, services, builds, and designs; Loom videos and meetings; Compass components; incidents; conversations; calendar events; and external documents.
getTeamworkGraphObject (Primary)Fetch all available data for one or more objects using their ARIs or URLs.

write_teamwork_graph

  • Authentication: OAuth 2.1 and API token
  • Required scope: write:all:twg
ToolDescription
addTeamworkGraphContext (Primary)Add a relationship between two objects in Teamwork Graph.

search_atlassian

  • Authentication: OAuth 2.1 and API token
  • Required scope: search:rovo:agent-interface
  • Credits: May consume up to 10 Rovo credits per call
ToolDescription
search (beta) (Primary)Semantic search across Jira, Confluence, and connected apps using natural language.

search_code

  • Authentication: OAuth 2.1 only
  • Required scope: search:code:agent-interface
ToolDescription
searchCodeSearch source code across connected providers, returning matching files and specific lines.
getCodeFileRead the full contents of one file at a specific commit.
listCodeDirectoryList the files and subfolders under a path, paginated.
scanCodeRepoList a repository's file paths at a specific commit, without reading contents.
getCodeSymbolFind where a function, class, or variable is defined, and everywhere it's used.
diffCodeSymbolsReport which code parts a change touches, and where else those parts are referenced.

Loom

Workspace linking required

Only Loom workspaces linked to Atlassian sites are available.

read_loom

  • Authentication: OAuth 2.1 and API token
  • Required scope: read:loom:agent-interface
ToolDescription
getLoomVideo (Primary)Get a video's core metadata, and optionally its transcript, comments, AI briefs, extracted meeting action items, or attached links.
listLoomVideosList the videos owned by the user, most recent first.
listLoomVideosSharedWithMeList the videos others have shared with the user, most recent first.
getLoomVideoCommentsGet the comments on a video, with author and in-video timestamp.
getLoomMeetingActionItemsGet the AI-generated meeting action items extracted by Loom.
getLoomVideoDownloadUrlGet a time-limited signed URL to download the MP4 file.
listLoomFoldersList the folders in the current workspace, for moving videos.

write_loom

  • Authentication: OAuth 2.1 and API token
  • Required scope: write:loom:agent-interface
ToolDescription
createLoomVideoUploadStart uploading a new video (step 1 of 2).
publishLoomVideoFinalize video publishing (step 2 of 2).
updateLoomVideoTitleRename a video. The change is immediate and visible to all viewers.
updateLoomVideoPermissionsSet visibility to OWNER, WORKSPACE, or PUBLIC.
shareLoomVideoShare a video with specific Atlassian users by notification.
createLoomVideoCommentPost a comment on a video, anchored to a point in seconds.
createLoomVideoReactionAdd an emoji reaction to a video, anchored to a point in the video.
createLoomFolderCreate a folder in the current workspace, optionally nested or in a space.
moveLoomVideoToFolderMove a video into a folder in the current workspace.
recoverLoomVideoRe-process a video that failed or is stuck.

Goals

read_goals

  • Authentication: OAuth 2.1 and API token
  • Required scope: read:goals:agent-interface
ToolDescription
searchGoalsFind goals by text and structured filters.
getGoalGet one goal by exact ARI or key, with optional related details.
getGoalUpdateGet one goal update by exact ARI, with optional related details.
getGoalTypesGet the goal types available for creating goals and success measures.

write_goals

  • Authentication: OAuth 2.1 and API token
  • Required scope: write:goals:agent-interface
ToolDescription
createGoalCreate a goal or success measure using an enabled goal type.
createGoalUpdateCreate a progress update for an existing goal.
addConnectionsToGoalsAdd one connection type to one or more goals.

Projects

read_projects

  • Authentication: OAuth 2.1 and API token
  • Required scope: read:projects:agent-interface
ToolDescription
searchProjectsFind projects by text and structured filters.
getProjectGet one project by exact ARI or key, with optional related details.
getProjectUpdateGet one project update by exact ARI, with optional related details.

write_projects

  • Authentication: OAuth 2.1 and API token
  • Required scope: write:projects:agent-interface
ToolDescription
createProjectCreate an Atlassian project.
createProjectUpdateCreate a progress update for an existing project.
addConnectionsToProjectsAdd one connection type to one or more projects.

Teams

read_teams

  • Authentication: OAuth 2.1 only
  • Required scope: read:teams:agent-interface
ToolDescription
searchTeamsSearch teams by name with cursor pagination, with optional member list expansion.
getTeamGet the core metadata for one team, with optional expansions for members, projects, goals, and hierarchy.

write_teams

  • Authentication: OAuth 2.1 only
  • Required scope: write:teams:agent-interface
ToolDescription
createTeamCreate a team with MEMBER_INVITE or OPEN membership and up to 50 initial account IDs.
updateTeamUpdate a team.

Focus areas

read_focus

  • Authentication: OAuth 2.1 and API token
  • Required scope: read:focus:agent-interface
ToolDescription
searchFocusAreasSearch focus areas by text and structured filters.
getFocusAreaGet a focus area by UUID, ARI, or page URL, with optional expansions.
getFocusAreaTypesGet the configured focus-area type hierarchy for a workspace.

write_focus

  • Authentication: OAuth 2.1 and API token
  • Required scope: write:focus:agent-interface
ToolDescription
createFocusAreaCreate a focus area in a workspace.
updateFocusAreaUpdate a focus area's name, owner, start date, or description.
createFocusAreaStatusUpdatePost a status update recording a change to status and/or target date.
linkToFocusAreaLink sub-focus areas to a focus area, one connection type per call.

Talent

read_talent

  • Authentication: OAuth 2.1 and API token
  • Required scope: read:talent:agent-interface
ToolDescription
getTalentUserResolve the calling user's position entity ID, their manager's, and their role.
getTalentFieldsDiscover queryable fields, or resolve valid filter values.
searchTalentPositionsSearch positions by attributes using an RQL filter, paginated.
getTalentPositionRead a single position by ARI, with its field values and optionally the worker.
getTalentPositionsByEntityGet the positions attached to an entity - for example, direct reports.
getTalentGroupMetricsAggregate positions into counts grouped by up to four field IDs.

write_talent

  • Authentication: OAuth 2.1 and API token
  • Required scope: write:talent:agent-interface
ToolDescription
createTalentSkillCreate a skill in the skills hierarchy, optionally nested under a parent.
updateTalentWorkerSkillMappingsAssign skills to a worker, or decline previously assigned skills.
updateTalentPositionFocusAreaMappingsAllocate a position to a focus area, one at a time. A new allocation replaces the current one.

Teamwork Graph and third-party data

Teamwork Graph MCP tools can retrieve data from third-party services connected to Jira, such as linked pull requests, builds, and deployments. For the GitHub for Atlassian connector, the data retrievable via MCP depends on the permission level granted to the connector:

  • Full access - MCP tools can retrieve GitHub data based on the user's GitHub permissions.
  • Limited access - MCP tools can retrieve GitHub data based on the user's Jira permissions, which may differ from their GitHub permissions. If a user can see a GitHub link in a Jira work item, they can retrieve only what is shown on that work item.

Security guidance

MCP clients can perform actions across Atlassian apps with your existing permissions. Use least privilege, review high-impact changes before confirming, and monitor audit logs for unusual activity.

Next steps

Rate this page: