BOS MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BOS_API_URL | No | BOS API base URL | https://bos.ai.vn/api |
| BOS_API_TOKEN | Yes | Bearer token cho auth | |
| BOS_API_TIMEOUT | No | Request timeout (ms) | 30000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| boscli_health_checkA | Full BOS system health check - modules, database, cache, routes |
| boscli_health_modulesB | Check health of all BOS modules |
| boscli_health_databaseA | Check BOS database connectivity |
| boscli_health_cacheC | Check BOS cache systems |
| boscli_health_schemaB | Check BOS database schema integrity |
| boscli_module_listA | List all BOS modules with their enabled/disabled status |
| boscli_module_showB | Get details of a specific BOS module |
| boscli_module_enableB | Enable a BOS module by name |
| boscli_module_disableB | Disable a BOS module by name |
| boscli_route_listC | List all BOS routes, optionally filtered by module |
| boscli_route_by_moduleA | Get all routes for a specific BOS module |
| boscli_cache_listA | Get BOS cache configuration and status |
| boscli_cache_clearC | Clear BOS application caches |
| boscli_system_infoA | Get BOS system information - version, PHP, Laravel, environment |
| boscli_system_logsC | Read recent BOS log entries |
| boscli_system_git_statusA | Get BOS git repository status - branch, commit, changed files |
| boscli_system_deploy_statusC | Get deployment status for BOS servers |
| bos_product_listC | List products with pagination and filters |
| bos_product_showA | Get product details by ID |
| bos_product_searchA | Search products by name, SKU, or bar code |
| bos_product_categoriesA | Get all product categories |
| bos_product_createC | Create a new product |
| bos_product_updateC | Update an existing product |
| bos_product_deleteC | Delete a product |
| bos_product_variantsC | Get all variants for a product |
| bos_product_stockB | Get stock levels for a product across all locations |
| bos_product_imagesD | Get images for a product |
| bos_product_countB | Get total product count with optional filters |
| bos_order_listC | List orders with filters |
| bos_order_showB | Get order details by ID |
| bos_order_createC | Create a new order |
| bos_order_update_statusC | Update order status |
| bos_order_cancelC | Cancel an order |
| bos_order_count_by_statusB | Get order counts grouped by status |
| bos_order_searchC | Search orders by invoice number or customer name |
| bos_order_transactionsC | Get payment transactions for an order |
| bos_order_shipping_infoC | Get shipping information for an order |
| bos_order_update_shippingC | Update shipping status for an order |
| bos_order_add_noteC | Add a staff note to an order |
| bos_order_refundC | Process a refund for an order |
| bos_cart_getB | Get current user cart |
| bos_cart_add_itemC | Add item to cart |
| bos_cart_update_itemC | Update cart item quantity |
| bos_cart_remove_itemC | Remove item from cart |
| bos_cart_clearA | Clear all items from cart |
| bos_cart_apply_voucherC | Apply voucher code to cart |
| bos_cart_remove_voucherA | Remove voucher from cart |
| bos_customer_listC | List customers with pagination |
| bos_customer_showC | Get customer details by ID |
| bos_customer_createC | Create a new customer |
| bos_customer_updateC | Update customer information |
| bos_customer_deleteC | Delete a customer |
| bos_customer_searchB | Search customers by name, phone or email |
| bos_customer_ordersC | Get order history for a customer |
| bos_customer_transactionsC | Get payment transactions for a customer |
| bos_customer_address_listC | List all addresses for a customer |
| bos_customer_address_createB | Add a new address for a customer |
| bos_customer_address_updateD | Update a customer address |
| bos_customer_address_deleteC | Delete a customer address |
| bos_customer_loyalty_summaryC | Get loyalty points summary for a customer |
| bos_customer_countC | Get total customer count with optional filters |
| bos_inventory_listC | List inventory stock across all products |
| bos_inventory_checkC | Check stock quantity for a product |
| bos_inventory_updateC | Update inventory stock |
| bos_inventory_low_stockC | Get products with low stock alerts |
| bos_voucher_listC | List available vouchers |
| bos_voucher_validateC | Validate a voucher code |
| bos_voucher_createD | Create a new voucher |
| bos_customer_vouchersC | Get vouchers for current customer |
| bos_loyalty_points_balanceC | Get loyalty points balance for customer |
| bos_loyalty_points_historyC | Get loyalty points transaction history |
| bos_loyalty_earnD | Earn loyalty points |
| bos_loyalty_redeemC | Redeem loyalty points |
| bos_loyalty_tiersB | Get loyalty tier information |
| bos_store_listB | List all stores locations |
| bos_store_showC | Get store details |
| bos_store_nearbyC | Find nearby stores by location |
| bos_store_staffC | Get staff members for a store |
| bos_store_inventoryC | Get inventory summary for a specific store |
| bos_business_infoB | Get business/shop settings and profile information |
| bos_checkout_calculateC | Calculate checkout totals |
| bos_checkout_createC | Create order from cart |
| bos_payment_methodsC | Get available payment methods |
| bos_payment_verifyC | Verify payment status |
| bos_promotion_listC | List active promotions and campaigns |
| bos_promotion_showC | Get promotion details |
| bos_promotion_applyC | Apply promotion to order |
| bos_homeA | Get home page data (banners, categories, featured products) |
| bos_bannersC | Get promotional banners |
| bos_notificationsC | Get user notifications |
| bos_notification_mark_readB | Mark notification as read |
| bos_erp_overviewA | Get ERP overview counts for customers, suppliers, products, sales, purchases, and expenses |
| bos_purchase_listC | List purchase transactions and purchase orders |
| bos_expense_listC | List expense transactions and refunds |
| bos_stock_movement_listC | List stock adjustments, transfers, and opening stock movements |
| bos_accounting_summaryB | Get sales, purchases, expenses, and journal entry summary |
| bos_hr_employee_listC | List ERP employees/users |
| bos_crm_lead_listC | List CRM leads from CRM module or contact fallback |
| bos_approval_listC | List approval requests/workflows when Approval module tables are installed |
| bos_delivery_shipment_listC | List delivery shipments or delivery orders when Delivery module tables are installed |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 108 tools
While each tool has a clear description, the high number (108) and overlapping domains (e.g., multiple list and search tools) create potential confusion. Agents might struggle to select the correct tool among many similar ones, especially with mixed language descriptions.
All tools follow a consistent 'bos_<domain>_<action>' pattern in snake_case. Verbs are predictable (list, create, update, delete, get, search, show), making navigation easy despite the large set.
108 tools is far too many for a single MCP server. It attempts to cover an entire retail/ERP system, including CLI commands, smart analytics, and administrative functions. The tool surface should be split into multiple focused servers (e.g., orders, products, customers, admin).
The tools cover the core lifecycle for most domains: customers (CRUD + addresses), products (CRUD + variants), orders (full workflow), cart/checkout, inventory, and more. Minor gaps exist (e.g., no category management beyond listing), but overall it's comprehensive for a retail system.