MCP server

Beta. MCP access is available to approved sandbox projects.

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 for a sandbox project.

Last modified on August 6, 2026