Search Issues
jira_searchRead-only
Search Jira issues using JQL queries. Supports pagination, custom fields, project filtering, and expand options.
Instructions
Search Jira issues using JQL (Jira Query Language).
Args: ctx: The FastMCP context. jql: JQL query string. fields: Comma-separated fields to return. limit: Maximum number of results. start_at: Starting index for pagination. projects_filter: Comma-separated list of project keys to filter by. expand: Optional fields to expand. page_token: Pagination token from a previous search result (Cloud only).
Returns: JSON string representing the search results including pagination info.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| jql | Yes | JQL query string (Jira Query Language). Examples: - Find Epics: "issuetype = Epic AND project = PROJ" - Find issues in Epic: "parent = PROJ-123" - Find by status: "status = 'In Progress' AND project = PROJ" - Find by assignee: "assignee = currentUser()" - Find recently updated: "updated >= -7d AND project = PROJ" - Find by label: "labels = frontend AND project = PROJ" - Find by priority: "priority = High AND project = PROJ" | |
| fields | No | (Optional) Comma-separated fields to return in the results. Use '*all' for all fields, or specify individual fields like 'summary,status,assignee,priority' | reporter,status,priority,created,issuetype,summary,updated,labels,description,assignee |
| limit | No | Maximum number of results (1-50) | |
| start_at | No | Starting index for pagination (0-based) | |
| projects_filter | No | (Optional) Comma-separated list of project keys to filter results by. Overrides the environment variable JIRA_PROJECTS_FILTER if provided. | |
| expand | No | (Optional) fields to expand. Examples: 'renderedFields', 'transitions', 'changelog' | |
| page_token | No | (Optional) Pagination token from a previous search result. Cloud only — Server/DC uses start_at for pagination. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |