---
title: "Docs MCP"
description: "Give your AI coding assistant full context about the Leyr API - docs, endpoint reference, and use-case guides via MCP."
canonical_url: "http://localhost/product/mcp/docs-mcp"
---
# Docs MCP

> Give your AI coding assistant full context about the Leyr API - docs, endpoint reference, and use-case guides via MCP.

Add one URL to your IDE. Your AI assistant gets full access to every Leyr endpoint, use-case guide, and code example - and can write correct integration code from your first prompt.

**No credentials required to start. No install.** Your AI can even create your Leyr account, app, and first EMR connection for you, right from the chat.

---

## What your AI can do

<card-group>
<card icon="heroicons:code-bracket" title="Write integration code">

Ask your AI to generate working Python or JavaScript for any Leyr workflow - booking appointments, writing notes, finding patients - and get code that matches the actual API contracts.

</card>

<card icon="heroicons:magnifying-glass" title="Look up any endpoint">

Search all 40+ Leyr API endpoints by keyword, tag, or path. Get full parameter details, request shapes, and response schemas without leaving your editor.

</card>

<card icon="heroicons:rocket-launch" title="Walk through use-case guides">

Step-by-step quickstarts for every major workflow - from showing doctor availability to attaching documents - with complete end-to-end flows.

</card>

<card icon="heroicons:chat-bubble-left-right" title="Answer any API question">

Patient ID formats, error codes, EHR-specific quirks, rate limits - your AI can answer instantly using the real Leyr documentation.

</card>
</card-group>

---

## Setup

No installation required. The MCP server runs as part of the Leyr docs site - just point your IDE at the URL.

No Leyr account needed to use the docs server.

### 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-docs": {
      "url": "https://docs.leyr.io/mcp"
    }
  }
}
```

</template>

<template v-slot:windsurf="">

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

```json
{
  "mcpServers": {
    "leyr-docs": {
      "url": "https://docs.leyr.io/mcp"
    }
  }
}
```

</template>

<template v-slot:claude="">

Run in your terminal:

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

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

```json
{
  "mcpServers": {
    "leyr-docs": {
      "url": "https://docs.leyr.io/mcp"
    }
  }
}
```

</template>

<template v-slot:copilot="">

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

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

</template>

<template v-slot:other="">

The Leyr MCP server is available at:

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

Transport: **Streamable HTTP** (MCP spec 2025-11-25). Refer to your IDE or MCP client documentation for instructions on how to add an HTTP MCP server.

</template>
</u-tabs>

Restart your IDE after saving the config.

---

## Available tools

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

<tbody>
  <tr>
    <td>
      <code>
        list_use_cases
      </code>
    </td>
    
    <td>
      List all use-case guides and the recommended execution order
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        show_doctor_availability
      </code>
    </td>
    
    <td>
      Guide: care units → resources → services → timeslots
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        book_appointment
      </code>
    </td>
    
    <td>
      Guide: book a patient appointment
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        write_medical_note
      </code>
    </td>
    
    <td>
      Guide: write a medical note for a patient
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        attach_document
      </code>
    </td>
    
    <td>
      Guide: attach a document to a patient record
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        find_patient
      </code>
    </td>
    
    <td>
      Guide: search for a patient and retrieve their ID
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        create_patient
      </code>
    </td>
    
    <td>
      Guide: create or upsert a patient record
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        search_docs
      </code>
    </td>
    
    <td>
      Full-text search across all Leyr documentation
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        get_doc_page
      </code>
    </td>
    
    <td>
      Fetch a specific documentation page by slug
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        list_doc_sections
      </code>
    </td>
    
    <td>
      Browse all available documentation sections
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        get_openapi_schema
      </code>
    </td>
    
    <td>
      Full OpenAPI schema summary with all endpoints listed
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        search_endpoints
      </code>
    </td>
    
    <td>
      Search endpoints by keyword, tag, or path
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        get_endpoint
      </code>
    </td>
    
    <td>
      Get full details for a specific endpoint
    </td>
  </tr>
</tbody>
</table>

### Administration

No Leyr account yet? Your AI can set one up for you - account, app, and EMR connection. The one step that stays yours: opening the verification email and clicking the link, same as any other signup.

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

<tbody>
  <tr>
    <td>
      <code>
        register_account
      </code>
    </td>
    
    <td>
      Create a new Leyr account; sends a verification email
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        login
      </code>
    </td>
    
    <td>
      Sign in once the account is verified
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        list_apps
      </code>
    </td>
    
    <td>
      List the apps on the signed-in account
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        get_app
      </code>
    </td>
    
    <td>
      Get a single app by id, including its connected EMRs
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        create_app
      </code>
    </td>
    
    <td>
      Create a new app; returns the <code>
        client_id
      </code>
      
       / <code>
        client_secret
      </code>
      
       pair used for live API calls
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        list_emrs
      </code>
    </td>
    
    <td>
      List every EHR/EMR Leyr can connect to, with required credential fields and mock availability
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        connect_emr
      </code>
    </td>
    
    <td>
      Connect an EMR to an app - sandbox mock connection or a real one with your own credentials
    </td>
  </tr>
</tbody>
</table>

---

## Example prompts

Once connected, try asking your AI:

> *"Show me the full availability and booking flow for Webdoc in Python"*

> *"Look up a patient by Swedish personal number and show me the exact request shape"*

> *"Write a medical note for patient 12345 using the unstructured template"*

> *"What's the difference between emr_id and se_personal_number patient IDs?"*

> *"List all endpoints that support creating resources in Webdoc"*

> *"Set me up with a Leyr account at me@example.com and create an app called 'My Integration'"*

> *"What EHR systems can you connect to, and which ones can I try without real credentials?"*

> *"Connect my app to Webdoc in sandbox mode so I can start testing"*

---

## Ready to make real API calls?

Once your account, app, and an EMR connection exist - whether you set them up here or in the [Developer Portal](https://leyr.io/developers) - use the [Clinical MCP](http://localhost/product/mcp/health-mcp) to execute live API calls directly from your AI assistant: book appointments, write notes, manage patients, and more.

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

Set up Clinical MCP

</u-button>

---

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

Questions, requests, or suggestions for our MCP? 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.