CUF Health Portal MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| OUTPUT_DIR | No | Directory to save downloaded PDFs. | ./downloads |
| CUF_PASSWORD | Yes | Your CUF health portal password. | |
| CUF_USERNAME | Yes | Your CUF health portal email/username. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_clinical_documentsA | List all clinical documents (imaging reports, cardiology, pathology, etc.). Returns a list of dicts with keys: id, patientId, documentType, documentDate, fileName. |
| get_clinical_documentA | 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_invoicesA | List all invoices from the CUF portal. Returns a list of dicts with keys: id, code, paymentNumber, date, status, value, externalSiteCode. |
| get_invoiceA | 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_appointmentsB | 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_past_appointmentsA | 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_exam_resultsA | 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_prescriptionsA | 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). |
| get_prescriptionA | 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_prescriptionA | 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_notificationsA | 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_patient_infoA | Get basic patient profile information (name, contacts, identity numbers). Returns a dict with keys: fullName, title, contacts, identity. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
Most tools map cleanly to distinct resource/action pairs, and the list_/get_ pairing makes common document and invoice workflows obvious. However, list_appointments and list_past_appointments clearly overlap for recent past appointments, and list_exam_results vs list_clinical_documents have some potential boundary ambiguity around lab/pathology results. The descriptions help, but a couple of tools could still be confused.
All tool names follow a consistent snake_case verb_noun pattern: list_ for collections, get_ for individual items or PDF downloads, and parse_ for prescription extraction. This makes the tool set highly predictable and easy for an agent to navigate.
12 tools is well-scoped for a health portal covering clinical documents, invoices, appointments, exam results, prescriptions, notifications, and patient info. Each tool has a clear purpose, and none feel redundant or superfluous.
Read-only retrieval is well covered: every listed resource has at least a list/get or download path, and prescription parsing adds useful post-processing. However, appointment fields like canCancel and canReSchedule indicate self-service actions that are not exposed, and there are no cancel/reschedule or update workflow tools. This creates notable dead ends for tasks beyond viewing or downloading.