SysPOS MCP Server

Product APIs on app.syspos.ae, as MCP tools

v1.0.0 229 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://pos-mcp.syspos.ae/api/call \
  -H "Authorization: Bearer syspos_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "list_products"
  }'

2. Add to Claude (custom connector)

Settings → Connectors → Add custom connector
Name:  SysPOS Product Tools
URL:   https://pos-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

#ToolDescription
1 list_selling_products GET /api/v2/products
2 list_products GET /api/products/webProducts
3 get_product GET /api/products/:id
4 create_product POST /api/products
5 update_product PUT /api/products/:id
6 delete_product DELETE /api/products/:id
7 archive_product PUT /api/products/archive_product/:id
8 list_selling_categories GET /api/v2/categories
9 list_categories GET /api/categories
10 get_category GET /api/categories/:id
11 create_category POST /api/categories
12 update_category PUT /api/categories/:id
13 delete_category DELETE /api/categories/:id
14 list_selling_modifiers POST /api/v2/modifiers
15 list_modifiers GET /api/modifiers
16 get_modifier GET /api/modifiers/:id
17 create_modifier POST /api/modifiers
18 update_modifier PUT /api/modifiers/:id
19 delete_modifier DELETE /api/modifiers/:id
20 list_modifier_items GET /api/modifierItems
21 get_modifier_item GET /api/modifierItems/:id
22 create_modifier_item POST /api/modifierItems
23 update_modifier_item PUT /api/modifierItems/:id
24 delete_modifier_item DELETE /api/modifierItems/:id
25 list_selling_brands GET /api/v2/brands
26 list_brands GET /api/brands
27 get_brand GET /api/brands/:id
28 create_brand POST /api/brands
29 update_brand PUT /api/brands/:id
30 delete_brand DELETE /api/brands/:id
31 list_groups GET /api/groups
32 get_group GET /api/groups/:id
33 create_group POST /api/groups
34 update_group PUT /api/groups/:id
35 delete_group DELETE /api/groups/:id
36 list_selling_addons GET /api/v2/products
37 list_addons GET /api/products/webProducts
38 get_addon GET /api/products/:id
39 create_addon POST /api/products
40 update_addon PUT /api/products/:id
41 delete_addon DELETE /api/products/:id
42 list_labels GET /api/label
43 get_label GET /api/label/:id
44 create_label POST /api/label
45 update_label PUT /api/label/:id
46 delete_label DELETE /api/label/:id
47 list_deals GET /api/deals
48 get_deal GET /api/deals/:id
49 create_deal POST /api/deals
50 update_deal PUT /api/deals/:id
51 delete_deal DELETE /api/deals/:id
52 list_channels GET /api/channels
53 get_channel GET /api/channels/:id
54 create_channel POST /api/channels
55 update_channel PUT /api/channels/:id
56 delete_channel DELETE /api/channels/:id
57 list_menus GET /api/menus
58 get_menu GET /api/menus/:id
59 create_menu POST /api/menus
60 update_menu PUT /api/menus/:id
61 delete_menu DELETE /api/menus/:id
62 list_selling_coupons GET /api/v2/coupons
63 validate_coupon POST /api/v2/coupons/validate
64 list_coupons GET /api/coupons
65 get_coupon GET /api/coupons/:id
66 create_coupon POST /api/coupons
67 update_coupon PUT /api/coupons/:id
68 delete_coupon DELETE /api/coupons/:id
69 list_coupon_products_by_locations GET /api/coupons/products-by-locations
70 list_coupon_categories_by_locations GET /api/coupons/categories-by-locations
71 list_discounts GET /api/discounts/web
72 get_discount GET /api/discounts/:id
73 create_discount POST /api/discounts
74 update_discount PUT /api/discounts/:id
75 delete_discount DELETE /api/discounts/:id
76 list_selling_payment_methods GET /api/v2/payment-methods
77 list_payment_methods GET /api/payment-methods
78 get_payment_method GET /api/payment-methods/:id
79 create_payment_method POST /api/payment-methods
80 update_payment_method PUT /api/payment-methods/:id
81 delete_payment_method DELETE /api/payment-methods/:id
82 list_selling_order_types GET /api/v2/order-types
83 list_order_types GET /api/order-type
84 list_order_type_codes GET /api/order-type/codes
85 create_order_type POST /api/order-type
86 update_order_type PUT /api/order-type/:id
87 delete_order_type DELETE /api/order-type/:id
88 sync_invoice POST /api/v2/invoice-sync-v3
89 cancel_invoice PUT /api/v2/invoice-cancel/:uuid
90 refund_invoice POST /api/v2/orders-refund
91 update_invoice_payment_methods PUT /api/v2/invoice/:uuid/payment-methods
92 log_invoice_activities POST /api/v2/activities
93 list_kds_orders GET /api/v2/kds-orders
94 update_kds_item_status PUT /api/v2/kds-item-status
95 update_kds_order_status PUT /api/v2/kds-order-status
96 change_kds_order_status PUT /api/v2/kds-change-status/:uuid
97 list_sold_out_products GET /api/v2/products/sold-out
98 update_product_availability POST /api/v2/products/availability
99 list_product_quota GET /api/v2/user-product-quota
100 update_product_quota POST /api/v2/user-product-quota
101 mark_product_sold_out POST /api/v2/user-product-quota/mark-sold-out
102 reset_product_quota POST /api/v2/user-product-quota/:counterId/reset
103 get_active_shift GET /api/v2/shifts/active
104 list_shifts GET /api/v2/shifts
105 shift_clock_in POST /api/v2/shifts/clock-in
106 shift_clock_out POST /api/v2/shifts/clock-out
107 list_drawer_categories GET /api/v2/shifts/drawer-categories
108 list_drawer_transactions GET /api/v2/shifts/drawer-transactions
109 create_drawer_transaction POST /api/v2/shifts/drawer-transactions
110 get_tills_summary GET /api/v2/shifts/tills-summary
111 get_ol_info GET /api/v2/ol-info
112 get_user_extras GET /api/v2/user-extras-v3
113 get_user_location GET /api/v2/user-location
114 list_pos_users GET /api/v2/users-list
115 list_selling_channels GET /api/v2/get-channels
116 get_master_data GET /api/v2/master-data
117 get_today_sales GET /api/v2/today-sales-v3
118 get_invoice_activities GET /api/v2/activities/:uuid
119 get_maintenance_status GET /api/v2/maintenance/status
120 update_user_permissions POST /api/v2/update-user-permissions
121 get_loyalty_card GET /api/v2/loyalty-program/card/:crmUserId
122 validate_loyalty_burn POST /api/v2/loyalty-program/burn-validation
123 list_locations GET /api/locations
124 get_location GET /api/locations/:id
125 get_business_info GET /api/config/business-info
126 get_location_config GET /api/config/all
127 get_currency GET /api/config/currency
128 get_config_value GET /api/config/:name
129 save_config POST /api/config
130 create_business_info POST /api/config/business-info
131 update_business_info PUT /api/config/business-info
132 get_business_hours GET /api/config/business-hours
133 get_location_days_hours GET /api/location-days-hours-config
134 get_pos_configs GET /api/v2/config/get-all-configs
135 create_location POST /api/locations
136 update_location PUT /api/locations/:id
137 delete_location DELETE /api/locations/:id
138 upsert_location_days_hours POST /api/location-days-hours-config/bulk-upsert
139 list_selling_floors GET /api/v2/floors
140 list_selling_tables GET /api/v2/tables
141 list_floors_by_location GET /api/floors-location/:location_id
142 get_floor GET /api/floors/:id
143 list_tables_by_location GET /api/tables-location/:location_id
144 list_tables_by_floor GET /api/tables-floor/:floor_id
145 get_table GET /api/tables/:id
146 list_dine_orders GET /api/v2/dine-orders-v3
147 get_table_order GET /api/dine-table-order/:table
148 list_orders_history GET /api/v2/orders-history
149 get_invoice GET /api/invoice-v2/:uuid
150 get_invoice_items GET /api/invoice-v2/:uuid/items
151 list_materials GET /api/materials
152 get_material GET /api/materials/:id
153 get_material_stock GET /api/inventory/:material_id/stock
154 list_inventory GET /api/inventory
155 get_materials_stats GET /api/materials/stats
156 list_material_categories GET /api/inventory/categories
157 get_material_used_in_recipes GET /api/materials/:id/used-in-recipes
158 list_inventory_movements GET /api/inventory/movements-v3
159 get_inventory_movements_ledger GET /api/inventory/movements-ledger
160 get_material_movements GET /api/inventory/:id/movs
161 list_suppliers GET /api/suppliers
162 list_supplier_materials GET /api/supplier-materials
163 list_supplier_invoices GET /api/supplier-invoices
164 list_stock_transfers GET /api/stock-transfer-invoices
165 list_stock_order_requests GET /api/stock-order-request
166 list_wastage GET /api/wastage
167 list_inventory_counts GET /api/inventory-counts/list
168 get_inventory_count GET /api/inventory-counts/by-id
169 list_recipes GET /api/recipe
170 get_recipe GET /api/recipe/:id
171 create_material POST /api/materials
172 update_material PUT /api/materials/:id
173 delete_material DELETE /api/materials/:id
174 get_material_category GET /api/inventory/categories/:id
175 create_material_category POST /api/inventory/categories
176 update_material_category PUT /api/inventory/categories/:id
177 delete_material_category DELETE /api/inventory/categories/:id
178 get_supplier GET /api/suppliers/:id
179 create_supplier POST /api/suppliers
180 update_supplier PUT /api/suppliers/:id
181 delete_supplier DELETE /api/suppliers/:id
182 create_recipe POST /api/recipe
183 update_recipe PUT /api/recipe/:id
184 delete_recipe DELETE /api/recipe/:id
185 create_inventory_count_sheet POST /api/inventory-count-sheets/create-sheet
186 update_inventory_count_sheet PUT /api/inventory-count-sheets/update-sheet/:id
187 delete_inventory_count_sheet DELETE /api/inventory-count-sheets/delete-sheet/:id
188 get_purchase_order GET /api/supplier-invoices/:uuid
189 create_draft_purchase_order POST /api/supplier-invoices/draft
190 update_draft_purchase_order_lines PUT /api/supplier-invoices/:uuid/price-quantity
191 delete_draft_purchase_order DELETE /api/supplier-invoices/:uuid
192 create_inventory_count POST /api/inventory-counts/create
193 update_inventory_count_materials PUT /api/inventory-counts/update-materials
194 update_inventory_count_item PUT /api/inventory-counts/update-item-count
195 add_inventory_count_item POST /api/inventory-counts/add-item
196 get_wastage GET /api/wastage/:id
197 create_wastage_draft POST /api/wastage
198 update_wastage_draft PUT /api/wastage/:id
199 delete_wastage_draft DELETE /api/wastage/:id
200 get_stock_transfer GET /api/stock-transfer-invoices/:id
201 create_stock_transfer POST /api/stock-transfer-invoices
202 update_stock_transfer PUT /api/stock-transfer-invoices/update/:id
203 update_stock_transfer_items PUT /api/stock-transfer-invoices/items/:id
204 get_stock_order_request GET /api/stock-order-request/:uuid
205 create_stock_order_request POST /api/stock-order-request
206 update_stock_order_request PUT /api/stock-order-request/update/:uuid
207 list_work_orders GET /api/work-orders
208 get_work_order GET /api/work-orders/:id
209 create_work_order POST /api/work-orders
210 update_work_order PUT /api/work-orders/:id
211 delete_work_order DELETE /api/work-orders/:id
212 list_users GET /api/users
213 get_user GET /api/users/:id
214 update_user PUT /api/users/:id
215 assign_user_role POST /api/users/assign-role
216 list_pos_crm_users GET /api/v2/crm/users
217 create_pos_crm_user POST /api/v2/crm/users
218 update_pos_crm_user POST /api/v2/crm/users/:id
219 list_crm_users GET /api/crm-users
220 list_crm_users_details GET /api/crm-users/details
221 get_crm_user GET /api/crm-users/:id
222 get_crm_user_details GET /api/crm-users/:id/details
223 create_crm_user POST /api/crm-users
224 update_crm_user PUT /api/crm-users/:id
225 list_roles GET /api/roles
226 get_role GET /api/roles/:id
227 create_role POST /api/roles
228 update_role PUT /api/roles/:id
229 describe_tool Full documentation of another tool: every param, every response field with its meaning, the rules (how the POS/dashboard uses it and how it links to other tools), caveats and real examples

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

SysPOS MCP Server