jira_read
Fetch a JIRA issue by key and return its content as JFM markdown or raw ADF JSON. Optionally write output to file for large issues.
Instructions
Fetch a JIRA issue by key (e.g. PROJ-123). Returns JFM markdown (default, AI-friendly GitHub-style markdown — see resource omni-dev://specs/jfm) or the raw ADF description JSON when format = "adf". When output_file is set, the content is written to that path and the tool returns a short YAML summary (path/bytes/format) — useful for large issues. Assignee/reporter and other people fields are Atlassian account IDs — resolve them to display names with jira_user_get.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | JIRA issue key (e.g., `PROJ-123`). | |
| format | No | Output format — `jfm` (default) returns JFM markdown with YAML frontmatter; `adf` returns the raw ADF description payload as JSON. | |
| output_file | No | When set, writes the rendered content to this path and returns a short YAML summary (path/bytes/format) instead of the inline body. Useful for large issues that would otherwise blow past the context window — the assistant can then read the file with offset/limit. |