Skip to main content
FuseFuse
IntegrationsJiraActions

Search Jira issues

Search Jira issues with enhanced JQL, explicit fields, and token pagination.

Agent markdown

issues.search · Jira · v1

Details

Risk
Read
Idempotency
Safe
Availability
Default
Exposure
REST, SDK, MCP
MCP hints
readOnly=true, destructive=false, idempotent=true, openWorld=true

Scopes

  • read:jira-work
  • offline_access

Input

Input schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
jqlstringYesminLength 1; maxLength 2000
fieldsarray<string>NominItems 1; maxItems 12
fields[]stringYesenum summary | status | assignee | reporter | issuetype | project | priority | description | labels | created | updated | parent
max_resultsintegerNominimum 1; maximum 50
next_page_tokenstringNominLength 1; maxLength 512

Output

Output schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
issuesarray<object>YesmaxItems 50
issues[]objectYesadditionalProperties false
issues[].idstringYesminLength 1; maxLength 64
issues[].keystringYesminLength 1; maxLength 64
issues[].selfstringNomaxLength 2048
issues[].summarystringNomaxLength 255
issues[].statusobjectNoadditionalProperties false
issues[].status.idstringNominLength 1; maxLength 64
issues[].status.namestringNomaxLength 128
issues[].status.category_keystringNomaxLength 64
issues[].assigneeobjectNoadditionalProperties false
issues[].assignee.account_idstringNominLength 1; maxLength 128
issues[].assignee.display_namestringNomaxLength 255
issues[].assignee.activebooleanNo
issues[].reporterobjectNoadditionalProperties false
issues[].reporter.account_idstringNominLength 1; maxLength 128
issues[].reporter.display_namestringNomaxLength 255
issues[].reporter.activebooleanNo
issues[].issuetypeobjectNoadditionalProperties false
issues[].issuetype.idstringNominLength 1; maxLength 64
issues[].issuetype.keystringNominLength 1; maxLength 64
issues[].issuetype.namestringNomaxLength 255
issues[].projectobjectNoadditionalProperties false
issues[].project.idstringNominLength 1; maxLength 64
issues[].project.keystringNominLength 1; maxLength 64
issues[].project.namestringNomaxLength 255
issues[].priorityobjectNoadditionalProperties false
issues[].priority.idstringNominLength 1; maxLength 64
issues[].priority.keystringNominLength 1; maxLength 64
issues[].priority.namestringNomaxLength 255
issues[].labelsarray<string>NomaxItems 50
issues[].labels[]stringYesmaxLength 255
issues[].descriptionobjectNoadditionalProperties false
issues[].description.typestringYesenum doc
issues[].description.versionintegerYesminimum 1; maximum 1
issues[].description.contentarray<object>YesminItems 1; maxItems 32
issues[].description.content[]objectYesadditionalProperties false
issues[].description.content[].typestringYesenum paragraph | heading | bulletList | orderedList
issues[].description.content[].attrsobjectNoadditionalProperties false
issues[].description.content[].attrs.levelintegerNominimum 1; maximum 6
issues[].description.content[].contentarray<object>NomaxItems 64
issues[].description.content[].content[]objectYesadditionalProperties false
issues[].description.content[].content[].typestringYesenum text | hardBreak | listItem | paragraph | heading
issues[].description.content[].content[].textstringNominLength 1; maxLength 2000
issues[].description.content[].content[].marksarray<object>NomaxItems 8
issues[].description.content[].content[].marks[]objectYesadditionalProperties false
issues[].description.content[].content[].marks[].typestringYesenum strong | em | code | underline | strike | link
issues[].description.content[].content[].marks[].attrsobjectNoadditionalProperties false
issues[].description.content[].content[].marks[].attrs.hrefstringNominLength 8; maxLength 2048; pattern ^https://; format uri
issues[].description.content[].content[].attrsobjectNoadditionalProperties false
issues[].description.content[].content[].attrs.levelintegerNominimum 1; maximum 6
issues[].description.content[].content[].contentarray<object>NomaxItems 64
issues[].description.content[].content[].content[]objectYesadditionalProperties false
issues[].description.content[].content[].content[].typestringYesenum text | hardBreak | paragraph | heading
issues[].description.content[].content[].content[].textstringNominLength 1; maxLength 2000
issues[].description.content[].content[].content[].marksarray<object>NomaxItems 8
issues[].description.content[].content[].content[].marks[]objectYesadditionalProperties false
issues[].description.content[].content[].content[].marks[].typestringYesenum strong | em | code | underline | strike | link
issues[].description.content[].content[].content[].marks[].attrsobjectNoadditionalProperties false
issues[].description.content[].content[].content[].marks[].attrs.hrefstringNominLength 8; maxLength 2048; pattern ^https://; format uri
issues[].description.content[].content[].content[].attrsobjectNoadditionalProperties false
issues[].description.content[].content[].content[].attrs.levelintegerNominimum 1; maximum 6
issues[].description.content[].content[].content[].contentarray<object>NomaxItems 64
issues[].description.content[].content[].content[].content[]objectYesadditionalProperties false
issues[].description.content[].content[].content[].content[].typestringYesenum text | hardBreak
issues[].description.content[].content[].content[].content[].textstringNominLength 1; maxLength 2000
issues[].description.content[].content[].content[].content[].marksarray<object>NomaxItems 8
issues[].description.content[].content[].content[].content[].marks[]objectYesadditionalProperties false
issues[].description.content[].content[].content[].content[].marks[].typestringYesenum strong | em | code | underline | strike | link
issues[].description.content[].content[].content[].content[].marks[].attrsobjectNoadditionalProperties false
issues[].description.content[].content[].content[].content[].marks[].attrs.hrefstringNominLength 8; maxLength 2048; pattern ^https://; format uri
issues[].createdstringNomaxLength 64
issues[].updatedstringNomaxLength 64
issues[].parentobjectNoadditionalProperties false
issues[].parent.idstringNominLength 1; maxLength 64
issues[].parent.keystringNominLength 1; maxLength 64
issues[].parent.namestringNomaxLength 255
next_page_tokenstringNominLength 1; maxLength 512

Raw schema

Input
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "jql": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "summary",
          "status",
          "assignee",
          "reporter",
          "issuetype",
          "project",
          "priority",
          "description",
          "labels",
          "created",
          "updated",
          "parent"
        ]
      },
      "minItems": 1,
      "maxItems": 12
    },
    "max_results": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "next_page_token": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512
    }
  },
  "required": [
    "jql"
  ]
}
Output
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "issues": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          },
          "key": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          },
          "self": {
            "type": "string",
            "maxLength": 2048
          },
          "summary": {
            "type": "string",
            "maxLength": 255
          },
          "status": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64
              },
              "name": {
                "type": "string",
                "maxLength": 128
              },
              "category_key": {
                "type": "string",
                "maxLength": 64
              }
            }
          },
          "assignee": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "account_id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 128
              },
              "display_name": {
                "type": "string",
                "maxLength": 255
              },
              "active": {
                "type": "boolean"
              }
            }
          },
          "reporter": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "account_id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 128
              },
              "display_name": {
                "type": "string",
                "maxLength": 255
              },
              "active": {
                "type": "boolean"
              }
            }
          },
          "issuetype": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64
              },
              "key": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64
              },
              "name": {
                "type": "string",
                "maxLength": 255
              }
            }
          },
          "project": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64
              },
              "key": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64
              },
              "name": {
                "type": "string",
                "maxLength": 255
              }
            }
          },
          "priority": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64
              },
              "key": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64
              },
              "name": {
                "type": "string",
                "maxLength": 255
              }
            }
          },
          "labels": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 255
            },
            "maxItems": 50
          },
          "description": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "doc"
                ]
              },
              "version": {
                "type": "integer",
                "minimum": 1,
                "maximum": 1
              },
              "content": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "type": {
                      "type": "string",
                      "enum": [
                        "paragraph",
                        "heading",
                        "bulletList",
                        "orderedList"
                      ]
                    },
                    "attrs": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "level": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 6
                        }
                      }
                    },
                    "content": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "type": {
                            "type": "string",
                            "enum": [
                              "text",
                              "hardBreak",
                              "listItem",
                              "paragraph",
                              "heading"
                            ]
                          },
                          "text": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 2000
                          },
                          "marks": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "additionalProperties": false,
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "strong",
                                    "em",
                                    "code",
                                    "underline",
                                    "strike",
                                    "link"
                                  ]
                                },
                                "attrs": {
                                  "type": "object",
                                  "additionalProperties": false,
                                  "properties": {
                                    "href": {
                                      "type": "string",
                                      "minLength": 8,
                                      "maxLength": 2048,
                                      "pattern": "^https://",
                                      "format": "uri"
                                    }
                                  }
                                }
                              },
                              "required": [
                                "type"
                              ]
                            },
                            "maxItems": 8
                          },
                          "attrs": {
                            "type": "object",
                            "additionalProperties": false,
                            "properties": {
                              "level": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 6
                              }
                            }
                          },
                          "content": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "additionalProperties": false,
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "text",
                                    "hardBreak",
                                    "paragraph",
                                    "heading"
                                  ]
                                },
                                "text": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 2000
                                },
                                "marks": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "additionalProperties": false,
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "enum": [
                                          "strong",
                                          "em",
                                          "code",
                                          "underline",
                                          "strike",
                                          "link"
                                        ]
                                      },
                                      "attrs": {
                                        "type": "object",
                                        "additionalProperties": false,
                                        "properties": {
                                          "href": {
                                            "type": "string",
                                            "minLength": 8,
                                            "maxLength": 2048,
                                            "pattern": "^https://",
                                            "format": "uri"
                                          }
                                        }
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  "maxItems": 8
                                },
                                "attrs": {
                                  "type": "object",
                                  "additionalProperties": false,
                                  "properties": {
                                    "level": {
                                      "type": "integer",
                                      "minimum": 1,
                                      "maximum": 6
                                    }
                                  }
                                },
                                "content": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "additionalProperties": false,
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "enum": [
                                          "text",
                                          "hardBreak"
                                        ]
                                      },
                                      "text": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 2000
                                      },
                                      "marks": {
                                        "type": "array",
                                        "items": {
                                          "type": "object",
                                          "additionalProperties": false,
                                          "properties": {
                                            "type": {
                                              "type": "string",
                                              "enum": [
                                                "strong",
                                                "em",
                                                "code",
                                                "underline",
                                                "strike",
                                                "link"
                                              ]
                                            },
                                            "attrs": {
                                              "type": "object",
                                              "additionalProperties": false,
                                              "properties": {
                                                "href": {
                                                  "type": "string",
                                                  "minLength": 8,
                                                  "maxLength": 2048,
                                                  "pattern": "^https://",
                                                  "format": "uri"
                                                }
                                              }
                                            }
                                          },
                                          "required": [
                                            "type"
                                          ]
                                        },
                                        "maxItems": 8
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ]
                                  },
                                  "maxItems": 64
                                }
                              },
                              "required": [
                                "type"
                              ]
                            },
                            "maxItems": 64
                          }
                        },
                        "required": [
                          "type"
                        ]
                      },
                      "maxItems": 64
                    }
                  },
                  "required": [
                    "type"
                  ]
                },
                "minItems": 1,
                "maxItems": 32
              }
            },
            "required": [
              "type",
              "version",
              "content"
            ]
          },
          "created": {
            "type": "string",
            "maxLength": 64
          },
          "updated": {
            "type": "string",
            "maxLength": 64
          },
          "parent": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64
              },
              "key": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64
              },
              "name": {
                "type": "string",
                "maxLength": 255
              }
            }
          }
        },
        "required": [
          "id",
          "key"
        ]
      },
      "maxItems": 50
    },
    "next_page_token": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512
    }
  },
  "required": [
    "issues"
  ]
}