---
title: "Clinical MCP"
description: "Let your AI assistant make real Leyr API calls - book appointments, manage patients, write notes, and more - directly from your IDE."
canonical_url: "http://localhost/product/mcp/health-mcp"
---
# Clinical MCP

> Let your AI assistant make real Leyr API calls - book appointments, manage patients, write notes, and more - directly from your IDE.

Give your AI assistant the ability to **execute live Leyr API calls** - not just read docs, but actually book appointments, look up patients, write clinical notes, and more.

**Requires a Leyr account and API credentials.**

---

## Prerequisites: Create a Leyr account

The Clinical MCP calls the live Leyr API on your behalf. You need a Leyr account and an application with API credentials before you can use it.

Prefer to stay in chat? The [Docs MCP](http://localhost/product/mcp/docs-mcp#administration) can register your account, create the app, and connect an EMR for you - then come back here with your `client_id` / `client_secret`.

<steps>

### Create your account

Register at **leyr.io/auth/register** - free Sandbox access is available to anyone.

### Create an application

In the [Developer Portal](https://leyr.io/developers), register an application. This gives you a **Client ID** and lets you generate a **Client Secret**.

### Save your credentials

You will need:

- `LEYR_CLIENT_ID` - the Client ID from your application
- `LEYR_CLIENT_SECRET` - the Client Secret generated for that application

Keep the secret private. Never commit it to source control.

</steps>

<u-button color="primary" to="http://localhost/product/fundamentals/create-account" trailing-icon="i-heroicons-outline-arrow-right">

Create a Leyr account

</u-button>

---

## Setup

### Providing credentials

The Clinical MCP supports two ways to pass credentials to every tool call:

**Option A - Environment variables (recommended)**

Set these in your shell or IDE environment before starting the MCP client:

```bash
export LEYR_CLIENT_ID=your_client_id
export LEYR_CLIENT_SECRET=your_client_secret
```

When both env vars are set, you never have to include credentials in individual tool calls.

**Option B - Inline per call**

Pass `client_id` and `client_secret` directly as parameters on each tool call. Useful for quickly testing with different accounts or in environments where env vars are not available.

---

### Add to your IDE

<u-tabs :items="[{"label":"Cursor","icon":"i-simple-icons-cursor","slot":"cursor"},{"label":"Windsurf","icon":"i-simple-icons-windsurf","slot":"windsurf"},{"label":"Claude Desktop","icon":"i-simple-icons-claude","slot":"claude"},{"label":"Copilot","icon":"i-simple-icons-github","slot":"copilot"},{"label":"Other","icon":"i-heroicons-outline-ellipsis-horizontal","slot":"other"}]">
<template v-slot:cursor="">

Add to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "leyr-health": {
      "url": "https://api.leyr.io/mcp",
      "env": {
        "LEYR_CLIENT_ID": "your_client_id",
        "LEYR_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}
```

</template>

<template v-slot:windsurf="">

Add to your MCP settings (Windsurf Settings → MCP Servers):

```json
{
  "mcpServers": {
    "leyr-health": {
      "url": "https://api.leyr.io/mcp",
      "env": {
        "LEYR_CLIENT_ID": "your_client_id",
        "LEYR_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}
```

</template>

<template v-slot:claude="">

Run in your terminal:

```bash
claude mcp add --transport http leyr-health https://api.leyr.io/mcp
```

Then set your credentials as environment variables before launching Claude Desktop:

```bash
export LEYR_CLIENT_ID=your_client_id
export LEYR_CLIENT_SECRET=your_client_secret
```

Or edit `~/Library/Application Support/Claude/claude_desktop_config.json` manually:

```json
{
  "mcpServers": {
    "leyr-health": {
      "url": "https://api.leyr.io/mcp",
      "env": {
        "LEYR_CLIENT_ID": "your_client_id",
        "LEYR_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}
```

</template>

<template v-slot:copilot="">

Open the Command Palette (`⇧⌘P` / `Ctrl+Shift+P`), run **MCP: Add Server**, choose **HTTP**, and enter:

```text
https://api.leyr.io/mcp
```

Then configure your credentials as environment variables in VS Code settings or your shell profile.

</template>

<template v-slot:other="">

The Leyr Clinical MCP server is available at:

```text
https://api.leyr.io/mcp
```

Transport: **Streamable HTTP** (MCP spec 2025-11-25). Pass `LEYR_CLIENT_ID` and `LEYR_CLIENT_SECRET` as environment variables, or supply `client_id` / `client_secret` inline on each tool call.

</template>
</u-tabs>

Restart your IDE after saving the config.

---

## Available tools

### Care Units & Scheduling

<table>
<thead>
  <tr>
    <th>
      Tool
    </th>
    
    <th>
      What it does
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        leyr_get_care_units
      </code>
    </td>
    
    <td>
      List all care units (clinic locations) for an EHR
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        leyr_get_healthcare_services
      </code>
    </td>
    
    <td>
      List healthcare services available at a care unit
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        leyr_get_resources
      </code>
    </td>
    
    <td>
      List schedulable resources - doctors, nurses, rooms - at a care unit
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        leyr_get_resource
      </code>
    </td>
    
    <td>
      Get details of a single resource by ID
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        leyr_get_timeslots
      </code>
    </td>
    
    <td>
      Get available booking slots; filter by date range, service, or resource
    </td>
  </tr>
</tbody>
</table>

### Appointments

<table>
<thead>
  <tr>
    <th>
      Tool
    </th>
    
    <th>
      What it does
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        leyr_get_appointments
      </code>
    </td>
    
    <td>
      List appointments; filter by patient, resource, service, or date range
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        leyr_get_appointment
      </code>
    </td>
    
    <td>
      Get a single appointment by ID
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        leyr_create_appointment
      </code>
    </td>
    
    <td>
      Book a new appointment for a patient
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        leyr_patch_appointment
      </code>
    </td>
    
    <td>
      Reschedule, reassign, add a comment, or cancel an appointment
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        leyr_bulk_patch_appointments
      </code>
    </td>
    
    <td>
      Update multiple appointments at once by ID list
    </td>
  </tr>
</tbody>
</table>

### Patients

<table>
<thead>
  <tr>
    <th>
      Tool
    </th>
    
    <th>
      What it does
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        leyr_get_patients
      </code>
    </td>
    
    <td>
      Search patients by name, birth date, phone, or email
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        leyr_get_patient
      </code>
    </td>
    
    <td>
      Fetch a single patient record by ID
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        leyr_create_patient
      </code>
    </td>
    
    <td>
      Register a new patient (upserts if the patient already exists)
    </td>
  </tr>
</tbody>
</table>

### Clinical Records

<table>
<thead>
  <tr>
    <th>
      Tool
    </th>
    
    <th>
      What it does
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        leyr_get_medical_notes
      </code>
    </td>
    
    <td>
      List medical notes for a patient (paginated)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        leyr_get_medical_note
      </code>
    </td>
    
    <td>
      Fetch a single note with full content
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        leyr_create_medical_note
      </code>
    </td>
    
    <td>
      Create an unsigned clinical note (signed later by a clinician)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        leyr_get_documents
      </code>
    </td>
    
    <td>
      List documents attached to a patient (paginated)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        leyr_get_document
      </code>
    </td>
    
    <td>
      Fetch a single document with full content
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        leyr_create_document
      </code>
    </td>
    
    <td>
      Attach a base64-encoded document (PDF, image, report) to a patient
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        leyr_get_measurements
      </code>
    </td>
    
    <td>
      List clinical measurements for a patient (paginated)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        leyr_get_measurement
      </code>
    </td>
    
    <td>
      Fetch a single measurement by ID
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        leyr_create_measurement
      </code>
    </td>
    
    <td>
      Record a new clinical measurement for a patient
    </td>
  </tr>
</tbody>
</table>

---

## Tool parameters reference

Every tool accepts two optional credential parameters:

<table>
<thead>
  <tr>
    <th>
      Parameter
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        client_id
      </code>
    </td>
    
    <td>
      Your Leyr Client ID. Omit if <code>
        LEYR_CLIENT_ID
      </code>
      
       env var is set.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        client_secret
      </code>
    </td>
    
    <td>
      Your Leyr Client Secret. Omit if <code>
        LEYR_CLIENT_SECRET
      </code>
      
       env var is set.
    </td>
  </tr>
</tbody>
</table>

If neither the env var nor the inline parameter is provided, the tool call will fail with a clear error message.

Most tools also require `emr` (the EHR identifier, e.g. `webdoc`, `epic`) and `care_unit_id` (from `leyr_get_care_units`).

---

## Example prompts

Once connected, try asking your AI:

> *"List all care units for Webdoc and show their IDs"*

> *"Find a patient named Anna Svensson born 1985-03-12 in Webdoc"*

> *"Show available timeslots for Dr. Eriksson next Monday and book the first one for patient 42"*

> *"Cancel appointment abc123 in care unit xyz"*

> *"Write a short unstructured clinical note for patient 99 - the patient reported mild headache, no fever"*

> *"Attach the lab result PDF (base64 string) to patient 77's record"*

---

## Typical workflow

The tools follow a natural dependency chain:

```text
leyr_get_care_units
  └─ leyr_get_resources / leyr_get_healthcare_services
       └─ leyr_get_timeslots
            └─ leyr_create_appointment (needs patient_id)
                     ↑
               leyr_get_patients / leyr_create_patient
```

Your AI assistant will walk through this chain automatically when you describe what you want in plain language.

---

<u-alert color="primary" variant="subtle">
<template v-slot:description="">

Questions, requests, or suggestions? Reach out at [contact@leyr.io](mailto:contact@leyr.io).

</template>
</u-alert>


## Sitemap

See the full [sitemap](http://localhost/sitemap.md) for all pages.