# Jira — MCP server on mcp.ai
> Jira via linguagem natural: crie, busque e atualize issues, transições, sprints e projetos. Plataforma fornece a aplicação OAuth, você só clica em Conectar e autoriza seu site Atlassian. Vários sites podem ser conectados no mesmo MCP.

By: mcp.ai · official
Page: https://mcp.ai/jira

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_jira?ms=1781045700000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/jira/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/jira/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/jira/skill.md
Postman collection (v2.1): https://mcp.ai/jira/postman.json

## Tools
- jira_add_attachment(issue_key: string, file_to_upload: object) — Uploads and attaches a file to a jira issue.
- jira_add_comment(comment: string, issue_id_or_key: string, visibility_type?: string, visibility_value?: string) — Adds a comment using atlassian document format (adf) for rich text to an existing jira issue.
- jira_add_watcher_to_issue(account_id: string, issue_id_or_key: string) — Adds a user to an issue's watcher list by account id.
- jira_assign_issue(account_id?: string, assignee_name?: string, issue_id_or_key: string) — Assigns a jira issue to a user, default assignee, or unassigns; supports email/name lookup.
- jira_bulk_create_issue(issues: object[]) — Creates multiple jira issues (up to 50 per call) with full feature support including markdown, assignee resolution, and priority handling.
- jira_create_issue(labels?: string[], summary: string, assignee?: string, due_date?: string, priority?: string, reporter?: string, versions?: string[], sprint_id?: integer, components?: string[], issue_type?: string, description?: string, environment?: string, project_key: string, fix_versions?: string[], assignee_name?: string) — Creates a new jira issue (e.g., bug, task, story) in a specified project.
- jira_create_issue_link(comment?: string, link_type: string, inward_issue_key: string, outward_issue_key: string) — Links two jira issues using a specified link type with optional comment.
- jira_create_project(key: string, url?: string, name: string, avatar_id?: integer, category_id?: integer, description?: string, assignee_type?: string, lead_account_id: string, project_type_key: string, permission_scheme?: integer, notification_scheme?: integer, project_template_key: string, issue_security_scheme?: integer) — Creates a new jira project with required lead, template, and type configuration.
- jira_create_sprint(goal?: string, name: string, end_date?: string, start_date?: string, origin_board_id: integer) — Creates a new sprint on a jira board with optional start/end dates and goal.
- jira_create_version(name: string, archived?: boolean, released?: boolean, projectId: integer, startDate?: string, description?: string, releaseDate?: string) — Creates a new version for releases or milestones in a jira project.
- jira_delete_comment(id: string, issueIdOrKey: string) — Deletes a specific comment from a jira issue using its id and the issue's id/key; requires user permission to delete comments on the issue.
- jira_delete_issue(delete_subtasks?: boolean, issue_id_or_key: string) — Deletes a jira issue by its id or key.
- jira_delete_version(version_id: string, move_fix_issues_to?: string, move_affected_issues_to?: string) — Deletes a jira version and optionally reassigns its issues.
- jira_delete_worklog(worklog_id: string, increase_by?: string, new_estimate?: string, notify_users?: boolean, adjust_estimate?: string, issue_id_or_key: string, override_editable_flag?: boolean) — Deletes a worklog from a jira issue with estimate adjustment options.
- jira_edit_issue(fields?: object, labels?: string[], update?: object, summary?: string, assignee?: string, due_date?: string, description?: string, notify_users?: boolean, return_issue?: boolean, issue_id_or_key: string, sprint_id_or_name?: string, priority_id_or_name?: string, override_editable_flag?: boolean, override_screen_security?: boolean) — Updates an existing jira issue with field values and operations. supports direct field parameters (summary, description, assignee, priority, etc.) that are merged with the fields parameter. direct par
- jira_find_users(query?: string, start_at?: integer, username?: string, account_id?: string, max_results?: integer, include_active?: boolean, include_inactive?: boolean) — Searches for jira users by email, display name, or username to find account ids; essential for assigning issues, adding watchers, and other user-related operations.
- jira_get_all_issue_type_schemes(id?: integer[], start_at?: integer, max_results?: integer) — Retrieves all jira issue type schemes with optional filtering and pagination.
- jira_get_all_projects(name?: string, query?: string, action?: string, expand?: string, status?: string[], orderBy?: string, startAt?: integer, categoryId?: integer, maxResults?: integer, properties?: string[]) — Retrieves all visible projects using the modern paginated jira api with server-side filtering and pagination support.
- jira_get_all_statuses() — Retrieves all available issue statuses from jira with details.
- jira_get_all_users(start_at?: integer, max_results?: integer) — Retrieves all users from the jira instance including active, inactive, and other user states with pagination support.
- jira_get_comment(expand?: string, comment_id: string, issue_id_or_key: string) — Retrieves a specific comment by id from a jira issue with optional expansions.
- jira_get_current_user(expand?: string) — Retrieves detailed information about the currently authenticated jira user.
- jira_get_issue(expand?: string, fields?: string[], properties?: string[], fields_by_keys?: boolean, update_history?: boolean, issue_id_or_key: string) — Retrieves a jira issue by id or key with customizable fields and expansions.
- jira_get_issue_link_types() — Retrieves all configured issue link types from jira.
- jira_get_issue_property(property_key: string, issue_id_or_key: string) — Retrieves a custom property from a jira issue by key.
- jira_get_issue_resolutions() — Retrieves all available issue resolution types from jira.
- jira_get_issue_type_scheme(issue_type_scheme_id: string) — Gets a jira issue type scheme by id with all associated issue types.
- jira_get_issue_types() — Retrieves all jira issue types available to the user using the modern api v3 endpoint; results vary based on 'administer jira' global or 'browse projects' project permissions.
- jira_get_issue_watchers(start_at?: integer, max_results?: integer, issue_id_or_key: string) — Retrieves users watching a jira issue for update notifications.
- jira_get_issue_worklogs(start_at?: integer, max_results?: integer, started_after?: integer, started_before?: integer, issue_id_or_key: string) — Retrieves worklogs for a jira issue with user permission checks.
- jira_get_project_versions(expand?: string, project_id_or_key: string) — Retrieves all versions for a jira project with optional expansion.
- jira_get_remote_issue_links(global_id?: string, issue_id_or_key: string) — Retrieves links from a jira issue to external resources.
- jira_get_transitions(expand?: string, transition_id?: string, issue_id_or_key: string, skip_remote_only_condition?: boolean, sort_by_ops_bar_and_status?: boolean, include_unavailable_transitions?: boolean) — Retrieves available workflow transitions for a jira issue.
- jira_get_votes(issue_id_or_key: string) — Fetches voting details for a jira issue; requires voting to be enabled in jira's general settings.
- jira_get_worklog(expand?: string, start_at?: integer, max_results?: integer, started_after?: integer, started_before?: integer, issue_id_or_key: string) — Retrieves worklogs for a specified jira issue.
- jira_list_boards(name?: string, type?: string, orderBy?: string, start_at?: integer, max_results?: integer, includePrivate?: boolean, projectKeyOrId?: string) — Retrieves paginated jira boards with filtering and sorting options.
- jira_list_issue_comments(expand?: string, order_by?: string, start_at?: integer, max_results?: integer, issue_id_or_key: string) — Retrieves paginated comments from a jira issue with optional ordering.
- jira_list_sprints(state?: string, board_id: integer, start_at?: integer, max_results?: integer) — Retrieves paginated sprints from a jira board with optional state filtering.
- jira_move_issue_to_sprint(issues: string[], sprint_id: integer) — Moves one or more jira issues to a specified active sprint.
- jira_remove_watcher_from_issue(account_id: string, issue_id_or_key: string) — Removes a user from an issue's watcher list by account id.
- jira_search_for_issues_using_jql_get(jql: string, expand?: string, fields?: string[], start_at?: integer, properties?: string[], max_results?: integer, fields_by_keys?: boolean, validate_query?: string) — Searches for jira issues using jql with pagination and field selection.
- jira_search_for_issues_using_jql_post(jql: string, expand?: string, fields?: string[], start_at?: integer, properties?: string[], max_results?: integer, fields_by_keys?: boolean, validate_query?: string) — Searches for jira issues using jql via post request for complex queries; ideal for lengthy jql queries that might exceed url character limits
- jira_search_issues(jql?: string, labels?: string[], assignee?: string, start_at?: integer, max_results?: integer, project_key?: string, text_search?: string, created_after?: string, updated_after?: string, created_before?: string, updated_before?: string, sprint_id_or_name?: string, status_id_or_name?: string, priority_id_or_name?: string, issue_type_id_or_name?: string) — Advanced jira issue search supporting structured filters and raw jql.
- jira_send_notification_for_issue(to: object, subject: string, restrict?: object, html_body?: string, text_body: string, issue_id_or_key: string) — Sends a customized email notification for a jira issue.
- jira_transition_issue(comment?: string, assignee?: string, resolution?: string, assignee_name?: string, issue_id_or_key: string, transition_id_or_name: string) — Transitions a jira issue to a different workflow state, with support for transition name lookup and user assignment by email.
- jira_update_comment(comment_id: string, comment_text: string, notify_users?: boolean, issue_id_or_key: string, visibility_type?: string, visibility_value?: string) — Updates text content or visibility of an existing jira comment.

## Example prompts
- "Crie uma issue 'Erro no checkout' no projeto WEB com prioridade alta"
- "Liste minhas issues abertas atribuídas a mim"
- "Mova a issue WEB-204 para 'Em progresso'"

## Links
Docs: https://mcp.ai/docs/mcps/jira
Website: https://mcp.ai/mcps/jira