Vezeli

Vezeli for developers and AI agents

Vezeli exposes its catalogue of beauty & wellness professionals and their live availability so apps, assistants and AI agents can search and link people to a booking. Everything below is public and needs no key.

For AI agents

Point an MCP-capable assistant at the endpoint below, or fetch the llms.txt guide. Any page also returns Markdown when requested with the header “Accept: text/markdown”.

MCP server

Model Context Protocol over Streamable HTTP. Send an “initialize” request, then “tools/list”. Tools: search_businesses, get_business, check_availability, list_categories, list_cities, get_booking_link. Discovery manifest at /.well-known/mcp.

curl -sS https://<host>/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"example","version":"1.0"}}}'

REST API

A read-only JSON API. The full contract is in the OpenAPI 3.1 document.

Endpoints

GET/api/mobile/v1/businesses?q=&city=&category=&clientele=&sort=Search published professionals (also ?featured=1).
GET/api/mobile/v1/businesses/{slug}Full public profile: services, staff, hours, reviews.
GET/api/mobile/v1/availability?businessId=&durationMinutes=&date=Open slots for a day, or ?next=1&from= for the next available day.
POST/api/mobile/v1/bookingsCreate a booking (requires a signed-in client session).
POST/mcpMCP JSON-RPC (initialize, tools/list, tools/call).

Bookings are completed on the web. MCP returns a booking link rather than creating an appointment; the authenticated endpoint POST /api/mobile/v1/bookings creates one for a signed-in client.

Resources