intellibookai developer resources
Official complete API reference, MCP Server, CLI tool, and integration guides maintained by Intellibook AI.
1. Intellibook AI Developer Overview & Base URLs
Welcome to the official intellibookai developer resources portal. Intellibook AI exposes high-performance REST endpoints, Model Context Protocol (MCP) servers, and CLI tools for AI agents (Claude, ChatGPT, Gemini), developers, and custom business integrations.
- Production Base URL:
https://www.intellibookai.com/api/v1 - Legacy Base URL:
https://www.intellibookai.com/api/public - Authentication: Public endpoints (search, slots, services, staff, booking, waitlist) require no API key. Enterprise admin routes require Bearer JWT.
- Rate Limit: 100 requests / minute per IP. Standard RFC
RateLimit-*headers are returned on all responses. - Deprecation Policy: API v1 is guaranteed stable through 2028-01-01. Sunset details are at /docs/api-versioning.
2. Official CLI Tool (npm: intellibook-ai)
Interact with Intellibook AI directly from your terminal or AI agent shell via our official CLI tool:
# Run directly with npx: npx intellibook-ai search --q "hair salon bangalore" # Install globally via npm: npm install -g intellibook-ai # Direct shell installer: curl -fsSL https://www.intellibookai.com/cli.sh | sh
3. Complete v1 REST API Reference (15 Endpoints)
3.1 GET /api/v1/search
Search registered businesses (salons, clinics, gyms, spas, retail) by name, category, or city.
curl -s "https://www.intellibookai.com/api/v1/search?q=salon+bangalore&limit=10"
3.2 GET /api/v1/slots/:businessId
Get real-time available time slots for a business, service, or staff member.
curl -s "https://www.intellibookai.com/api/v1/slots/14?serviceId=3&date=2026-09-01"
3.3 GET /api/v1/services/:businessId
List all active services, durations, and prices offered by a business.
curl -s "https://www.intellibookai.com/api/v1/services/14"
3.4 GET /api/v1/staff/:businessId
List staff members/stylists/doctors and working schedule for a business.
curl -s "https://www.intellibookai.com/api/v1/staff/14"
3.5 POST /api/v1/book/:businessId
Create an appointment booking for a customer. Returns confirmation details or deposit payment link.
curl -X POST "https://www.intellibookai.com/api/v1/book/14" \
-H "Content-Type: application/json" \
-d '{
"serviceId": 3,
"startTime": "2026-09-01T10:00:00+05:30",
"customerName": "Priya Sharma",
"customerPhone": "+919876543210"
}'3.6 POST /api/v1/waitlist/{businessId}
Join a waitlist for fully booked dates. Customers get auto-notified on WhatsApp when a cancellation opens a slot.
curl -X POST "https://www.intellibookai.com/api/v1/waitlist/14" \
-H "Content-Type: application/json" \
-d '{
"serviceId": 3,
"preferredDate": "2026-09-01",
"customerName": "Rohan Mehta",
"customerPhone": "+919876543210"
}'3.7 POST /api/v1/seo-audit
Audit a Google Business Profile for local SEO ranking signals, NAP consistency, and appointment link integration.
curl -X POST "https://www.intellibookai.com/api/v1/seo-audit" \
-H "Content-Type: application/json" \
-d '{ "businessName": "Glam Studio", "city": "Bangalore" }'3.8 GET /api/v1/booking/:code
Check appointment confirmation status, reschedule, or cancel via booking code.
curl -s "https://www.intellibookai.com/api/v1/booking/BK-4921"
3.9 GET /api/v1/reviews/:businessId
Retrieve verified customer reviews and ratings for a business.
curl -s "https://www.intellibookai.com/api/v1/reviews/14"
4. Use Intellibook AI in ChatGPT, Claude and Other AI Assistants (MCP)
Intellibook AI runs a Model Context Protocol (MCP) server. Connect it to an AI assistant and you can ask it to find a salon, clinic, spa or gym listed on Intellibook AI, check open times and book an appointment. The booking confirmation arrives on your WhatsApp. No sign-in is needed.
Connect
- Server URL:
https://www.intellibookai.com/mcp(Streamable HTTP, no authentication) - Claude: Settings, then Connectors, then Add custom connector, and paste the server URL.
- ChatGPT: add it from the app directory, or in developer mode create an app with the server URL.
- Other MCP clients: add a remote (Streamable HTTP) server with the same URL. The manifest is at
https://www.intellibookai.com/mcp.json.
Tools
searchBusinesses(read-only): find listed businesses by name, type or service, optionally in a city.getBusinessServices(read-only): a business's services with duration, price and whether it needs a deposit, and its staff.getAvailableSlots(read-only): open start times for a service, for a given day or the next days with openings.createBooking(creates an appointment): books a returned time for the customer's name and WhatsApp number.
Example requests
- “Find a hair salon in HSR Layout, Bangalore on Intellibook.”
- “What services does that salon offer, and how much is a haircut?”
- “Is there a free slot for a haircut there on Saturday morning?”
- “Book the 11 am slot for Priya Rao, WhatsApp +91 98765 43210.”
Good to know
- Only businesses that are live on Intellibook AI and connected to WhatsApp can be found and booked.
- Every booking is confirmed to the customer on WhatsApp, and no payment is taken or requested. Services that need a deposit are marked and can't be booked through an assistant; the assistant links to the business's page for those.
- To limit misuse, one phone number can have at most 3 bookings made through AI assistants per day. If someone booked with your number, reply to the WhatsApp confirmation to cancel.
- Data handling is described in our privacy policy. Support: support@intellibookai.com.
5. RFC 9457 Problem Details Error Model
All API error responses return structured RFC 9457 Problem Details JSON with actionable resolution hints:
{
"type": "https://www.intellibookai.com/docs/errors#slot-conflict",
"title": "Slot Conflict",
"status": 409,
"detail": "This slot is no longer available. Please choose a different time.",
"code": "SLOT_CONFLICT",
"hint": "Fetch fresh slots from GET /api/v1/slots/{id} and retry."
}6. Intellibook AI Developer Support
Intellibook AI is engineered & operated by Intellibook AI. For developer assistance, enterprise API keys, or feedback, email support@intellibookai.com.