> ## Documentation Index
> Fetch the complete documentation index at: https://mcp-atlassian.soomiles.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Jira Links & Versions
> Issue links, epic links, remote links, versions, components, and cross-project and epic hierarchy analysis
### 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.
This is a **write** tool. Disabled when `READ_ONLY_MODE=true`.
**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. Rejected when either linked issue belongs to a project listed in JIRA\_INTERNAL\_ONLY\_PROJECTS (a link comment may be customer-visible on JSM and cannot be forced internal): create the link without a comment, then post an internal note with jira\_add\_comment(public=false) on the relevant issue. |
| `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.
This is a **write** tool. Disabled when `READ_ONLY_MODE=true`.
**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.
This is a **write** tool. Disabled when `READ_ONLY_MODE=true`.
**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.
This is a **write** tool. Disabled when `READ_ONLY_MODE=true`.
**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](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.
This is a **write** tool. Disabled when `READ_ONLY_MODE=true`.
**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.
This is a **write** tool. Disabled when `READ_ONLY_MODE=true`.
**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"}` ] |
***
### Update Version
Update an existing fix version in a Jira project.
This is a **write** tool. Disabled when `READ_ONLY_MODE=true`.
**Parameters:**
| Parameter | Type | Required | Description |
| -------------- | --------- | -------- | -------------------------------------------------- |
| `version_id` | `string` | Yes | Numeric ID of the version to update (e.g. '10001') |
| `name` | `string` | No | New name for the version |
| `description` | `string` | No | New description for the version |
| `start_date` | `string` | No | New start date (YYYY-MM-DD) |
| `release_date` | `string` | No | New release date (YYYY-MM-DD) |
| `archived` | `boolean` | No | Set archived flag (true to archive) |
| `released` | `boolean` | No | Set released flag (true to mark released) |
***
### Get Project Epic Hierarchy
Group a project's epics under their cross-project parent issues.
**Parameters:**
| Parameter | Type | Required | Description |
| ------------- | --------- | -------- | ---------------------------------------- |
| `project_key` | `string` | Yes | Jira project key (e.g., 'PROJ') |
| `max_epics` | `integer` | No | Maximum number of epics to fetch (1-500) |
***
### Get Cross-Project Dependencies
Find all cross-project issue links for a project.
**Parameters:**
| Parameter | Type | Required | Description |
| ------------- | --------- | -------- | ---------------------------------------- |
| `project_key` | `string` | Yes | Jira project key (e.g., 'PROJ') |
| `max_issues` | `integer` | No | Maximum issues to scan for links (1-500) |
***