> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira (legacy)

> Issues, projects, and boards (legacy)

<Warning>
  This monolithic `/jira` application server is **legacy**. For new integrations, use the [Jira Cloud](/api-reference/mcp-servers/application/jira-cloud) page and its child server paths (`/jira-issues`, `/jira-projects`, `/jira-users`).
</Warning>

**Server path:** `/jira` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                            | Description                                           |
| --------------------------------------------------------------- | ----------------------------------------------------- |
| [`jira_create_issue`](#jira_create_issue)                       | Create a new issue in Jira                            |
| [`jira_update_issue`](#jira_update_issue)                       | Update an existing issue in Jira                      |
| [`jira_get_issue`](#jira_get_issue)                             | Get details of a specific issue by ID or key          |
| [`jira_search_issues`](#jira_search_issues)                     | Search for issues using JQL (Jira Query Language)     |
| [`jira_get_projects`](#jira_get_projects)                       | Get all projects that the user has permission to view |
| [`jira_search_user`](#jira_search_user)                         | Search for users by email address or display name     |
| [`jira_assign_issue`](#jira_assign_issue)                       | Assign an issue to a user by account ID               |
| [`jira_add_comment_to_issue`](#jira_add_comment_to_issue)       | Add a comment to a Jira issue                         |
| [`jira_list_issue_comments`](#jira_list_issue_comments)         | List all comments on a Jira issue                     |
| [`jira_add_attachment_to_issue`](#jira_add_attachment_to_issue) | Add an attachment to a Jira issue                     |
| [`jira_transition_issue`](#jira_transition_issue)               | Transition a Jira issue to a different status         |
| [`jira_get_transitions`](#jira_get_transitions)                 | Get available transitions for a Jira issue            |

***

## jira\_create\_issue

Create a new issue in Jira

**Parameters:**

| Parameter     | Type   | Required | Default  | Description                                                 |
| ------------- | ------ | -------- | -------- | ----------------------------------------------------------- |
| `projectKey`  | string | Yes      | —        | Project key (e.g., "SUP")                                   |
| `summary`     | string | Yes      | —        | Issue summary/title                                         |
| `description` | string | Yes      | —        | Issue description (plain text or markdown)                  |
| `issueType`   | string | No       | `"Task"` | Issue type (e.g., "Bug", "Task", "Story", "Epic", "Subtask) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "projectKey": {
        "type": "string",
        "description": "Project key (e.g., \"SUP\")"
      },
      "summary": {
        "type": "string",
        "description": "Issue summary/title"
      },
      "description": {
        "type": "string",
        "description": "Issue description (plain text or markdown)"
      },
      "issueType": {
        "type": "string",
        "default": "Task",
        "description": "Issue type (e.g., \"Bug\", \"Task\", \"Story\", \"Epic\", \"Subtask)"
      }
    },
    "required": [
      "PCID",
      "projectKey",
      "summary",
      "description"
    ]
  }
  ```
</Expandable>

***

## jira\_update\_issue

Update an existing issue in Jira

**Parameters:**

| Parameter     | Type   | Required | Default | Description                                                                   |
| ------------- | ------ | -------- | ------- | ----------------------------------------------------------------------------- |
| `issueId`     | string | Yes      | —       | Issue ID or key to update                                                     |
| `summary`     | string | No       | —       | Updated issue summary/title                                                   |
| `description` | string | No       | —       | Updated issue description (plain text or markdown)                            |
| `assignee`    | string | No       | —       | Account ID of the user to assign to                                           |
| `status`      | string | No       | —       | Status to set for the issue                                                   |
| `priority`    | string | No       | —       | Priority ID as string: "1"=Highest, "2"=High, "3"=Medium, "4"=Low, "5"=Lowest |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "issueId": {
        "type": "string",
        "description": "Issue ID or key to update"
      },
      "summary": {
        "type": "string",
        "description": "Updated issue summary/title"
      },
      "description": {
        "type": "string",
        "description": "Updated issue description (plain text or markdown)"
      },
      "assignee": {
        "type": "string",
        "description": "Account ID of the user to assign to"
      },
      "status": {
        "type": "string",
        "description": "Status to set for the issue"
      },
      "priority": {
        "type": "string",
        "description": "Priority ID as string: \"1\"=Highest, \"2\"=High, \"3\"=Medium, \"4\"=Low, \"5\"=Lowest"
      }
    },
    "required": [
      "PCID",
      "issueId"
    ]
  }
  ```
</Expandable>

***

## jira\_get\_issue

Get details of a specific issue by ID or key

**Parameters:**

| Parameter | Type   | Required | Default | Description                 |
| --------- | ------ | -------- | ------- | --------------------------- |
| `issueId` | string | Yes      | —       | Issue ID or key to retrieve |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "issueId": {
        "type": "string",
        "description": "Issue ID or key to retrieve"
      }
    },
    "required": [
      "PCID",
      "issueId"
    ]
  }
  ```
</Expandable>

***

## jira\_search\_issues

Search for issues using JQL (Jira Query Language)

**Parameters:**

| Parameter    | Type      | Required | Default | Description                                                                      |
| ------------ | --------- | -------- | ------- | -------------------------------------------------------------------------------- |
| `jql`        | string    | No       | —       | JQL query string (e.g., "project = PROJ AND priority = High AND created >= -7d") |
| `startAt`    | number    | No       | `0`     | Starting index for pagination (default: 0)                                       |
| `maxResults` | number    | No       | `50`    | Maximum number of issues to return (default: 50)                                 |
| `fields`     | string\[] | No       | —       | List of fields to return (e.g., \["summary", "status"])                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "jql": {
        "type": "string",
        "description": "JQL query string (e.g., \"project = PROJ AND priority = High AND created >= -7d\")"
      },
      "startAt": {
        "type": "number",
        "default": 0,
        "description": "Starting index for pagination (default: 0)"
      },
      "maxResults": {
        "type": "number",
        "default": 50,
        "description": "Maximum number of issues to return (default: 50)"
      },
      "fields": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "List of fields to return (e.g., [\"summary\", \"status\"])"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## jira\_get\_projects

Get all projects that the user has permission to view

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## jira\_search\_user

Search for users by email address or display name

**Parameters:**

| Parameter | Type   | Required | Default | Description                                  |
| --------- | ------ | -------- | ------- | -------------------------------------------- |
| `query`   | string | Yes      | —       | Search query (email address or display name) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "query": {
        "type": "string",
        "description": "Search query (email address or display name)"
      }
    },
    "required": [
      "PCID",
      "query"
    ]
  }
  ```
</Expandable>

***

## jira\_assign\_issue

Assign an issue to a user by account ID

**Parameters:**

| Parameter      | Type   | Required | Default | Description                         |
| -------------- | ------ | -------- | ------- | ----------------------------------- |
| `issueIdOrKey` | string | Yes      | —       | Issue ID or key to assign           |
| `accountId`    | string | Yes      | —       | Account ID of the user to assign to |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "PinkConnect ID"
      },
      "issueIdOrKey": {
        "type": "string",
        "description": "Issue ID or key to assign"
      },
      "accountId": {
        "type": "string",
        "description": "Account ID of the user to assign to"
      }
    },
    "required": [
      "PCID",
      "issueIdOrKey",
      "accountId"
    ]
  }
  ```
</Expandable>

***

## jira\_add\_comment\_to\_issue

Add a comment to a Jira issue

**Parameters:**

| Parameter      | Type   | Required | Default | Description                       |
| -------------- | ------ | -------- | ------- | --------------------------------- |
| `issueIdOrKey` | string | Yes      | —       | Issue ID or key to add comment to |
| `comment`      | string | Yes      | —       | Comment text to add to the issue  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "issueIdOrKey": {
        "type": "string",
        "description": "Issue ID or key to add comment to"
      },
      "comment": {
        "type": "string",
        "description": "Comment text to add to the issue"
      }
    },
    "required": [
      "PCID",
      "issueIdOrKey",
      "comment"
    ]
  }
  ```
</Expandable>

***

## jira\_list\_issue\_comments

List all comments on a Jira issue

**Parameters:**

| Parameter      | Type   | Required | Default | Description                          |
| -------------- | ------ | -------- | ------- | ------------------------------------ |
| `issueIdOrKey` | string | Yes      | —       | Issue ID or key to list comments for |
| `maxResults`   | number | No       | `50`    | Maximum number of comments to return |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "issueIdOrKey": {
        "type": "string",
        "description": "Issue ID or key to list comments for"
      },
      "maxResults": {
        "type": "number",
        "default": 50,
        "description": "Maximum number of comments to return"
      }
    },
    "required": [
      "PCID",
      "issueIdOrKey"
    ]
  }
  ```
</Expandable>

***

## jira\_add\_attachment\_to\_issue

Add an attachment to a Jira issue

**Parameters:**

| Parameter      | Type   | Required | Default | Description                          |
| -------------- | ------ | -------- | ------- | ------------------------------------ |
| `issueIdOrKey` | string | Yes      | —       | Issue ID or key to add attachment to |
| `fileUrl`      | string | Yes      | —       | URL of the file to attach            |
| `filename`     | string | Yes      | —       | Name for the attached file           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "issueIdOrKey": {
        "type": "string",
        "description": "Issue ID or key to add attachment to"
      },
      "fileUrl": {
        "type": "string",
        "description": "URL of the file to attach"
      },
      "filename": {
        "type": "string",
        "description": "Name for the attached file"
      }
    },
    "required": [
      "PCID",
      "issueIdOrKey",
      "fileUrl",
      "filename"
    ]
  }
  ```
</Expandable>

***

## jira\_transition\_issue

Transition a Jira issue to a different status

**Parameters:**

| Parameter      | Type   | Required | Default | Description                               |
| -------------- | ------ | -------- | ------- | ----------------------------------------- |
| `issueIdOrKey` | string | Yes      | —       | Issue ID or key to transition             |
| `transitionId` | string | Yes      | —       | ID of the transition to perform           |
| `comment`      | string | No       | —       | Optional comment to add during transition |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "issueIdOrKey": {
        "type": "string",
        "description": "Issue ID or key to transition"
      },
      "transitionId": {
        "type": "string",
        "description": "ID of the transition to perform"
      },
      "comment": {
        "type": "string",
        "description": "Optional comment to add during transition"
      }
    },
    "required": [
      "PCID",
      "issueIdOrKey",
      "transitionId"
    ]
  }
  ```
</Expandable>

***

## jira\_get\_transitions

Get available transitions for a Jira issue

**Parameters:**

| Parameter      | Type   | Required | Default | Description                            |
| -------------- | ------ | -------- | ------- | -------------------------------------- |
| `issueIdOrKey` | string | Yes      | —       | Issue ID or key to get transitions for |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID"
      },
      "issueIdOrKey": {
        "type": "string",
        "description": "Issue ID or key to get transitions for"
      }
    },
    "required": [
      "PCID",
      "issueIdOrKey"
    ]
  }
  ```
</Expandable>