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

# MCP server

> Connect approved agents to scoped Heyrafiki sandbox capabilities.

<Note>
  Beta. MCP access is available to approved sandbox projects.
</Note>

Connect an MCP client to:

```
https://mcp.heyrafiki.space/api/mcp
```

Connections use OAuth. Access tokens are bound to the MCP resource, a Heyrafiki Organization and an approved tool scope.

| Tool                            | Purpose                                     | Required scope       |
| ------------------------------- | ------------------------------------------- | -------------------- |
| `list_practitioners`            | List synthetic Practitioner profiles        | `practitioners:read` |
| `get_practitioner`              | Retrieve one synthetic Practitioner         | `practitioners:read` |
| `get_practitioner_availability` | Read recurring weekly hours                 | `availability:read`  |
| `list_bookings`                 | List synthetic Bookings                     | `bookings:read`      |
| `get_booking`                   | Retrieve one synthetic Booking              | `bookings:read`      |
| `list_sessions`                 | List synthetic Sessions                     | `sessions:read`      |
| `get_session`                   | Retrieve one synthetic Session              | `sessions:read`      |
| `list_claims`                   | List tenant-scoped synthetic Claims         | `claims:read`        |
| `get_claim`                     | Retrieve one tenant-scoped synthetic Claim  | `claims:read`        |
| `get_eligibility_check`         | Retrieve one synthetic eligibility decision | `benefits:read`      |
| `get_preauthorization`          | Retrieve one synthetic pre-authorization    | `benefits:read`      |
| `list_remittances`              | List project-scoped synthetic remittances   | `remittances:read`   |
| `get_remittance`                | Retrieve one synthetic remittance           | `remittances:read`   |

MCP tools are read-only and use the same resource contracts as the REST API. [Request access](https://heyrafiki.space/waitlist) for a sandbox project.