final-il/jira-mcp-server
If you are the rightful owner of jira-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
Model Context Protocol (MCP) server for Atlassian products (Confluence and Jira). This integration supports both Confluence & Jira Cloud and Server/Data Center deployments.
Tools
Functions exposed to the LLM to take actions
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.
confluence_search
Search Confluence content using simple terms or CQL.
Args: ctx: The FastMCP context. query: Search query - can be simple text or a CQL query string. limit: Maximum number of results (1-50). spaces_filter: Comma-separated list of space keys to filter by.
Returns: JSON string representing a list of simplified Confluence page objects.
confluence_get_page
Get content of a specific Confluence page by its ID, or by its title and space key.
Args: ctx: The FastMCP context. page_id: Confluence page ID. If provided, 'title' and 'space_key' are ignored. title: The exact title of the page. Must be used with 'space_key'. space_key: The key of the space. Must be used with 'title'. include_metadata: Whether to include page metadata. convert_to_markdown: Convert content to markdown (true) or keep raw HTML (false).
Returns: JSON string representing the page content and/or metadata, or an error if not found or parameters are invalid.
confluence_get_page_children
Get child pages of a specific Confluence page.
Args: ctx: The FastMCP context. parent_id: The ID of the parent page. expand: Fields to expand. limit: Maximum number of child pages. include_content: Whether to include page content. convert_to_markdown: Convert content to markdown if include_content is true. start: Starting index for pagination.
Returns: JSON string representing a list of child page objects.
confluence_get_comments
Get comments for a specific Confluence page.
Args: ctx: The FastMCP context. page_id: Confluence page ID.
Returns: JSON string representing a list of comment objects.
confluence_get_labels
Get labels for a specific Confluence page.
Args: ctx: The FastMCP context. page_id: Confluence page ID.
Returns: JSON string representing a list of label objects.
confluence_add_label
Add label to an existing Confluence page.
Args: ctx: The FastMCP context. page_id: The ID of the page to update. name: The name of the label.
Returns: JSON string representing the updated list of label objects for the page.
Raises: ValueError: If in read-only mode or Confluence client is unavailable.
confluence_create_page
Create a new Confluence page.
Args: ctx: The FastMCP context. space_key: The key of the space. title: The title of the page. content: The content of the page (format depends on content_format). parent_id: Optional parent page ID. content_format: The format of the content ('markdown', 'wiki', or 'storage'). enable_heading_anchors: Whether to enable heading anchors (markdown only).
Returns: JSON string representing the created page object.
Raises: ValueError: If in read-only mode, Confluence client is unavailable, or invalid content_format.
confluence_update_page
Update an existing Confluence page.
Args: ctx: The FastMCP context. page_id: The ID of the page to update. title: The new title of the page. content: The new content of the page (format depends on content_format). is_minor_edit: Whether this is a minor edit. version_comment: Optional comment for this version. parent_id: Optional new parent page ID. content_format: The format of the content ('markdown', 'wiki', or 'storage'). enable_heading_anchors: Whether to enable heading anchors (markdown only).
Returns: JSON string representing the updated page object.
Raises: ValueError: If Confluence client is not configured, available, or invalid content_format.
confluence_delete_page
Delete an existing Confluence page.
Args: ctx: The FastMCP context. page_id: The ID of the page to delete.
Returns: JSON string indicating success or failure.
Raises: ValueError: If Confluence client is not configured or available.
confluence_add_comment
Add a comment to a Confluence page.
Args: ctx: The FastMCP context. page_id: The ID of the page to add a comment to. content: The comment content in Markdown format.
Returns: JSON string representing the created comment.
Raises: ValueError: If in read-only mode or Confluence client is unavailable.
confluence_search_user
Search Confluence users using CQL.
Args: ctx: The FastMCP context. query: Search query - a CQL query string for user search. limit: Maximum number of results (1-50).
Returns: JSON string representing a list of simplified Confluence user search result objects.
Prompts
Interactive templates invoked by user choice
No prompts
Resources
Contextual data attached and managed by the client