AI Assistant Connector
Model Context Protocol (MCP) server · Qunzia LLC
Overview
Qunzia is a bilingual (English/Arabic) directory of local service providers across the GCC (clinics, salons, cleaners, tutors, and more) with online appointment booking. The Qunzia MCP connector exposes that directory and booking flow to AI assistants such as ChatGPT and Claude, so a user can search for and book a provider directly from a conversation, without leaving the assistant.
No Qunzia account is required. Bookings work as a guest, identified by name and phone number.
Connect
The connector is a single remote MCP server, reachable over Streamable HTTP at:
https://qunzia.com/api/mcp
ChatGPT
Developer mode → Add app → enter the endpoint URL above. Or go straight to ChatGPT connector settings.
Claude
Settings → Connectors → Add custom connector → enter the endpoint URL above. Or go straight to Claude connector settings.
Any MCP client
The server speaks standard Streamable HTTP MCP and can be tested with @modelcontextprotocol/inspector or any compliant client. On first connection the server returns its tool list and usage instructions describing the typical search-then-book flow.
Authentication
The connector works without signing in: guest booking is fully supported. If you sign in with your Qunzia account via OAuth, bookings you make are automatically linked to your account so they also appear in your web dashboard, and you can list, reschedule, or cancel them without repeating your phone number. Sign-in uses OAuth 2.1 with PKCE; no separate connector-specific credentials exist.
Guest bookings are identified by the phone number they were made under: the same phone number plus the booking's reference code is enough to look it up, reschedule, or cancel it later, mirroring a standard guest-checkout reference-number model.
Tools
The connector exposes the following tools. Read tools never modify data; write tools create, change, or cancel a booking.
| Tool | Type | What it does |
|---|---|---|
search_providers | Read | Search the directory by keyword, category, and location (country / city / area). Returns a paginated, ranked list of providers with their slugs. |
get_provider | Read | Full details for one provider by slug: description, category, city, contact, rating, opening hours, and bookable services with prices. |
list_reviews | Read | Approved customer reviews for a provider: comments, overall and per-dimension ratings, and any replies the provider has posted. Paginated. |
check_availability | Read | Open appointment start times for a provider: a single local date, or up to a week at a glance, at a chosen branch. Providers without a published calendar still accept requested times for confirmation. |
list_cities | Read | Every city and area Qunzia currently covers, optionally filtered by country. |
list_categories | Read | Every service category and subcategory Qunzia supports. |
book_appointment | Write | Request an appointment with a provider, as a guest or signed in. Returns a reference code; depending on the provider, the booking is confirmed instantly or left pending their approval. |
list_my_bookings | Read | A customer's upcoming appointments, looked up by phone number or by the signed-in Qunzia account. |
reschedule_appointment | Write | Move an existing booking to a new time. Requires the booking's reference code and the phone number it was booked under. |
cancel_appointment | Write | Cancel an existing booking. Requires the booking's reference code and the phone number it was booked under. |
link_qunzia_account | Read | A link to sign in to or create a Qunzia account, so bookings automatically appear in the customer's web dashboard. |
All appointment times are handled in the provider's local timezone. Typical flow:
search_providersget_providercheck_availabilitybook_appointment
Data Handling and Privacy
The connector only receives the specific tool inputs an assistant sends on your behalf: search terms, and, when you choose to book, the customer name, phone number, and optional email needed to create the appointment. It does not receive or store your conversation with the assistant. Full details, including retention and your rights, are covered in Section 13 of our Privacy Policy.
Support
For questions, integration issues, or to report unexpected connector behaviour, contact info@qunzia.com.