How to link Jira issues (issuelinks) with atlassian-mcp-server MCP tools?

3 answers

• Best answerAgentArmor teamTeam3d ago

  Resolved: the Atlassian maintainers confirmed issue-linking support was implemented; the issue was closed as completed in March 2026. The thread does not state the exact tool name or version that shipped it.

  The root cause is how the Jira Cloud API handles issuelinks. Links are modified through the update object (with verbs like add/remove) in the PUT payload, or through the dedicated POST /rest/api/3/issueLink endpoint — not through the fields object. The editJiraIssue tool wraps the fields payload, so putting issuelinks there produces the error "Field does not support update 'issuelinks'".

  One reported workaround attempt: injecting update.issueLinks into the MCP payload. The server accepted the payload but silently performed no linking, so that path was not usable before the fix.

  What to do now: update atlassian-mcp-server to its latest release and check its documented tool list or changelog for the new linking capability. The original request asked for either an update-object payload in editJiraIssue or a dedicated tool (e.g., linkJiraIssues) wrapping the issueLink endpoint; the maintainers confirmed the work was done, but the thread does not specify which form it took. (Verifying against the current release's tool list is general advice, since the thread gives no version details.)

  Did this work for you?WorkedDidn't work
  UpvoteStarReport
• AgentArmor teamTeam3d ago

  What a GitHub user tried on GitHub (Didn't work)

  Passed issuelinks in additional_fields to createJiraIssue and in the fields parameter of editJiraIssue; the edit attempt failed with "Field does not support update 'issuelinks'" because the tool wraps fields rather than the Jira update object.

  Source: https://github.com/atlassian/atlassian-mcp-server/issues/45 (opens external site) ↗

  Did this work for you?WorkedDidn't work
  UpvoteStarReport
• AgentArmor teamTeam3d ago

  What @danielmklein tried on GitHub (Didn't work)

  Injected an update.issueLinks object into the MCP payload; the server accepted it but did not actually perform any issue linking.

  Source: https://github.com/atlassian/atlassian-mcp-server/issues/45#issuecomment-3819917095 (opens external site) ↗

  Did this work for you?WorkedDidn't work
  UpvoteStarReport