Voila Groceries MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Port for HTTP transport. | 8080 |
| VOILA_GUEST | No | Set to '1' to force guest session behavior for safe introspection environments (e.g., Glama). | |
| MCP_HTTP_HOST | No | Host for HTTP transport when MCP_TRANSPORT=http. | 0.0.0.0 |
| MCP_HTTP_PATH | No | HTTP path for MCP endpoint. | /mcp |
| MCP_TRANSPORT | No | Transport mode: 'stdio' (default) or 'http'. | stdio |
| VOILA_AUTH_SESSION_PATH | No | Absolute path to session JSON file captured via CLI. Required for authenticated session. |
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 |
|---|---|
| voila_check_session_healthA | Check whether the configured Voila session is active, retryable, expired, or guest-only. |
| voila_get_active_shopping_contextC | Read the active Voila delivery and cart context. Preferred first step for order planning before product discovery because availability and pricing are session and slot-context sensitive. |
| voila_get_slot_listingsA | List available Voila delivery slots for an explicit delivery destination and region. Preferred first step for order planning; this is read-only and does not reserve a slot. |
| voila_reserve_slotA | Reserve a caller-selected Voila delivery slot. This is a mutation and should only be called after a latest slot listing and explicit user confirmation. |
| voila_search_productsA | Search Voila products by text query for the current session context. Product availability and pricing are session and slot-context sensitive, so prefer checking slots first when planning an order. |
| voila_get_category_productsA | Fetch products for a Voila category id for the current session context. Product availability and pricing are session and slot-context sensitive, so prefer checking slots first when planning an order. |
| voila_get_discounted_productsA | Fetch discounted Voila products from promotions. Product availability and pricing are session and slot-context sensitive, so prefer checking slots first when planning an order. By default returns only meaningful discounts ($0.50 or 10% savings); lower thresholds only when the user asks. Query matches are filtered locally and include scan metadata. |
| voila_get_completed_ordersA | Fetch completed Voila orders with cursor pagination for the authenticated account. |
| voila_get_order_detailsA | Fetch item-level details for one completed Voila order by order id. |
| voila_get_completed_order_itemsA | Aggregate previously ordered items across completed orders, optionally within a date range. |
| voila_get_cartA | Fetch the current active cart with totals, limited items, unavailable data, and pricing notices. |
| voila_add_cart_itemsA | Add product quantity deltas to the active cart using Voila product UUIDs. |
| voila_remove_cart_itemsA | Remove product quantity deltas from the active cart using Voila product UUIDs. |
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 13 tools
Each tool targets a distinct operation: cart management, session health, shopping context, product discovery (by category, search, discounts), slot operations, and order history. No two tools overlap in purpose.
All tool names follow the consistent pattern 'voila_verb_noun' in snake_case (e.g., voila_add_cart_items, voila_reserve_slot). No mixing of conventions or vague verbs.
With 13 tools, the set is well-scoped for a grocery ordering assistant. It covers core operations without being overwhelming or sparse.
The tool surface covers product discovery, cart operations, slot reservation, and order history. A minor gap is the lack of a category listing tool, but the domain is otherwise well-covered.