X1
🇦🇺Australia
DocsBook a demo→
AI Agents

The first POS your AI can operate.

Your agent doesn't just read — it adjusts prices, imports menus from PDFs, diagnoses online-ordering issues, and reports. Every write goes through Read → Preview → Commit with approval, idempotency, and audit lineage. Vendor-neutral: Claude, ChatGPT, Gemini, Cursor.

Install in Claude, ChatGPT, Gemini, or Cursor
# claude_desktop_config.json
{
  "mcpServers": {
    "x1Agent": {
      "command": "npx",
      "args": ["-y", "@caterlord/x1-mcp-server"],
      "env": {
        "X1_API_ENDPOINT": "https://mcp.x1.tech/mcp"
      }
    }
  }
}
💡 Works with Claude Desktop, ChatGPT, Gemini, Cursor, and any MCP-compatible client. Every preview and commit requires an approval token — no silent writes.
✦
Claude
X1 connected
⋯
✦
✓Used X1 · get_net_sales_summary
Here's how the group looked this week (Apr 13–19):
ShopThis weekvs last
Harbour CentralHK$ 312,450+11.1%
Kowloon BayHK$ 284,720+14.0%
Tsim Sha TsuiHK$ 356,110+10.9%
Causeway BayHK$ 288,700−2.0%
Net sales were up +8.7% vs last week. Kowloon Bay led the pack. Causeway Bay dipped slightly — want me to check the void log for that shop?
Check Causeway Bay voids →
Top selling items this week →
+Ask about your shops…Sonnet 4.5↑
MENU AUTHORING

Edit your menu from the chat.

Say what you want in plain English. The agent returns a preview — matched items, before/after, risk score — you approve, X1 commits with an idempotency key. No spreadsheet re-keying. No USB-to-shop runs.

Try asking
"Raise all hot drinks by $1 at Kowloon Bay"
"Add a weekday lunch combo for $88"
"Turn off the oat milk modifier at Central"
Tools in this group
preview
preview_adjust_menu_prices
Matched items, exclusions, before/after, warnings, risk score.
commit
commit_adjust_menu_prices
Approval-backed, idempotent, audit lineage, readback verification.
preview
preview_manage_modifier_group
Modifier group metadata, option membership/order, option prices, item mappings.
preview
preview_manage_combo_rule
Map supported combo rules to HQ promotion payloads; block unsupported expressions.
✦
Claude
X1 connected
⋯
✦
✓Used X1 · preview_adjust_menu_prices
Matched 5 items in Hot Drinks at Kowloon Bay. Risk low, no exclusions.
ItemBeforeAfter
Latte$28$29
Cappuccino$28$29
Americano$24$25
Flat White$30$31
Mocha$34$35
Ready to commitidempotency_key · txn_7e1f · audit lineage
Approve to commit — X1 will write through commit_adjust_menu_prices and read back to confirm every row.
Approve & commit
Edit preview
Also update Central
+Ask about your shops…Sonnet 4.5↑
MENU IMPORT

Turn a PDF menu into a live menu.

Drop your supplier's PDF, a photo of the wall menu, or a pasted Excel block. The agent extracts a structured draft, validates against your HQ, and classifies every line so you know exactly what will change before you approve.

Try asking
"Import this supplier's PDF for all 5 shops"
"Update prices from the new Excel sheet"
"Build a menu from this wall photo"
Tools in this group
read
get_menu_authoring_context
Aggregate HQ menus, categories, modifiers, taxes, and naming hints for safe authoring.
read
validate_menu_catalog_draft
Deterministic schema + duplicate + HQ conflict checks before any preview.
preview
preview_import_menu_catalog
Classify each row: create / update / no-op / conflict / unsupported / requires-review.
commit
commit_import_menu_catalog
Async idempotent commit preserving source evidence (page, row, region, extracted text).
✦
Claude
X1 connected
⋯
✦
✓Used X1 · preview_import_menu_catalog
Extracted 6 items from supplier-menu.pdf (page 1–2). Source evidence preserved per row.
PDF
supplier-menu.pdf
2 pages · OCR done · 6 rows
Latte — $28
99% confidence
create
Cappuccino — $28
matches existing
update
Americano — $24
no change
no-op
Mocha Special
modifier mismatch
conflict
Flat White — $30
price only
update
Iced Latte
84% confidence
review
4 safe to commit · 1 conflict needs your eyes · 1 low-confidence row flagged for review. Approve the safe set, resolve the rest?
Approve safe set (4)
Review conflicts (1)
Re-scan page 2
+Ask about your shops…Sonnet 4.5↑
DIAGNOSTICS

Ask why — get a real answer.

An item missing from Foodpanda? A shop that won't publish online? One question to your AI. It inspects every surface that can hide an item — category, menu, modifier, shop price, shop availability, online-ordering flag — and comes back with a cause and a safe fix.

Try asking
"Why isn't Char Siu Rice on Foodpanda?"
"Which items aren't ready to publish online?"
"What's blocking the new Mong Kok shop?"
Tools in this group
read
diagnose_menu_item_visibility
Inspect item, category, menu, modifier, shop price, shop availability, online ordering — one call.
read
check_menu_publish_readiness
Per-shop grouped findings with recommended next safe tools.
read
diagnose_online_ordering_menu_setup
Diagnose online-ordering menu setup across shops: ODO enablement, prices, availability, modifiers.
✦
Claude
X1 connected
⋯
✦
✓Used X1 · diagnose_menu_item_visibility
Found it. Char Siu Rice is marked unavailable at the Kwun Tong shop — it's been off since Saturday 21:00, likely 86'd during service and never re-enabled.
I checked all 8 surfaces that can hide an item. Seven were fine:
✓item detail · category visibility · POS menu · smart-category · modifier availability · shop price · online ordering
✕Shop availability — off at Kwun Tong since Sat 21:00 (last toggled by pos.user42)
Want me to flip it back on? I'd run preview_update_menu_availability first — you'd see the exact diff and approve before I commit.
Yes, preview the fix
Who marked it off?
Check other items at Kwun Tong
+Ask about your shops…Sonnet 4.5↑
REPORTING

Your daily numbers in the same chat.

Ask for trends, compare periods, spot underperformers, catch exceptions — all in the same chat window you already have open. Normalized answers with deltas and caveats, not raw report rows you have to math yourself.

Try asking
"How did last week compare to the week before?"
"Which items are underperforming at the airport shop?"
"Any operational exceptions I should know about?"
Tools in this group
read
get_sales_trend_summary
Normalized daily trend totals, shop totals, and caveats.
read
compare_sales_periods
Two-period comparison with deltas, % change, and top shop contributors.
read
get_item_performance_summary
Item rankings, deltas, contribution, and low-sales flags.
read
get_operational_exception_summary
Exceptions with severity, evidence, and recommended follow-up.
✦
Claude
X1 connected
⋯
✦
✓Used X1 · compare_sales_periods
Last 7 days at Kowloon Bay — HK$ 32,600, up +12.4% vs. the prior week.
Net sales · by hour
Peak Apr 12 · HK$ 0
Apr 1
Apr 2
Apr 3
Apr 4
Apr 5
Apr 6
Apr 7
Apr 8
Apr 9
Apr 10
Apr 11
Apr 12
Apr 13
Apr 14
Top moversvs priortrend
Char Siu Rice+19.8%↗
Milk Tea+10.2%↗
⚑Oxtail Stew−25.2%↘
⚑ Oxtail Stew flagged: low-sales trend · consider menu review
Drill into Oxtail Stew
Compare to last year
Hourly breakdown
+Ask about your shops…Sonnet 4.5↑
SAFETY

Safe by design.

Every write goes through three modes: Read inspects, Preview diffs and scores risk, Commit requires an approval token and writes with idempotency and audit lineage. No silent writes. Agents never guess IDs — they get disambiguation candidates when names are ambiguous.

Try asking
"How do I know what the agent is about to change?"
"Can the agent ever write without approval?"
"Where's the audit trail?"
Tools in this group
read
resolve_hq_scope_reference
Resolve company / brand / shop names to IDs with disambiguation — agents never guess.
read
get_task_status
Poll async task state and retry eligibility for long-running commits.
✦
Claude
X1 connected
⋯
✦
✓Used X1 · get_recent_audit_lineage
I can't. Every write tool I call goes through preview → your approval → commit — and nothing else. No hidden tools, no silent writes, no fallback paths.
Here's the full lineage of the last change I made for you, straight from X1's audit log:
14:02:08PREVIEWpreview_adjust_menu_prices · 5 items · risk low
14:02:14APPROVEDby you · approval_tok_9a3f · scope: Kowloon Bay
14:02:14COMMITcommit_adjust_menu_prices · idempotency: txn_7e1f
14:02:15READBACK5 / 5 rows verified · audit entry written
You can pull this lineage for any tool call, any time. Without a valid approval token, no commit tool will run at all.
Export the audit log
Who can approve?
Revoke my approval
+Ask about your shops…Sonnet 4.5↑
Build with X1

Read the API docs. Ship in an afternoon.

REST, webhooks, and the hosted MCP server — one reference with typed SDKs for TypeScript and Python, OpenAPI 3.1, and a sandbox keyed to your account.