---
title: "Jira Links & Versions"
description: "Issue links, epic links, remote links, project versions, and components"
---

### Get Link Types

Get all available issue link types.

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name_filter` | `string` | No | (Optional) Filter link types by name substring (case-insensitive) |

---

### Create Issue Link

Create a link between two Jira issues.

<Note>This is a **write** tool. Disabled when `READ_ONLY_MODE=true`.</Note>

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `link_type` | `string` | Yes | The type of link to create (e.g., 'Duplicate', 'Blocks', 'Relates to') |
| `inward_issue_key` | `string` | Yes | The key of the inward issue (e.g., 'PROJ-123', 'ACV2-642') |
| `outward_issue_key` | `string` | Yes | The key of the outward issue (e.g., 'PROJ-456') |
| `comment` | `string` | No | (Optional) Comment to add to the link |
| `comment_visibility` | `string` | No | (Optional) Visibility settings for the comment as JSON string (e.g. `'{"type":"group","value":"jira-users"}'`) |

---

### Remove Issue Link

Remove a link between two Jira issues.

<Note>This is a **write** tool. Disabled when `READ_ONLY_MODE=true`.</Note>

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `link_id` | `string` | Yes | The ID of the link to remove |

---

### Link to Epic

Link an existing issue to an epic.

<Note>This is a **write** tool. Disabled when `READ_ONLY_MODE=true`.</Note>

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `issue_key` | `string` | Yes | The key of the issue to link (e.g., 'PROJ-123', 'ACV2-642') |
| `epic_key` | `string` | Yes | The key of the epic to link to (e.g., 'PROJ-456') |

---

### Create Remote Issue Link

Create a remote issue link (web link or Confluence link) for a Jira issue.

<Note>This is a **write** tool. Disabled when `READ_ONLY_MODE=true`.</Note>

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `issue_key` | `string` | Yes | The key of the issue to add the link to (e.g., 'PROJ-123', 'ACV2-642') |
| `url` | `string` | Yes | The URL to link to (e.g., 'https://example.com/page' or Confluence page URL) |
| `title` | `string` | Yes | The title/name of the link (e.g., 'Documentation Page', 'Confluence Page') |
| `summary` | `string` | No | (Optional) Description of the link |
| `relationship` | `string` | No | (Optional) Relationship description (e.g., 'causes', 'relates to', 'documentation') |
| `icon_url` | `string` | No | (Optional) URL to a 16x16 icon for the link |

---

### Get Project Versions

Get all fix versions for a specific Jira project.

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_key` | `string` | Yes | Jira project key (e.g., 'PROJ', 'ACV2') |

---

### Get Project Components

Get all components for a specific Jira project.

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_key` | `string` | Yes | Jira project key (e.g., 'PROJ', 'ACV2') |

---

### Create Version

Create a new fix version in a Jira project.

<Note>This is a **write** tool. Disabled when `READ_ONLY_MODE=true`.</Note>

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_key` | `string` | Yes | Jira project key (e.g., 'PROJ', 'ACV2') |
| `name` | `string` | Yes | Name of the version |
| `start_date` | `string` | No | Start date (YYYY-MM-DD) |
| `release_date` | `string` | No | Release date (YYYY-MM-DD) |
| `description` | `string` | No | Description of the version |

---

### Batch Create Versions

Batch create multiple versions in a Jira project.

<Note>This is a **write** tool. Disabled when `READ_ONLY_MODE=true`.</Note>

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_key` | `string` | Yes | Jira project key (e.g., 'PROJ', 'ACV2') |
| `versions` | `string` | Yes | JSON array of version objects. Each object should contain: - name (required): Name of the version - startDate (optional): Start date (YYYY-MM-DD) - releaseDate (optional): Release date (YYYY-MM-DD) - description (optional): Description of the version Example: `[{"name": "v1.0", "startDate": "2025-01-01", "releaseDate": "2025-02-01", "description": "First release"}, {"name": "v2.0"}]` |

---
