Smithery's MCP Proxy and managed identity shut down on October 31. See what's changing

SmitherySign up for Arcade

Jira

Arcade toolkit · docs.arcade.dev

The Jira toolkit integrates Arcade with Atlassian Jira, enabling LLMs to manage issues, sprints, boards, users, attachments, and project metadata across Jira Cloud instances.

Capabilities

  • Issue lifecycle management — Create, update, transition, search (parameterized or JQL), comment on, label, and attach files to issues; move issues between sprints and backlogs. Descriptions accept Markdown, and issues can carry components, fix versions, and custom fields.
  • Sprint & board operations — List boards and their sprints (with date-range filtering), retrieve backlog and sprint issues, add/move issues to sprints, and access backlog GUI URLs.
  • Project & metadata discovery — Browse projects, issue types, priority schemes, labels, and available transitions; resolve names/keys/emails to IDs automatically without requiring pre-lookup calls.
  • User & identity management — Look up users by ID, name, or email; list all users; retrieve the authenticated user's profile and available Atlassian Cloud instances.
  • Attachment handling — List attachment metadata, download attachment contents, and upload files (string or base64) to issues.

Tools43

  • Jira_AddCommentToIssue

    Add a comment to a Jira issue.

  • Jira_AddIssuesToSprint

    Add a list of issues to a sprint. Maximum of 50 issues per operation.

  • Jira_AddLabelsToIssue

    Add labels to an existing Jira issue.

  • Jira_AttachFileToIssue

    Add an attachment to an issue. Must provide exactly one of file_content_str or file_content_base64.

  • Jira_CreateIssue

    Create a new Jira issue. Provide a value to one of project or parent_issue arguments. If project and parent_issue are not provided, the tool will select the single project available. If the user has multiple, an error will be returned with the available projects to choose from. If you have an issue type name, or a project key/name, a priority name, an assignee name/key/email, or a reporter name/key/email, DO NOT CALL OTHER TOOLS only to list available projects, priorities, issue types, or users. Provide the name, key, or email and the tool will figure out the ID.

  • Jira_DownloadAttachment

    Download the contents of an attachment associated with an issue.

  • Jira_GetAttachmentMetadata

    Get the metadata of an attachment.

  • Jira_GetAvailableAtlassianClouds

    Get available Atlassian Clouds.

  • Jira_GetBoardBacklogIssues

    Get all issues in a board's backlog with pagination support. Returns issues that are not currently assigned to any active sprint. The backlog contains issues that are ready to be planned into future sprints. Only boards that support backlogs (like Scrum and Kanban boards) will return results.

  • Jira_GetBoards

    Retrieve Jira boards either by specifying their names or IDs, or get all available boards. All requests support offset and limit with a maximum of 50 boards returned per call. MANDATORY ACTION: ALWAYS when you need to get multiple boards, you must include all the board identifiers in a single call rather than making multiple separate tool calls, as this provides much better performance, not doing that will bring huge performance penalties. The tool automatically handles mixed identifier types (names and IDs), deduplicates results, and falls back from ID lookup to name lookup when needed.

  • Jira_GetCommentById

    Get a comment by its ID.

  • Jira_GetIssueById

    Get the details of a Jira issue by its ID.

  • Jira_GetIssueComments

    Get the comments of a Jira issue by its ID.

  • Jira_GetIssuesWithoutId

    Search for Jira issues when you don't have the issue ID(s). All text-based arguments (keywords, assignee, project, labels) are case-insensitive. ALWAYS PREFER THIS TOOL OVER A JQL-BASED SEARCH, UNLESS IT'S ABSOLUTELY NECESSARY TO USE A JQL QUERY TO FILTER IN A WAY THAT IS NOT SUPPORTED BY THIS TOOL.

  • Jira_GetIssueTypeById

    Get the details of a Jira issue type by its ID.

  • Jira_GetPriorityById

    Get the details of a priority by its ID.

  • Jira_GetProjectById

    Get the details of a Jira project by its ID or key.

  • Jira_GetSprintIssues

    Get all issues that are currently assigned to a specific sprint with pagination support. Returns issues that are planned for or being worked on in the sprint.

  • Jira_GetTransitionById

    Get a transition by its ID.

  • Jira_GetTransitionByStatusName

    Get a transition available for an issue by the transition name. The response will contain screen fields available for the transition, if any.

  • Jira_GetTransitionsAvailableForIssue

    Get the transitions available for an existing Jira issue.

  • Jira_GetUserById

    Get user information by their ID.

  • Jira_GetUsersWithoutId

    Get users without their account ID, searching by display name and email address. The Jira user search API will return up to 1,000 (one thousand) users for any given name/email query. If you need to get more users, please use the Jira.ListAllUsers tool.

  • Jira_ListIssueAttachmentsMetadata

    Get the metadata about the files attached to an issue. This tool does NOT return the actual file contents. To read a file's content, download the attachment by its ID.

  • Jira_ListIssues

    Get the issues for a given project.

  • Jira_ListIssueTypesByProject

    Get the list of issue types (e.g. 'Task', 'Epic', etc.) available to a given project.

  • Jira_ListLabels

    Get the existing labels (tags) in the user's Jira instance.

  • Jira_ListPrioritiesAvailableToAnIssue

    Browse the priorities available to be used in the specified Jira issue.

  • Jira_ListPrioritiesAvailableToAProject

    Browse the priorities available to be used in issues in the specified Jira project. This tool may need to loop through several API calls to get all priorities associated with a specific project. In Jira environments with too many Projects or Priority Schemes, the search may take too long, and the tool call will timeout.

  • Jira_ListPrioritiesByScheme

    Browse the priorities associated with a priority scheme.

  • Jira_ListPrioritySchemes

    Browse the priority schemes available in Jira.

  • Jira_ListProjects

    Browse projects available in Jira.

  • Jira_ListProjectsByScheme

    Browse the projects associated with a priority scheme.

  • Jira_ListSprintsForBoards

    Retrieve sprints from Jira boards with filtering options for planning and tracking purposes. Use this when you need to view sprints from specific boards or find sprints within specific date ranges. For temporal queries like "last month", "next week", or "this quarter", prioritize date parameters over state filtering. Leave board_identifiers_list as None to get sprints from all available boards. DATE FILTERING PRIORITY: When users request sprints by time periods (e.g., "last month", "next week"), use date parameters (start_date, end_date, specific_date) rather than state filtering, as temporal criteria take precedence over sprint status. Returns sprint data along with a backlog GUI URL link where you can see detailed sprint information and manage sprint items. MANDATORY ACTION: ALWAYS when you need to get sprints from multiple boards, you must include all the board identifiers in a single call rather than making multiple separate tool calls, as this provides much better performance, not doing that will bring huge performance penalties. BOARD LIMIT: Maximum of 25 boards can be processed in a single operation. If you need to process more boards, split the request into multiple batches of 25 or fewer boards each. Handles mixed board identifiers (names and IDs) with automatic fallback and deduplication. All boards are processed concurrently for optimal performance.

  • Jira_ListUsers

    Browse users in Jira.

  • Jira_MoveIssuesFromSprintToBacklog

    Move issues from active or future sprints back to the board's backlog.

  • Jira_RemoveLabelsFromIssue

    Remove labels from an existing Jira issue.

  • Jira_SearchIssuesWithJql

    Search for Jira issues using a JQL (Jira Query Language) query. ONLY USE THIS TOOL WHEN THE FILTER CANNOT BE EXPRESSED WITH STRUCTURED SEARCH PARAMETERS (PROJECT, ASSIGNEE, STATUS, PRIORITY, LABELS, DATES) OR WHEN THE USER PROVIDES A JQL QUERY THEMSELVES.

  • Jira_SearchIssuesWithoutJql

    Parameterized search for Jira issues (without having to provide a JQL query). ALWAYS PREFER THIS TOOL OVER USING JQL, UNLESS IT'S ABSOLUTELY NECESSARY TO USE A JQL QUERY TO FILTER IN A WAY THAT IS NOT SUPPORTED BY THIS TOOL OR IF THE USER PROVIDES A JQL QUERY THEMSELVES.

  • Jira_SearchProjects

    Get the details of all Jira projects.

  • Jira_TransitionIssueToNewStatus

    Transition a Jira issue to a new status.

  • Jira_UpdateIssue

    Update an existing Jira issue. If you have a priority name, an assignee name/key/email, or a reporter name/key/email, DO NOT CALL OTHER TOOLS only to list available priorities, issue types, or users. Provide the name, key, or email and the tool will figure out the ID.

  • Jira_WhoAmI

    CALL THIS TOOL FIRST to establish user profile context. Get information about the currently logged-in user and their available Jira clouds/clients.