intellibookai developer resources

Official complete API reference, MCP Server, CLI tool, and integration guides maintained by Intellibook AI.

OpenAPI 3.1 Spec MCP Manifest MCP Endpoint (/api/mcp)CLI Documentation Deprecation & Sunset Policy Agent Instructions llms.txt Index Sitemap

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

Read full CLI Documentation →

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

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" \
  -H "Content-Type: application/json" \
  -d '{
    "businessId": 14,
    "serviceId": 3,
    "preferredDate": "2026-09-01",
    "customerName": "Rohan Mehta",
    "customerPhone": "+919876543211"
  }'

3.7 POST /api/v1/gbp/audit

Run an instant AI audit and local SEO completeness score check for a Google Business Profile listing.

curl -X POST "https://www.intellibookai.com/api/v1/gbp/audit" \
  -H "Content-Type: application/json" \
  -d '{ "businessName": "Glow Beauty Salon", "city": "Bangalore" }'

3.8 POST /api/v1/gbp/rank-track

Track local search rank across Google Maps city grid for specific keywords.

curl -X POST "https://www.intellibookai.com/api/v1/gbp/rank-track" \
  -H "Content-Type: application/json" \
  -d '{ "businessId": 14, "keyword": "best hair salon near me" }'

3.9 POST /api/v1/gbp/reviews/reply

Generate smart, professional AI responses for Google Reviews.

curl -X POST "https://www.intellibookai.com/api/v1/gbp/reviews/reply" \
  -H "Content-Type: application/json" \
  -d '{ "reviewText": "Great service and clean salon!", "starRating": 5 }'

3.10 POST /api/v1/billing/deposit

Create a Cashfree payment link for booking deposit collection on WhatsApp.

curl -X POST "https://www.intellibookai.com/api/v1/billing/deposit" \
  -H "Content-Type: application/json" \
  -d '{ "businessId": 14, "amount": 200, "customerPhone": "+919876543210" }'

3.11 GET /api/v1/calendar/sync

Fetch 2-way iCal calendar sync feed for staff members to prevent double bookings.

curl -s "https://www.intellibookai.com/api/v1/calendar/sync?businessId=14&staffId=2"

3.12 POST /api/v1/broadcasts

Trigger WhatsApp marketing or utility broadcast campaigns to opted-in customer lists.

curl -X POST "https://www.intellibookai.com/api/v1/broadcasts" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "templateName": "festival_offer_20", "targetSegment": "inactive_60_days" }'

3.13 GET /api/v1/customers/:id

Retrieve customer profile, total visits, lifetime value, and notes.

curl -s -H "Authorization: Bearer YOUR_API_TOKEN" "https://www.intellibookai.com/api/v1/customers/1042"

3.14 POST /api/v1/handoffs

Escalate a WhatsApp conversation from AI mode to human receptionist control.

curl -X POST "https://www.intellibookai.com/api/v1/handoffs" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "conversationId": "wa_9876543210", "action": "pause_ai" }'

3.15 POST /api/mcp

Model Context Protocol Streamable HTTP JSON-RPC 2.0 endpoint for Claude and ChatGPT tool execution.

curl -X POST "https://www.intellibookai.com/api/mcp" \
  -H "Content-Type: application/json" \
  -d '{ "jsonrpc": "2.0", "id": 1, "method": "initialize" }'

4. Model Context Protocol (MCP) Streamable HTTP Integration

Intellibook AI natively supports the Model Context Protocol (MCP) via Streamable HTTP transport:

MCP Manifest: https://www.intellibookai.com/mcp.json
Well-Known Manifest: https://www.intellibookai.com/.well-known/mcp.json
Streamable HTTP Server Endpoint: https://www.intellibookai.com/api/mcp
Supported Tools: searchBusinesses, getAvailableSlots, createBooking, auditGoogleBusinessProfile

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.