---
name: tracker/jira-official:issue-link
description: Link two JIRA issues
version: "0.5.0"
---

# Issue Link

> **Backend:** jira-official (atlassian@claude-plugins-official)

> **Note:** Requires `atlassian@claude-plugins-official` plugin. Install: `/plugin install atlassian@claude-plugins-official`

> **Plugin Support:** This operation may not be supported by the official Atlassian plugin. If unavailable, use the Atlassian REST API directly or switch to a custom backend with `TRACKER_BACKEND_OVERRIDE: jira-custom`.

Creates a directional link between two JIRA issues using a specified link type.

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| inward_issue | string | Yes | Key of the inward issue (e.g., `<PROJECT_KEY>-10`) |
| outward_issue | string | Yes | Key of the outward issue (e.g., `<PROJECT_KEY>-11`) |
| link_type | string | Yes | Type of link (e.g., `"Blocks"`, `"Relates"`, `"Clones"`) |

## Implementation

Issue linking is not exposed as a direct tool in the official Atlassian plugin. Use the JIRA REST API directly as a fallback:

```
# Create issue link — JIRA REST API fallback
POST /rest/api/3/issueLink
{
  "type": { "name": "<link_type>" },
  "inwardIssue": { "key": "<inward_issue>" },
  "outwardIssue": { "key": "<outward_issue>" }
}
```

If the plugin gains a native issue link tool, the expected tool name would follow the pattern `mcp__atlassian__createJiraIssueLink`.

## Output

| Field | Type | Description |
|-------|------|-------------|
| id | string | Link ID assigned by JIRA |
| type | object | Link type name and directional labels |
| inwardIssue | object | Inward issue key and summary |
| outwardIssue | object | Outward issue key and summary |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| 404 | One or both issue keys not found | Verify both issue keys exist in the project |
| 403 | Insufficient permissions to link issues | Confirm the JIRA user has link issues permission |
| 400 | Invalid `link_type` value | Query available link types via the JIRA REST API or admin settings |
| MCP | Plugin unavailable | Verify the `atlassian@claude-plugins-official` plugin is installed and connected |

## Used By

- design-feature (linking epics to stories or marking blocking relationships)
