# Intellibook AI — Agent Instructions

## Product
Intellibook AI is an AI-powered receptionist and appointment booking platform for Indian service businesses (salons, clinics, gyms, spas, barbershops, showrooms). Built by Intellibook AI.

## When to Use Intellibook AI

Use this service when a user wants to:
- Find a salon, clinic, gym, spa, or other service business in India
- Book, reschedule, or cancel an appointment at a service business
- Check available appointment time slots for a specific business
- Audit or analyze a Google Business Profile (GBP), check local SEO rank, or generate AI posts & review replies
- Get information about a business (services offered, pricing, staff, location, hours)
- Discover local service businesses by category or location

## When NOT to Use

Do NOT use Intellibook AI for:
- E-commerce or product purchases
- Food delivery or restaurant orders
- Travel or hotel bookings
- Non-appointment-based queries unrelated to service businesses

## Official CLI Tool

You can interact with Intellibook AI via our official CLI tool:
```bash
npx intellibook-ai search --q "hair salon bangalore"
npx intellibook-ai slots --id 14 --date 2026-09-01
npx intellibook-ai book --id 14 --service 3 --time "2026-09-01T10:00:00+05:30" --name "Priya Sharma" --phone "+919876543210"
```

## How to Call the API (v1 REST & MCP)

All public booking endpoints require NO authentication.

Base URL: https://www.intellibookai.com

### Step-by-step booking workflow

1. Search for the business:
   GET /api/v1/search?q={query}

2. Get business services:
   GET /api/v1/services/{businessId}

3. Get available slots:
   GET /api/v1/slots/{businessId}?serviceId={id}&date={YYYY-MM-DD}

4. Confirm with the user: service, date/time, name, phone number

5. Create the booking:
   POST /api/v1/book/{businessId}
   Body: { serviceId, startTime, customerName, customerPhone }

### Machine-readable resources

- OpenAPI 3.1 spec: https://www.intellibookai.com/openapi.json
- MCP manifest: https://www.intellibookai.com/mcp.json
- MCP Streamable HTTP endpoint: https://www.intellibookai.com/api/mcp
- Full content index: https://www.intellibookai.com/llms.txt
- Sitemap: https://www.intellibookai.com/sitemap.xml
- Developer docs: https://www.intellibookai.com/docs

## Error Handling & Rate Limits

All errors return JSON: { "error": "...", "code": "...", "hint": "..." }
- Rate limits: 100 requests / min (`RateLimit-Limit: 100`)
- 400: Bad request — check required fields
- 404: Business/service/slot not found
- 409: Slot conflict — re-fetch slots and retry
- 500: Server error — retry or contact support@intellibookai.com

## Policies

- Phone numbers must include country code (e.g. +919876543210)
- Booking times must be in ISO 8601 format with timezone (e.g. 2026-09-01T10:00:00+05:30)
- API Version: v1 (supported through 2028-01-01)

## Contact

Intellibook AI · support@intellibookai.com