Complete reference for all Tools (actions) supported by the MCP Atlassian Server, including Atlassian API endpoints and technical implementation details.
This document provides detailed information about:
- How Tools are implemented
- Adding new or extending existing Tools
- Handling special cases (ADF format, version conflicts, error handling)
- Debugging and maintenance
| Tool |
Description |
Key Parameters |
Atlassian API Endpoint |
Output |
| getIssue |
Get issue details |
issueIdOrKey |
/rest/api/3/issue/{issueIdOrKey} |
Issue fields |
| listIssues |
Search issues with JQL |
jql, project, status, assignee, limit |
/rest/api/3/issue/picker / /rest/api/3/search |
List of issues |
| getComments |
Get issue comments |
issueIdOrKey, startAt, maxResults |
/rest/api/3/issue/{issueIdOrKey}/comment |
Comments list with pagination |
| getProject |
Get project details |
projectKey |
/rest/api/3/project/{projectKey} |
Project fields |
| listProjects |
List all projects |
type |
/rest/api/3/project/search |
List of projects |
| listIssueTypes |
List issue types for a project |
projectKey |
/rest/api/3/issuetype/project |
List of issue types with id, name, subtask flag |
| Tool |
Description |
Key Parameters |
Atlassian API Endpoint |
Output |
| createIssue |
Create new issue |
projectKey, summary, ... |
/rest/api/3/issue |
Issue key and ID |
| updateIssue |
Update issue |
issueKey, summary, ... |
/rest/api/3/issue/{issueIdOrKey} |
Update status |
| changeIssueType |
Change issue type (incl. Sub-task ↔ Story) |
issueIdsOrKeys, targetProjectKey, targetIssueTypeId |
/rest/api/3/bulk/issues/move |
Move task ID |
| transitionIssue |
Change issue status |
issueKey, transitionId |
/rest/api/3/issue/{issueIdOrKey}/transitions |
Transition status |
| assignIssue |
Assign issue to user |
issueKey, accountId |
/rest/api/3/issue/{issueIdOrKey}/assignee |
Assignment status |
| addIssueComment |
Add comment to issue |
issueIdOrKey, body (ADF) |
/rest/api/3/issue/{issueIdOrKey}/comment |
New comment ID |
| updateIssueComment |
Update issue comment |
issueIdOrKey, commentId, body (ADF) |
/rest/api/3/issue/{issueIdOrKey}/comment/{commentId} (PUT) |
Update status |
| deleteIssueComment |
Delete issue comment |
issueIdOrKey, commentId |
/rest/api/3/issue/{issueIdOrKey}/comment/{commentId} (DELETE) |
Delete status |
| deleteIssue |
Delete issue |
issueIdOrKey |
/rest/api/3/issue/{issueIdOrKey} (DELETE) |
Delete status |
| addIssuesToBacklog |
Move issues to backlog |
boardId, issueKeys |
/rest/agile/1.0/backlog/issue or /rest/agile/1.0/backlog/{boardId}/issue |
Operation status |
| addIssueToSprint |
Add issues to sprint |
sprintId, issueKeys |
/rest/agile/1.0/sprint/{sprintId}/issue |
Operation status |
| rankBacklogIssues |
Reorder backlog issues |
boardId, issueKeys, rankBeforeIssue, rankAfterIssue |
/rest/agile/1.0/backlog/rank |
Ranking status |
| Tool |
Description |
Key Parameters |
Atlassian API Endpoint |
Output |
| createSprint |
Create new sprint |
boardId, name, ... |
/rest/agile/1.0/sprint |
New sprint ID |
| startSprint |
Start sprint |
sprintId, ... |
/rest/agile/1.0/sprint/{sprintId}/start |
Start status |
| closeSprint |
Close sprint |
sprintId, ... |
/rest/agile/1.0/sprint/{sprintId}/close |
Close status |
| Tool |
Description |
Key Parameters |
Atlassian API Endpoint |
Output |
| createFilter |
Create new filter |
name, jql, ... |
/rest/api/3/filter |
New filter ID |
| updateFilter |
Update filter |
filterId, ... |
/rest/api/3/filter/{filterId} |
Update status |
| deleteFilter |
Delete filter |
filterId |
/rest/api/3/filter/{filterId} |
Delete status |
| Tool |
Description |
Key Parameters |
Atlassian API Endpoint |
Output |
| createDashboard |
Create new dashboard |
name, ... |
/rest/api/3/dashboard |
New dashboard ID |
| updateDashboard |
Update dashboard |
dashboardId, ... |
/rest/api/3/dashboard/{dashboardId} |
Update status |
| addGadgetToDashboard |
Add gadget to dashboard |
dashboardId, uri, ... |
/rest/api/3/dashboard/{dashboardId}/gadget |
New gadget ID |
| removeGadgetFromDashboard |
Delete gadget from dashboard |
dashboardId, gadgetId |
/rest/api/3/dashboard/{dashboardId}/gadget/{gadgetId} |
Delete status |
| Tool |
Description |
Key Parameters |
Atlassian API Endpoint |
Output |
| getPage |
Get page by ID with content |
pageId, bodyFormat |
/wiki/api/v2/pages/{pageId} |
Page content and metadata |
| getChildPages |
List direct children of a page |
pageId, limit, cursor, sort |
/wiki/api/v2/pages/{pageId}/children |
List of child pages (metadata only) |
| getPageTree |
Get full descendant hierarchy tree |
pageId, maxDepth, limit |
/wiki/api/v2/pages/{pageId}/children (recursive) |
Nested tree of pages |
| listPages |
List pages with filtering |
spaceId, title, status, limit |
/wiki/api/v2/pages |
List of pages |
| getSpace |
Get space by ID |
spaceId |
/wiki/api/v2/spaces/{spaceId} |
Space details |
| listSpaces |
List all spaces |
type, status, limit |
/wiki/api/v2/spaces |
List of spaces |
| Tool |
Description |
Key Parameters |
Atlassian API Endpoint |
Output |
| createPage |
Create new page |
spaceId, title, content, parentId |
/wiki/api/v2/pages |
New page I
3752
D |
| updatePage |
Update page content |
pageId, title, content, version |
/wiki/api/v2/pages/{pageId} (PUT) |
Update status |
| findAndReplace |
Find and replace text in a page |
pageId, searchReplace, version, bodyFormat |
/wiki/api/v2/pages/{pageId} (GET + PUT) |
Replacement summary |
| updatePageTitle |
Update page title |
pageId, title, version |
/wiki/api/v2/pages/{pageId} (PUT) |
Update status |
| deletePage |
Delete page |
pageId, draft, purge |
/wiki/api/v2/pages/{pageId} (DELETE) |
Delete status |
3. Comment
| Tool |
Description |
Key Parameters |
Atlassian API Endpoint |
Output |
| addComment |
Add comment to page |
pageId, content |
/wiki/api/v2/footer-comments |
New comment |
| updateFooterComment |
Update footer comment |
commentId, version, value, ... |
/wiki/api/v2/footer-comments/{commentId} (PUT) |
Update status |
| deleteFooterComment |
Delete footer comment |
commentId |
/wiki/api/v2/footer-comments/{commentId} (DELETE) |
Delete status |
| addAttachment |
Upload file attachment to page |
pageId, filename, content, mediaType |
/wiki/rest/api/content/{pageId}/child/attachment (POST multipart) |
Attachment ID and URL |