MCP Libraries
mcp-jira-stdioTools Reference

jira_search_issues

Search for Jira issues using JQL

jira_search_issues

Search for Jira issues using JQL (Jira Query Language) with pagination and field selection.

Parameters

ParameterTypeRequiredDescription
jqlstringYesJQL query string
startAtnumberNoStarting index for pagination (default: 0)
maxResultsnumberNoMaximum results to return (default: 50)
fieldsstring[]NoSpecific fields to return

Example

{
  "tool": "jira_search_issues",
  "arguments": {
    "jql": "project = PROJ AND status = 'In Progress'"
  }
}

With Pagination

{
  "tool": "jira_search_issues",
  "arguments": {
    "jql": "assignee = currentUser() ORDER BY updated DESC",
    "startAt": 0,
    "maxResults": 25,
    "fields": ["summary", "status", "priority"]
  }
}

JQL Examples

# Issues assigned to current user
assignee = currentUser()

# Open bugs in a project
project = PROJ AND type = Bug AND status != Done

# Recently updated issues
updated >= -7d ORDER BY updated DESC

# High priority issues
priority in (Highest, High) AND status != Done

Response

Returns search results:

  • startAt - Starting index
  • maxResults - Maximum results
  • total - Total matching issues
  • issues - Array of matching issues

On this page