Official description7 sourcesMCP servers8d ago
dearlordylord/voila-sdk
Personal Voila groce
View on GitHub ↗Direct link · no redirect page
Config template (adjust for your client)
claude mcp add voila-sdk -- npx -y voila-sdk
A pasteable skeleton generated from the repository name. Check the project README for the exact package and arguments.
- Star count
- 0 ★ · dearlordylord/voila-sdk · read from the GitHub search API · (checked 2026-10-16 20:00:20)
- Source
- collected from the punkpeye/awesome-mcp-servers list · type: MCP server
- Harvest history
- first seen 2026-10-09 · last seen 2026-10-16 · seen 32× · listed by 7 sources
- Score
- score 703 · 7 sources · mcp
FAQ (answers come from our records)
How do I install it?
We did not find an install command for this repository (our install coverage is only about 4%). Check its README or releases page.
Who is it for?
We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
dearlordylord/voila-sdk；first catalogued 2026-10-09；last seen 2026-10-16。There is no official certification or quality rating here — we record sources and dates only.Third-party quality signals
Voila MCP
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
**Voila MCP** is a Model Context Protocol server for safe personal Voila grocery automation. It exposes small, auditable tools for product search, category browsing, discounts, delivery slots, cart deltas, and completed order history without exposing checkout or order placement.
Published on npm as @firfi/voila-mcp. The repository also includes @firfi/voila-sdk and @firfi/voila-cli.
Packages
- packages/voila-sdk: @firfi/voila-sdk, the TypeScript SDK for Voila sessions, search, categories, cart, order history, slots, and checkout-readiness helpers.
- packages/voila-mcp: @firfi/voila-mcp, a stdio MCP server exposing small auditable tools.
- packages/voila-cli: @firfi/voila-cli, a user CLI that reuses the MCP operation registry.
The root package is private. Publishable packages live under packages/.
MCP Setup
Voila does not publish a documented third-party customer API. This server uses the same same-origin JSON endpoints as the web app, so authenticated use is session-based. Capture a session interactively with the CLI; do not store a Voila password in MCP config.
If the session is missing, expired, or guest-only, tool results include authGuidance with the exact CLI login command to run. The MCP server itself does not launch a browser. A login performed while the server is running takes effect on its next tool call, without a restart.
With an explicit VOILA_AUTH_SESSION_PATH and guest mode off, the MCP server
also runs a read-only authenticated-session keepalive. Set VOILA_KEEPALIVE=0
to disable it; VOILA_KEEPALIVE_INTERVAL_SECONDS defaults to 86400 seconds
and must be at least 3600. The keepalive never bootstraps a guest and stops
as misconfigured if its configured session snapshot disappears.
Tools
- voila_check_session_health: report active, guest, expired, or retryable session state.
- voila_get_active_shopping_context: read current region, destination, delivery method, and cart context.
- voila_get_slot_listings: list delivery slots for an explicit destination and region.
- voila_reserve_slot: reserve a caller-selected slot only with explicit confirmation flags.
- voila_search_products: search products for the current session context.
- voila_get_category_products: fetch products for a Voila category id.
- voila_get_discounted_products: scan promotions and return meaningful discounted products.
- voila_get_completed_orders: read completed orders with cursor pagination.
- voila_get_order_details: read item-level details for one completed order.
- voila_get_completed_order_items: aggregate previously ordered items across completed orders.
- voila_get_cart: read active cart totals, limited items, unavailable data, and pricing notices.
- voila_add_cart_items: add quantity deltas using Voila product UUIDs.
- voila_remove_cart_items: remove quantity deltas using Voila product UUIDs.
Published on npm as @firfi/voila-mcp. The repository also includes @firfi/voila-sdk and @firfi/voila-cli.
Packages
- packages/voila-sdk: @firfi/voila-sdk, the TypeScript SDK for Voila sessions, search, categories, cart, order history, slots, and checkout-readiness helpers.
- packages/voila-mcp: @firfi/voila-mcp, a stdio MCP server exposing small auditable tools.
- packages/voila-cli: @firfi/voila-cli, a user CLI that reuses the MCP operation registry.
The root package is private. Publishable packages live under packages/.
MCP Setup
Voila does not publish a documented third-party customer API. This server uses the same same-origin JSON endpoints as the web app, so authenticated use is session-based. Capture a session interactively with the CLI; do not store a Voila password in MCP config.
If the session is missing, expired, or guest-only, tool results include authGuidance with the exact CLI login command to run. The MCP server itself does not launch a browser. A login performed while the server is running takes effect on its next tool call, without a restart.
With an explicit VOILA_AUTH_SESSION_PATH and guest mode off, the MCP server
also runs a read-only authenticated-session keepalive. Set VOILA_KEEPALIVE=0
to disable it; VOILA_KEEPALIVE_INTERVAL_SECONDS defaults to 86400 seconds
and must be at least 3600. The keepalive never bootstraps a guest and stops
as misconfigured if its configured session snapshot disappears.
Tools
- voila_check_session_health: report active, guest, expired, or retryable session state.
- voila_get_active_shopping_context: read current region, destination, delivery method, and cart context.
- voila_get_slot_listings: list delivery slots for an explicit destination and region.
- voila_reserve_slot: reserve a caller-selected slot only with explicit confirmation flags.
- voila_search_products: search products for the current session context.
- voila_get_category_products: fetch products for a Voila category id.
- voila_get_discounted_products: scan promotions and return meaningful discounted products.
- voila_get_completed_orders: read completed orders with cursor pagination.
- voila_get_order_details: read item-level details for one completed order.
- voila_get_completed_order_items: aggregate previously ordered items across completed orders.
- voila_get_cart: read active cart totals, limited items, unavailable data, and pricing notices.
- voila_add_cart_items: add quantity deltas using Voila product UUIDs.
- voila_remove_cart_items: remove quantity deltas using Voila product UUIDs.
- Source
- awesome · https://github.com/dearlordylord/voila-sdk
- Browse by field
- MCP servers
- added
- yesterday
More in MCP servers
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.