Skip to main content
The MCP Patient State server exposes 10 tools for reading patient state.
ToolDescription
get_viewGet a specific patient view snapshot, raw JSON or rendered text.
list_views_and_blocksList available views for the patient. Optionally provide view_type to list blocks within that view.
get_view_blockGet a specific block from a view by block_id.
get_view_recent_eventsGet recent live-segment entries (temp) for a specific view type.
get_logsGet log entries for the patient with optional time, type, and trace filters.
get_eventsGet events with optional time, type, and trace filters; resolves EventLog IDs for trace queries.
get_stable_dataGet stable patient data (demographics, condition/diagnosis, medications, preferences).
list_event_state_modulesList event state module types present for the patient.
get_event_state_moduleGet a specific event state module by type (e.g., symptoms, behavioral_state, alerts_and_tasks).
read_memoriesRead memories for a patient. Optionally search by query, or list all up to limit.

Shared conventions

All tools accept patient_id (required for API key / provider tokens; omit when using a Patient Token; it is resolved from the token automatically).

Time windows

Most read tools that target versioned Mongo state (get_view, get_view_block, get_view_recent_events, list_views_and_blocks, get_stable_data, list_event_state_modules, get_event_state_module) accept an optional date_from / date_to window: an inclusive ISO 8601 bound on the underlying document’s created_at. When set, the tool resolves to the latest version of each module / view in that window instead of the absolute latest. read_memories is not versioned and ignores these arguments.

Output format

Every tool with a format argument uses the same enum and default: "raw" returns structured JSON (default; best for agents); "markdown" returns human-readable rendered text. "pretty" is accepted as a deprecated alias for "markdown" for backward compatibility.
ValueBehavior
"raw"Structured JSON (default)
"markdown"Human-readable rendered text ("pretty" is a deprecated alias)