PenguinAI Medical Coding

View saved version →

---
name: medical-chart-coding
description: Use PenguinAI Medical Coding to code de-identified medical charts — ICD-10-CM diagnoses with CMS-HCC v24/v28/RxHCC mappings and cited evidence, E/M visit levels, and chart summaries. Use when the user attaches a de-identified chart or pastes a de-identified clinical note and asks for diagnosis codes, HCCs, risk adjustment or a clinical summary.
---

# Medical chart coding with PenguinAI Medical Coding

## When to use
- The user attaches a **de-identified** chart (PDF) or pastes a de-identified note and asks for ICD-10 codes, HCC / risk-adjustment codes, an E/M level, or a summary.
- The user wants to accept or reject a suggested code on a chart that was already coded.

## How to use the tools
1. **Code a chart**: call `process_chart` with the attached file and a pseudonymous `member_id` (e.g. `DEMO-1`, never a real member or beneficiary number). Then poll `get_chart_status` and fetch `get_chart_results`.
2. **Summary only, no codes**: `summarize_chart`.
3. **Record a coder decision**: `submit_code_decision` (accept or reject a suggested code).

## Rules
- **De-identified charts only.** If the tool refuses a chart because it contains patient identifiers, tell the user which identifier *types* were found and ask them to upload a de-identified version. Do not include identifier values in your reply.
- Present results as **suggestions for review by a qualified coder**, not final billing determinations.
- Encounters are labelled by year only (e.g. "2024, encounter 1"). Do not try to recover exact dates.
- Usage is charged to the user's Gwen credits. If the tool reports insufficient credits, tell the user to add credits in Gwen.