Convert a .eml email file to Markdown with YAML front matter.

Returns the full Markdown content (front matter + body). When output_path is provided, also writes the file to disk.

Presets bundle common flag combinations:

• default: strips signatures, tracking pixels, signature images

• clean: default + strips disclaimers and quoted headers

• verbose: includes all headers and raw HTML

• raw: no stripping, preserves everything

Individual flags override the preset when provided.

Convert a .eml file to a self-contained bundle with markdown and attachments.

Creates a directory containing the converted markdown, extracted attachments, and optionally the original .eml source.

source_handling only accepts 'copy' over MCP: the original .eml is copied into the bundle and left untouched. The 'move' and 'delete' modes are rejected here — use the CLI or the Python API for those.

Returns JSON with bundle_path, markdown_path, attachment_paths, and optional diagnostics.

Batch convert all .eml files in a directory to Markdown.

Recursively finds all .eml files and converts them. Returns a JSON summary with total, successes, failures, output_paths, and errors.

Use convert_eml to retrieve individual converted file content.

Inspect email quality and structure without writing permanent files.

Use this to assess conversion quality before committing, or to troubleshoot problematic .eml files.

Always returns JSON with: state (normal/degraded/review_recommended), selected_body, segmentation_path, client_hint, confidence, fallback_used, and warnings. Two keys are conditional: stripped_images appears only when images were removed, and attachments only when the message had attachments eligible for retention.