> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olira.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools overview

> Quick reference for the 10 MCP Patient State tools and the conventions they share.

The MCP Patient State server exposes 10 tools for reading patient state.

| Tool                                                                     | Description                                                                                          |
| ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------- |
| [`get_view`](/mcp-server/tools/get-view)                                 | Get a specific patient view snapshot, raw JSON or rendered text.                                     |
| [`list_views_and_blocks`](/mcp-server/tools/list-views-and-blocks)       | List available views for the patient. Optionally provide view\_type to list blocks within that view. |
| [`get_view_block`](/mcp-server/tools/get-view-block)                     | Get a specific block from a view by block\_id.                                                       |
| [`get_view_recent_events`](/mcp-server/tools/get-view-recent-events)     | Get recent live-segment entries (`temp`) for a specific view type.                                   |
| [`get_logs`](/mcp-server/tools/get-logs)                                 | Get log entries for the patient with optional time, type, and trace filters.                         |
| [`get_events`](/mcp-server/tools/get-events)                             | Get events with optional time, type, and trace filters; resolves EventLog IDs for trace queries.     |
| [`get_stable_data`](/mcp-server/tools/get-stable-data)                   | Get stable patient data (demographics, condition/diagnosis, medications, preferences).               |
| [`list_event_state_modules`](/mcp-server/tools/list-event-state-modules) | List event state module types present for the patient.                                               |
| [`get_event_state_module`](/mcp-server/tools/get-event-state-module)     | Get a specific event state module by type (e.g., symptoms, behavioral\_state, alerts\_and\_tasks).   |
| [`read_memories`](/mcp-server/tools/read-memories)                       | Read 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](/mcp-server/authentication#patient-tokens); 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.

| Value        | Behavior                                                        |
| ------------ | --------------------------------------------------------------- |
| `"raw"`      | Structured JSON (default)                                       |
| `"markdown"` | Human-readable rendered text (`"pretty"` is a deprecated alias) |