SysPOS MCP Server

AI-powered business analytics for restaurant owners

v1.0.0 15 Tools MCP + REST

API Documentation API Docs (JSON) Tool List (JSON) Health Check

Endpoints

GET /sse

MCP protocol via Server-Sent Events.

POST /api/call

REST API — call any tool with a simple JSON POST.

GET /api/tools

List all tools with full parameter schemas (JSON).

GET /api/docs

Machine-readable docs for AI agents (JSON).

GET /docs

Human-readable API documentation page.

GET /health

Server health check.

Quick Start

1. Call a tool via REST

curl -X POST https://mcp.syspos.ae/api/call \
  -H "Authorization: Bearer syspos_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "get_locations_overview"
  }'

2. Add to Claude (custom connector)

Settings → Connectors → Add custom connector
Name:  SysPOS Owner Agent
URL:   https://mcp.syspos.ae/mcp
(leave OAuth Client ID / Secret blank)

→ Add → Connect → paste your syspos_... key → Authorize

OAuth, handled for you: Claude registers itself automatically (DCR + PKCE). You just paste your syspos_... key on the login page. Other MCP clients can still send the raw key as an Authorization: Bearer <key> header against /mcp or /sse.

Tools

#	Tool	Description
1	resolve_locations	Resolve branch/location names to IDs
2	get_executive_daily_brief	Get today's executive sales summary for the owner
3	get_multi_location_performance	Compare performance across all branches/locations
4	get_sales_trend_and_anomalies	Explain "why sales changed
5	get_hourly_sales_heatmap	Hourly and day-of-week sales heatmap: shows peak hours, slow periods, covers (guests) density, and best/worst time slots
6	get_payment_mix_analysis	Payment method breakdown and trends: cash vs card vs digital, per-location payment preferences, daily payment trends
7	get_profit_leakage_alerts	Detect suspicious operational leakage: unusual refunds, voids, high discount usage, inventory variance, cash mismatches, manager overrides, and low-margin items
8	get_branch_health_score	One-number operational health overview per branch
9	get_shift_performance	Analyze shift-level performance: revenue per shift, orders per shift, cash accuracy, opening/closing times
10	get_staff_performance	Staff performance analysis: revenue per cashier, orders handled, average order value, discount usage, refund rate
11	get_inventory_alerts	Inventory health overview: low stock items, out-of-stock items, overstocked items, and reorder suggestions across locations
12	get_menu_performance_summary	Strategic menu engineering analysis
13	get_customer_retention_snapshot	Customer repeat behavior analysis
14	get_location_settings	Get configuration/settings for locations: currency, VAT %, daily target, fixed costs (yearly/quarterly/monthly), business info (name, address, phone, email), font size, page width, page margins, max order time, and any other config key-value pairs
15	get_locations_overview	Get a complete overview of all locations (branches) accessible to this account

See full documentation for parameters, examples, and response shapes.

SysPOS MCP Server