jira_get
Retrieve Jira project data, issues, and workflow details using API endpoints and JQL queries to access and filter information efficiently.
Instructions
Read any Jira data. Returns TOON format by default (30-60% fewer tokens than JSON).
IMPORTANT - Cost Optimization:
ALWAYS use
jqparam to filter response fields. Unfiltered responses are very expensive!Use
maxResultsquery param to restrict result count (e.g.,maxResults: "5")If unsure about available fields, first fetch ONE item with
maxResults: "1"and NO jq filter to explore the schema, then use jq in subsequent calls
Schema Discovery Pattern:
First call:
path: "/rest/api/3/search/jql", queryParams: {"maxResults": "1", "jql": "project=PROJ"}(no jq) - explore available fieldsThen use:
jq: "issues[*].{key: key, summary: fields.summary, status: fields.status.name}"- extract only what you need
Output format: TOON (default, token-efficient) or JSON (outputFormat: "json")
Common paths:
/rest/api/3/project- list all projects/rest/api/3/project/{projectKeyOrId}- get project details/rest/api/3/search/jql- search issues with JQL (usejqlquery param). NOTE:/rest/api/3/searchis deprecated!/rest/api/3/issue/{issueIdOrKey}- get issue details/rest/api/3/issue/{issueIdOrKey}/comment- list issue comments/rest/api/3/issue/{issueIdOrKey}/worklog- list issue worklogs/rest/api/3/issue/{issueIdOrKey}/transitions- get available transitions/rest/api/3/user/search- search users (usequeryparam)/rest/api/3/status- list all statuses/rest/api/3/issuetype- list issue types/rest/api/3/priority- list priorities
JQ examples: issues[*].key, issues[0], issues[*].{key: key, summary: fields.summary}
Example JQL queries: project=PROJ, assignee=currentUser(), status="In Progress", created >= -7d
API reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | The Jira API endpoint path (without base URL). Must start with "/". Examples: "/rest/api/3/project", "/rest/api/3/search/jql", "/rest/api/3/issue/{issueIdOrKey}" | |
| queryParams | No | Optional query parameters as key-value pairs. Examples: {"maxResults": "50", "startAt": "0", "jql": "project=PROJ", "fields": "summary,status"} | |
| jq | No | JMESPath expression to filter/transform the response. IMPORTANT: Always use this to extract only needed fields and reduce token costs. Examples: "issues[*].{key: key, summary: fields.summary}" (extract specific fields), "issues[0]" (first result), "issues[*].key" (keys only). See https://jmespath.org | |
| outputFormat | No | Output format: "toon" (default, 30-60% fewer tokens) or "json". TOON is optimized for LLMs with tabular arrays and minimal syntax. |