jira_summarize_attachments
Summarize attachments on a Jira issue by extracting readable text from PDFs, Office files, and data formats, returning per-file markdown summaries.
Instructions
Scan and summarize attachments (PDFs, images, Office documents) from a Jira issue.
Uses Microsoft MarkItDown to extract readable content from each supported attachment:
• PDF → full text extracted via pdfminer • Images → EXIF metadata (for a visual description use jira_get_attachment_images) • DOCX / PPTX / XLSX → document text and structure as Markdown • CSV / JSON / XML → raw content rendered as Markdown
Unsupported file types (e.g., zip, mp4, exe) are skipped and listed under
"skipped" in the response.
Requires the markitdown package — add it with:
uv add 'markitdown[pdf]'
To have a vision-capable model see image attachments (screenshots, diagrams,
charts), use jira_get_attachment_images instead — it returns the raw images
as content blocks your model can view directly.
Args: ctx: The FastMCP context. issue_key: Jira issue key (e.g., 'PROJ-123'). filename_filter: Optional comma-separated list of filenames to process. max_chars_per_file: Truncation limit per file in characters (0 = unlimited).
Returns: JSON string with per-attachment summaries including extracted markdown content.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| issue_key | Yes | Jira issue key whose attachments should be summarized (e.g., 'PROJ-123') | |
| filename_filter | No | (Optional) Comma-separated list of specific filenames to process. When omitted all supported attachments in the issue are processed. | |
| max_chars_per_file | No | Maximum characters of extracted text to include per file in the response. Use 0 for no limit. Default is 4000. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |