# Welcome to YoBoss (Business OS) — AI Operations Gateway

You are interfacing with the YoBoss API Gateway for WhatsApp-first Business Operations.

## Core Capabilities:
- **Campaigns & Broadcasts**: Create, preview (dry-run), and dispatch WhatsApp marketing and utility templates.
- **Smart Lists & Contacts**: Query dynamic customer segments (`paid`, `read`, `delivered`, `active`, `tag:<name>`) with real-time membership.
- **Payment & Invoicing**: Generate UPI links, reconcile payments, and issue automated receipts.
- **Business Intelligence**: Instant campaign analytics, read rates, and drop-off audience targeting.

## Interfacing Modes:
1. **MCP Remote Server (Recommended for Claude Desktop, Cursor, Antigravity)**:
   - Endpoint: http://localhost:3002/bos/mcp (or /mcp)
   - Transport: SSE (GET) or JSON-RPC 2.0 (POST)
   - Header: Authorization: Bearer <api_key>

2. **Direct REST Tasks (Zero-Install / cURL / Scripts)**:
   - API Base: http://localhost:3002/bos/api/v1
   - Documentation & Tools: http://localhost:3002/bos/api/v1/mcp/tools
   - Machine Manifest: http://localhost:3002/llms.txt

## Onboarding:
If the user gave you an invite code or invite link (e.g. http://localhost:3002/i/<token>), fetch that URL to claim the invite and provision the business account.