# llms.txt - BookingBand365 AI & MCP Integration Guide
# https://bookingband365.com

> BookingBand365 es la plataforma líder para la contratación directa y transparente de música en directo, grupos musicales, orquestas y solistas para eventos en España.

## Capacidades para Agentes de IA y LLMs

BookingBand365 implementa el estándar **Model Context Protocol (MCP)**, permitiendo a asistentes de IA interactuar con el catálogo, consultar disponibilidad, registrar clientes y solicitar presupuestos y reservas formales de forma autónoma.

### Protocolo MCP (Model Context Protocol)

- **Transporte SSE**: `/api/mcp/sse`
- **Mensajes RPC**: `/api/mcp/message`
- **Manifiesto de Herramientas**: `/api/mcp/info` o `/.well-known/mcp.json`
- **Esquema de Plugin IA**: `/.well-known/ai-plugin.json`
- **Formato de Comunicación**: JSON-RPC 2.0

### Herramientas Disponibles (MCP Tools)

1. **`search_band_catalog`**:
   - *Descripción*: Busca y filtra agrupaciones musicales en el catálogo por nombre, estilo musical (Rock, Pop, Jazz, Flamenco, etc.), provincia o ubicación, presupuesto máximo y fecha del evento.
   - *Parámetros clave*: `query`, `musicStyle`, `location`, `maxBudget`, `targetDate`, `isPromotionalOnly`.

2. **`create_booking`**:
   - *Descripción*: Formaliza una solicitud de reserva/contratación con cálculo automático de comisiones, IVA (21%), kilometraje de desplazamiento y cálculo del depósito en garantía (30%).
   - *Parámetros clave*: `clientId`, `bandId`, `eventDate` (YYYY-MM-DD), `location`, `distanceKm`, `soundSystemRequired`.

3. **`register_user`**:
   - *Descripción*: Registra un nuevo usuario particular o empresa con validación fiscal de CIF/NIF en España.
   - *Parámetros clave*: `email`, `displayName`, `role` (client, band_member, manager), `cifNif`, `phone`.

4. **`create_band`**:
   - *Descripción*: Da de alta un nuevo grupo musical en la plataforma.
   - *Parámetros clave*: `name`, `style`, `location`, `basePrice`, `description`.

5. **`update_band`**:
   - *Descripción*: Actualiza caché, disponibilidad, repertorio y tarifas de una banda existente.

6. **`delete_band`**:
   - *Descripción*: Retira una banda del catálogo activo.

### Recursos Pasivos (MCP Resources)

- **`bookingband://parameters`**: Devuelve las comisiones estándar de la plataforma, descuentos por suscripción Premium y porcentajes de depósito.
- **`bookingband://catalog/summary`**: Resumen del catálogo en Markdown con cachés base y ubicaciones.

### Reglas de Negocio Clave para IAs
- En actuaciones con **Caché 0€** (modalidad promocional para Bandas Premium), la comisión de plataforma es 0€.
- Los clientes con **Suscripción Premium** disfrutan de un 20% de descuento en la comisión de servicio de la plataforma.
- Todas las fechas de evento deben usar formato ISO `YYYY-MM-DD`.