Jira search issues

jira__search_issues

Access

Requires a project integration connection for jira.

Call type: Can read or manage credentials.

Arguments

FieldTypeRequiredDescription and constraints
cloudIdstringYesAtlassian cloud ID from accessible-resources
jqlstringYesJira Query Language search expression
maxResultsnumberNoMaximum issues to return
nextPageTokenstringNoPagination token returned by the preceding Jira JQL search response. Use it only to continue the same JQL search; do not invent it or use an offset. If Jira rejects it, retry without nextPageToken
fieldsvalue[]NoIssue fields to include

Example request

Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "jira__search_issues",
    "arguments": {
      "cloudId": "example",
      "jql": "example"
    }
  }
}

Result

No output schema is published for this tool. The input contract does not define its return fields. Inspect the MCP response content and isError; do not assume a fixed object shape. See the jira integration reference for provider setup and tool context.

Full schemas

json
{
  "type": "object",
  "properties": {
    "cloudId": {
      "type": "string",
      "description": "Atlassian cloud ID from accessible-resources"
    },
    "jql": {
      "type": "string",
      "description": "Jira Query Language search expression"
    },
    "maxResults": {
      "type": "number",
      "description": "Maximum issues to return"
    },
    "nextPageToken": {
      "type": "string",
      "description": "Pagination token returned by the preceding Jira JQL search response. Use it only to continue the same JQL search; do not invent it or use an offset. If Jira rejects it, retry without nextPageToken"
    },
    "fields": {
      "type": "array",
      "description": "Issue fields to include"
    }
  },
  "required": [
    "cloudId",
    "jql"
  ],
  "description": "Arguments for the jira__search_issues tool."
}