sooperset/mcp-atlassian

jira_get_user_profile

Retrieve profile information for a specific Jira user.

Args:
    ctx: The FastMCP context.
    user_identifier: User identifier (email, username, key, or account ID).

Returns:
    JSON string representing the Jira user profile object, or an error object if not found.

Raises:
    ValueError: If the Jira client is not configured or available.

jira_get_issue

Get details of a specific Jira issue including its Epic links and relationship information.

Args:
    ctx: The FastMCP context.
    issue_key: Jira issue key.
    fields: Comma-separated list of fields to return (e.g., 'summary,status,customfield_10010'), a single field as a string (e.g., 'duedate'), '*all' for all fields, or omitted for essentials.
    expand: Optional fields to expand.
    comment_limit: Maximum number of comments.
    properties: Issue properties to return.
    update_history: Whether to update issue view history.

Returns:
    JSON string representing the Jira issue object.

Raises:
    ValueError: If the Jira client is not configured or available.

jira_search

Search Jira issues using JQL (Jira Query Language).

Args:
    ctx: The FastMCP context.
    jql: JQL query string.
    fields: Comma-separated fields to return.
    limit: Maximum number of results.
    start_at: Starting index for pagination.
    projects_filter: Comma-separated list of project keys to filter by.
    expand: Optional fields to expand.

Returns:
    JSON string representing the search results including pagination info.

jira_search_fields

Search Jira fields by keyword with fuzzy match.

Args:
    ctx: The FastMCP context.
    keyword: Keyword for fuzzy search.
    limit: Maximum number of results.
    refresh: Whether to force refresh the field list.

Returns:
    JSON string representing a list of matching field definitions.

jira_get_project_issues

Get all issues for a specific Jira project.

Args:
    ctx: The FastMCP context.
    project_key: The project key.
    limit: Maximum number of results.
    start_at: Starting index for pagination.

Returns:
    JSON string representing the search results including pagination info.

jira_get_transitions

Get available status transitions for a Jira issue.

Args:
    ctx: The FastMCP context.
    issue_key: Jira issue key.

Returns:
    JSON string representing a list of available transitions.

jira_get_worklog

Get worklog entries for a Jira issue.

Args:
    ctx: The FastMCP context.
    issue_key: Jira issue key.

Returns:
    JSON string representing the worklog entries.

jira_download_attachments

Download attachments from a Jira issue.

Args:
    ctx: The FastMCP context.
    issue_key: Jira issue key.
    target_dir: Directory to save attachments.

Returns:
    JSON string indicating the result of the download operation.

jira_get_agile_boards

Get jira agile boards by name, project key, or type.

Args:
    ctx: The FastMCP context.
    board_name: Name of the board (fuzzy search).
    project_key: Project key.
    board_type: Board type ('scrum' or 'kanban').
    start_at: Starting index.
    limit: Maximum results.

Returns:
    JSON string representing a list of board objects.

jira_get_board_issues

Get all issues linked to a specific board filtered by JQL.

Args:
    ctx: The FastMCP context.
    board_id: The ID of the board.
    jql: JQL query string to filter issues.
    fields: Comma-separated fields to return.
    start_at: Starting index for pagination.
    limit: Maximum number of results.
    expand: Optional fields to expand.

Returns:
    JSON string representing the search results including pagination info.

jira_get_sprints_from_board

Get jira sprints from board by state.

Args:
    ctx: The FastMCP context.
    board_id: The ID of the board.
    state: Sprint state ('active', 'future', 'closed'). If None, returns all sprints.
    start_at: Starting index.
    limit: Maximum results.

Returns:
    JSON string representing a list of sprint objects.

jira_get_sprint_issues

Get jira issues from sprint.

Args:
    ctx: The FastMCP context.
    sprint_id: The ID of the sprint.
    fields: Comma-separated fields to return.
    start_at: Starting index.
    limit: Maximum results.

Returns:
    JSON string representing the search results including pagination info.

jira_get_link_types

Get all available issue link types.

Args:
    ctx: The FastMCP context.

Returns:
    JSON string representing a list of issue link type objects.

jira_create_issue

Create a new Jira issue with optional Epic link or parent for subtasks.

Args:
    ctx: The FastMCP context.
    project_key: The JIRA project key.
    summary: Summary/title of the issue.
    issue_type: Issue type (e.g., 'Task', 'Bug', 'Story', 'Epic', 'Subtask').
    assignee: Assignee's user identifier (string): Email, display name, or account ID (e.g., 'user@example.com', 'John Doe', 'accountid:...').
    description: Issue description.
    components: Comma-separated list of component names.
    additional_fields: Dictionary of additional fields.

Returns:
    JSON string representing the created issue object.

Raises:
    ValueError: If in read-only mode or Jira client is unavailable.

jira_batch_create_issues

Create multiple Jira issues in a batch.

Args:
    ctx: The FastMCP context.
    issues: JSON array string of issue objects.
    validate_only: If true, only validates without creating.

Returns:
    JSON string indicating success and listing created issues (or validation result).

Raises:
    ValueError: If in read-only mode, Jira client unavailable, or invalid JSON.

jira_batch_get_changelogs

Get changelogs for multiple Jira issues (Cloud only).

Args:
    ctx: The FastMCP context.
    issue_ids_or_keys: List of issue IDs or keys.
    fields: List of fields to filter changelogs by. None for all fields.
    limit: Maximum changelogs per issue (-1 for all).

Returns:
    JSON string representing a list of issues with their changelogs.

Raises:
    NotImplementedError: If run on Jira Server/Data Center.
    ValueError: If Jira client is unavailable.

jira_update_issue

Update an existing Jira issue including changing status, adding Epic links, updating fields, etc.

Args:
    ctx: The FastMCP context.
    issue_key: Jira issue key.
    fields: Dictionary of fields to update.
    additional_fields: Optional dictionary of additional fields.
    attachments: Optional JSON array string or comma-separated list of file paths.

Returns:
    JSON string representing the updated issue object and attachment results.

Raises:
    ValueError: If in read-only mode or Jira client unavailable, or invalid input.

jira_delete_issue

Delete an existing Jira issue.

Args:
    ctx: The FastMCP context.
    issue_key: Jira issue key.

Returns:
    JSON string indicating success.

Raises:
    ValueError: If in read-only mode or Jira client unavailable.

jira_add_comment

Add a comment to a Jira issue.

Args:
    ctx: The FastMCP context.
    issue_key: Jira issue key.
    comment: Comment text in Markdown.

Returns:
    JSON string representing the added comment object.

Raises:
    ValueError: If in read-only mode or Jira client unavailable.

jira_add_worklog

Add a worklog entry to a Jira issue.

Args:
    ctx: The FastMCP context.
    issue_key: Jira issue key.
    time_spent: Time spent in Jira format.
    comment: Optional comment in Markdown.
    started: Optional start time in ISO format.
    original_estimate: Optional new original estimate.
    remaining_estimate: Optional new remaining estimate.


Returns:
    JSON string representing the added worklog object.

Raises:
    ValueError: If in read-only mode or Jira client unavailable.

jira_link_to_epic

Link an existing issue to an epic.

Args:
    ctx: The FastMCP context.
    issue_key: The key of the issue to link.
    epic_key: The key of the epic to link to.

Returns:
    JSON string representing the updated issue object.

Raises:
    ValueError: If in read-only mode or Jira client unavailable.

jira_create_issue_link

Create a link between two Jira issues.

Args:
    ctx: The FastMCP context.
    link_type: The type of link (e.g., 'Blocks').
    inward_issue_key: The key of the source issue.
    outward_issue_key: The key of the target issue.
    comment: Optional comment text.
    comment_visibility: Optional dictionary for comment visibility.

Returns:
    JSON string indicating success or failure.

Raises:
    ValueError: If required fields are missing, invalid input, in read-only mode, or Jira client unavailable.

jira_create_remote_issue_link

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

This tool allows you to add web links and Confluence links to Jira issues.
The links will appear in the issue's "Links" section and can be clicked to navigate to external resources.

Args:
    ctx: The FastMCP context.
    issue_key: The key of the issue to add the link to.
    url: The URL to link to (can be any web page or Confluence page).
    title: The title/name that will be displayed for the link.
    summary: Optional description of what the link is for.
    relationship: Optional relationship description.
    icon_url: Optional URL to a 16x16 icon for the link.

Returns:
    JSON string indicating success or failure.

Raises:
    ValueError: If required fields are missing, invalid input, in read-only mode, or Jira client unavailable.

jira_remove_issue_link

Remove a link between two Jira issues.

Args:
    ctx: The FastMCP context.
    link_id: The ID of the link to remove.

Returns:
    JSON string indicating success.

Raises:
    ValueError: If link_id is missing, in read-only mode, or Jira client unavailable.

jira_transition_issue

Transition a Jira issue to a new status.

Args:
    ctx: The FastMCP context.
    issue_key: Jira issue key.
    transition_id: ID of the transition.
    fields: Optional dictionary of fields to update during transition.
    comment: Optional comment for the transition.

Returns:
    JSON string representing the updated issue object.

Raises:
    ValueError: If required fields missing, invalid input, in read-only mode, or Jira client unavailable.

jira_create_sprint

Create Jira sprint for a board.

Args:
    ctx: The FastMCP context.
    board_id: Board ID.
    sprint_name: Sprint name.
    start_date: Start date (ISO format).
    end_date: End date (ISO format).
    goal: Optional sprint goal.

Returns:
    JSON string representing the created sprint object.

Raises:
    ValueError: If in read-only mode or Jira client unavailable.

jira_update_sprint

Update jira sprint.

Args:
    ctx: The FastMCP context.
    sprint_id: The ID of the sprint.
    sprint_name: Optional new name.
    state: Optional new state (future|active|closed).
    start_date: Optional new start date.
    end_date: Optional new end date.
    goal: Optional new goal.

Returns:
    JSON string representing the updated sprint object or an error message.

Raises:
    ValueError: If in read-only mode or Jira client unavailable.

jira_get_project_versions

Get all fix versions for a specific Jira project.

jira_get_all_projects

Get all Jira projects accessible to the current user.

Args:
    ctx: The FastMCP context.
    include_archived: Whether to include archived projects.

Returns:
    JSON string representing a list of project objects accessible to the user.
    Project keys are always returned in uppercase.
    If JIRA_PROJECTS_FILTER is configured, only returns projects matching those keys.

Raises:
    ValueError: If the Jira client is not configured or available.

jira_create_version

Create a new fix version in a Jira project.

Args:
    ctx: The FastMCP context.
    project_key: The project key.
    name: Name of the version.
    start_date: Start date (optional).
    release_date: Release date (optional).
    description: Description (optional).

Returns:
    JSON string of the created version object.

jira_batch_create_versions

Batch create multiple versions in a Jira project.

Args:
    ctx: The FastMCP context.
    project_key: The project key.
    versions: JSON array string of version objects.

Returns:
    JSON array of results, each with success flag, version or error.