WETAEGO Operating System Architecture & API Reference
The unified digital infrastructure for physical storefronts, multi-concept enterprises, and autonomous AI agents. Integrate REST endpoints, connect hardware peripherals, or automate multi-branch fleets via WebMCP and Staff MCP.
1. Authentication & Agent Registration (Auth.md & RFC 8414)
All merchant and administrative API endpoints require standard HTTP Bearer token authentication in the Authorization header. Autonomous AI agents can self-register using the WorkOS Auth.md specification.
https://ourmenuos.online/api
# Example Request Header
Authorization: Bearer <YOUR_MERCHANT_SECRET_KEY>
Content-Type: application/json
OIDC Config: /.well-known/openid-configuration
OAuth Authz: /.well-known/oauth-authorization-server
Protected Res: /.well-known/oauth-protected-resource
2. Full-Spectrum Operations & Business Management Suite
Every merchant account on WETAEGO is equipped with a complete, integrated operations suite powering daily frontline workflows and executive management:
Universal Order Inbox & Fulfillment Board
Real-time order fulfillment with status progression (pending → paid → preparing → ready → out_for_delivery → completed) across all business types—from retail packaging to digital services and kitchen tickets—with audio alerts and thermal printing.
Point of Sale (POS)
High-speed counter POS with barcode scanning, custom item add, split bill payments, manual discounts, and automatic ESC/POS cash drawer kick pulses.
Booking Management (BMS)
Interactive calendar for salons, spas, and clinics with time-slot intervals, staff assignment, appointment duration, and upfront deposit capture.
Property Management (PMS)
Listing manager for serviced apartments and lofts with check-in/out calendars, guest verification, and reservation status tracking.
Delivery Dispatch Hub
Multi-zone delivery dispatch, courier tracking, distance calculations, and flat or dynamic delivery fee rules.
Inventory & Bill of Materials (BOM)
Raw ingredient decrement tracking per dish or service sold, low-stock threshold alerts, and supplier reorder sheets.
CRM, Loyalty & IOU Credit
Automatic customer shadow profiles at checkout, guest LTV tracking, VIP tiers, and customer IOU store credit financing ledger with automated SMS/email debt reminders.
PIN CSAT & Staff Leaderboard
Cryptographic PIN receipts for verified customer reviews, private grievance triage before negative reviews hit Google, and gamified staff performance & tip rankings.
Marketing & Growth Hub
SMS and Email broadcast campaigns, recurring happy hour flash deals, limited-quantity chef drop pricing, and smart cart cross-sell recommendations.
Staff Push-to-Talk Intercom
Zero-latency push-to-talk voice radio, kitchen-to-server ready alerts, table assistance calls, and live floor team coordination over WebSockets.
Analytics & ML Demand Forecast
Revenue velocity, category contribution, hourly peak volume, table turnover, payment breakdown, and ML demand prediction for staffing and prep.
Vector QR & Signage Studio
Branded QR code generator with embedded logos, room/table/desk routing, per-card PNG download, and print layouts.
3. Model Context Protocol (WebMCP & Staff MCP Server)
WETAEGO implements a dual-layer Model Context Protocol architecture separating in-browser customer co-browsing from server-side enterprise fleet management:
Customer Storefront Suite
Auto-registered on all live storefronts with live client state synchronization:
- • search_catalog (query, category, dietary, maxPrice)
- • get_item_details (itemId)
- • create_cart ()
- • add_to_cart (itemId, quantity, modifiers, notes)
- • get_cart ()
- • update_cart (lineId, quantity, notes)
- • initiate_checkout (fulfillment, customer)
- • submit_order (checkoutId, authorization: confirmed)
- • request_staff (reason)
Staff & Enterprise Fleet Operations
Bearer-authenticated RFC JSON-RPC 2.0 server for Claude Desktop, ChatGPT, and enterprise bots:
- • get_active_orders (locationId, status)
- • get_order (orderId)
- • update_order_status (orderId, status)
- • mark_item_unavailable (itemId, isAvailable)
- • get_table_status (locationId)
- • get_daily_sales (locationId, date)
- • duplicate_catalog_to_branch (source, target)
4. Zero-Daemon ESC/POS Hardware Printing SDK
WETAEGO prints binary ESC/POS thermal tickets directly over WebUSB, WebSerial (RS232 COM), and WebBluetooth without print servers or background software. Sends cash drawer kick pulses (ESC p) and hardware paper cuts.
5. Supported Machine Standards & Discovery Protocols
WETAEGO is engineered for total autonomous agent interoperability, implementing 14 open web and AI agent discovery specifications:
Emits HTTP Link response headers advertising api-catalog, service-doc, service-desc, oauth, and skills.
Advertised via /.well-known/api-catalog with application/linkset+json.
Advertised via /.well-known/openid-configuration and /.well-known/oauth-authorization-server.
Published at /.well-known/mcp.json and /api/mcp.
Standard W3C in-browser tools registered via document.modelContext.registerTool().
HTTP 402 agent settlement at /.well-known/x402.json and /.well-known/mpp.json.
6. Universal POS Telemetry & Legacy Ingestion Gateway
WETAEGO features a co-existence architecture. Businesses running existing legacy POS terminals (Toast, Square, Clover, Odoo, SAP, custom registers) do not need to replace their physical checkout hardware. You can stream in-store counter transactions into WETAEGO via our Telemetry Ingestion API or Webhooks to consolidate 100% of revenue, customer LTV, and ML demand forecasts in one unified dashboard.
{
"locationId": "loc_pacy_supermarket_01",
"externalOrderId": "POS-98421",
"source": "clover",
"channel": "in_store_counter",
"terminalId": "Lane_04_Register",
"cashierName": "David A.",
"currency": "USD",
"totalMinor": 4250,
"taxMinor": 350,
"paymentMethod": "pos_card",
"items": [
{ "name": "Organic Almond Milk", "sku": "ALM-01", "quantity": 2, "priceMinor": 1200 },
{ "name": "Sourdough Artisanal Loaf", "sku": "BAK-04", "quantity": 1, "priceMinor": 1850 }
],
"customer": {
"phone": "+1234567890",
"name": "Sarah Jenkins"
}
}Connect Square, Clover, or Toast webhooks at /api/webhooks/pos/:provider or stream via POST /api/v1/pos/ingest.
Take a 1-second photo of physical cash register paper tape; Tego AI camera vision extracts all totals, taxes, and items automatically.
Export daily reports from older Windows POS (Micros, Aloha) and drop into /dashboard/analytics/import.
For standalone mechanical registers: type total Cash, Card, and Tax numbers into the closing shift ledger.