List all clinical documents (imaging reports, cardiology, pathology, etc.).

Returns a list of dicts with keys: id, patientId, documentType, documentDate, fileName.

Download a specific clinical document PDF by its ID.

Args: doc_id: The document ID from list_clinical_documents (e.g. "12345").

Returns the file path where the PDF was saved.

List all invoices from the CUF portal.

Returns a list of dicts with keys: id, code, paymentNumber, date, status, value, externalSiteCode.

Download a specific invoice PDF by payment number.

Args: payment_number: The paymentNumber from list_invoices (e.g. "CCF2026/45291" or "FT FSDR2025/170390").

Returns the file path where the PDF was saved.

List upcoming and recent appointments.

Args: date_from: ISO date string (YYYY-MM-DD) to start from. Defaults to today.

Returns a list of dicts with keys: id, scheduledDatetime, medicalActName, staffName, siteName, status, type, canCancel, canReSchedule, and more.

List all past appointments (from 2000-01-01 to today).

Returns a list of dicts with keys: id, scheduledDatetime, medicalActName, staffName, siteName, status, type, and more.

List active lab/exam results available in the portal.

Returns a list of dicts with keys: code, report, client. Note: This section may be empty if no results are currently available.

List exam prescriptions from the CUF portal (www.cuf.pt).

Scrapes the Drupal-rendered HTML page — prescriptions use a separate auth system from the GraphQL API. Returns list of dicts with: date, patient, site, download_url, document_id.

Args: years: List of years to fetch (default: current year and 2 prior years).

Download a prescription PDF by its download_url from list_prescriptions().

Args: download_url: The download_url field from list_prescriptions() output.

Returns the file path where the PDF was saved.

Parse a downloaded prescription PDF with a local Ollama model.

Extracts text from the PDF and sends it to a local Ollama model for structured extraction. Falls back to vision-mode (image rendering) for image-based PDFs.

Args: file_path: Path to the prescription PDF (from get_prescription). model: Ollama model ID to use (default: "llama3.2"; use a vision model like "llava" if the PDF is image-based).

Returns structured dict with: patient, date, doctor, specialty, medications (list with name/dci/strength/form/quantity/posology/duration), prescription_number, notes.

Get patient portal notifications.

Args: include_read: Whether to include already-read notifications (default: True).

Returns a list of dicts with keys: id, name, description, date, message, read, entityType, entityCode.

Get basic patient profile information (name, contacts, identity numbers).

Returns a dict with keys: fullName, title, contacts, identity.