# Kahyana — Retail POS, Stock Ledger & Inventory Command Platform
> Ultra-fast, zero-hardware digital sales ledger, inventory control, and daily cash settlement platform for modern retail stores, supermarkets, convenience stores, and shops.

## Machine Surface & Agent Capabilities
- **Auth**: Bearer token authentication (`Authorization: Bearer <API_KEY>`)
- **MCP Endpoint**: POST `/api/mcp`
- **Supported Read-Only Tools (JSON-RPC 2.0)**:
  - `get_stock_levels`: Read live stock on hand, safety thresholds, buy prices, and sell prices.
  - `get_inventory_valuation`: Read wholesale capital locked in inventory, realizable revenue, and gross profit.
  - `get_low_stock_alerts`: Read depleted items at or below safety threshold with restock deficits.
  - `generate_supplier_reorder_list`: Calculate item restock quantities and format draft WhatsApp orders.
  - `get_daily_sales_ledger`: Read chronological sales transactions, receipts, and tender breakdowns.
  - `generate_daily_shift_note`: Format WhatsApp shift closing slips with gross profits and void logs.
  - `get_financial_summary`: Read revenue, cost of goods sold (COGS), gross margins, and payment totals.
  - `get_sales_growth_trajectory`: Read historical velocity and growth trajectory across timescales.
- **Health Check**: GET `/api/health`
- **Prometheus Metrics**: GET `/api/metrics`