Skip to main content
mcp.vori.com is in alpha. It’s a new, separate integration point, so it doesn’t yet cover as much as app.vori.com or the Vori mobile app. Expect gaps and rough edges while it matures.
A note on LLM risk. You are connecting a third-party AI assistant to your live store data. LLMs can misinterpret requests, call the wrong tool, or state things confidently that are inaccurate. Review what an assistant is about to do before you rely on its output, especially before taking any action based on it. If you want to be safe, create a user with the Read-only role at the banner level and connect your AI client with that account instead of your own.
Vori runs a grocer-facing Model Context Protocol (MCP) server at mcp.vori.com. Any MCP-compatible AI client — Claude, Cursor, ChatGPT — can connect to it and get authenticated access to your store’s data: products, departments, inventory, invoices, and more. There is no API key to request or app to install — you authenticate with your normal Vori credentials and every tool call is scoped to your permissions, exactly like the web app.

​
How it works

Every request goes through an authenticated HTTPS connection. Authentication validates your credential (any credential type Vori already accepts — Firebase, Google, or Vori-managed), and authorization then checks the permission declared on the tool you’re calling against your account, so retail users only ever see their own banner’s data.

​
Connect your AI client

The server speaks the MCP Streamable HTTP transport at:
Opens Vori’s listing in Claude’s connector directory. Connect from there, then sign in with your Vori credentials.

​
Video walkthroughs

Connecting Vori MCP to ChatGPT:

​
Schedule and send reports

Once connected, you can put your AI client to work on recurring tasks. This walkthrough uses Vori MCP with Claude Cowork to schedule and send a report:
The same approach works for scheduled delivery of any data Vori MCP can access — send it to email, SFTP, an API, or wherever else your workflow needs it.

​
Troubleshooting

If the client shows a generic “Unauthorized” error, double check the endpoint URL matches exactly (including scheme) — a mismatch causes token validation to fail silently.
  • No tools showing up after connecting — restart your AI client; some clients only pick up a server’s tool list on startup or reconnect.
  • Repeated login prompts — reconnect the server in your client’s settings to refresh the session.

​
Available tools

Tools are grouped by domain. Every tool enforces the same permissions you’d see in the Vori dashboard: a tool that creates, updates or deletes something works only for an account whose role allows that action, and an account with the Read-only role can call the read tools alone.
  • cube_meta: returns the semantic model (cubes, measures, dimensions) available for querying; call this first
  • cube_query: run a structured analytics query, scoped to your banner and stores
  • list_departments: list departments in a store, filterable by name
  • get_department_by_id: retrieve a single department by ID
  • create_department: create a department, optionally as a sub-department
  • update_department: update a department, including deactivating or reactivating it
  • list_discounts: list discounts for the banner, filterable by name
  • get_discount_by_id: retrieve a discount by ID
  • get_esl_store_health: summarize a store’s electronic shelf labels: online and offline counts, pairing, and low batteries
  • get_esl_status_for_product: diagnose why a product’s label is missing, stale or showing ”?”
  • get_esl_label: look up one label by the code printed on the device
  • list_employees: list employees, paginated; PINs and other credentials are never returned
  • get_employee_by_id: retrieve an employee by ID
  • list_food_modifier_categories: list a store’s modifier categories with their modifiers and selection rules
  • get_food_modifiers_for_product: the modifiers assigned to a product, grouped by category
  • analyze_food_modifier_setup: audit a store’s modifier setup for gaps
  • create_food_modifier_category, update_food_modifier_category, delete_food_modifier_category: manage categories
  • create_food_modifier, update_food_modifier, delete_food_modifier: manage the modifiers inside a category
  • docs_search: search the Vori help center (help.vori.com)
  • docs_fetch: fetch the full content of a help article by the slug returned from docs_search
  • get_product_inventory: the current on-hand quantity for a product
  • count_out_of_stock_products: count products with tracked inventory at or below zero, with a small sample of matching products
  • list_invoices: list vendor invoices, filterable by store, vendor, invoice number or processing status; use the READY status to find invoices waiting for cost-change review
  • get_invoice_by_id: retrieve an invoice’s header, processing status and line items
  • get_invoice_raw_extracted_values: the raw extracted line values on an invoice’s active revision, before any Extraction Rule runs
  • get_invoice_standardized_line_items: the standardized line items after Extraction Rules and reconciliation have run
  • translate_extracted_field_names: map raw extracted field keys to the labels you see in the Back Office
  • list_invoice_review_lines: list an invoice’s cost-change review lines, including their status, diagnosis, product matches, costs, prices and commit impact
  • update_invoice_review_line: match a review line to a product, skip its cost or inventory change, or correct invoice values
  • reset_invoice_review_line: discard edits to a review line and restore the reconciled result
  • ignore_invoice_lines_forever, undo_ignore_invoice_lines_forever: permanently ignore non-product charges such as deposits, freight or fees, or restore them to review
  • set_invoice_line_retail_price: stage a new shelf price for the product matched to a review line
  • preview_invoice_commit: preview the catalog and inventory changes that applying selected invoice lines would make, without writing them
  • commit_invoice_changes: apply reviewed cost and price changes to the catalog; preview the same lines first and leave ambiguous lines for a person
Invoice-review tools enforce your invoice permissions for the invoice’s store. Read tools, including the commit preview, require Read permission; edits and applying changes require Update permission.For the review workflow, tool inputs and responses, and limits, see Review invoices with Vori MCP.
  • list_invoice_templates: list the extraction templates configured across your stores and vendors
  • get_invoice_template: the composed list of steps for one template
  • create_invoice_template_for_store_vendor: create a template for a store and vendor pair
  • upsert_invoice_template_step_override: insert or replace a single step override on a template
  • preview_extraction_rule_change: dry-run a rule change against a real invoice before you save it
  • promote_new_invoice_candidate: re-run a template on an invoice and promote the result as a new candidate
  • list_item_modifiers: list a store’s item modifiers (per-store charges such as bottle deposits), filterable by name
  • get_item_modifier_by_id: retrieve an item modifier by ID
  • list_lanes: list checkout lanes, filterable by store or by whether the lane is virtual (one that only attributes orders and has no physical terminal); both kinds are returned by default
  • get_lane_by_id: retrieve a lane with its devices, order ID prefix and virtual flag
  • list_products: list products, filterable by store, department or barcode
  • search_products: search products by name or barcode across one or more stores
  • get_product_by_id: retrieve a product by ID
  • lookup_master_catalog_barcode: find a product’s canonical barcode in the shared Vori catalog
  • create_product: create a product
  • update_product: update an existing product
  • list_promotions: list promotions with their dates, recurrence, status and offer count; call get_promotion for offer IDs
  • get_promotion: retrieve a promotion by ID, including each offer’s ID and deal type
  • get_offer: retrieve an offer by its offer ID, not its promotion ID
  • list_offer_products: list the products in an offer’s deal using an offer ID from get_promotion
  • create_offer: create an offer and attach it to a new or existing promotion
  • update_offer: update an offer’s fields (the offer type cannot change)
  • add_products_to_offer, remove_products_from_offer: change which products an offer covers
  • remove_offer_from_promotion: detach an offer from its promotion
  • update_promotion: change a promotion’s name, date range or recurrence
  • publish_promotion, unpublish_promotion: take a promotion live, or return it to draft
  • cancel_promotion: cancel an active promotion; this cannot be undone
  • clone_promotion: copy a promotion with its offers, conditions and ranges
  • delete_promotion: delete a draft or pending promotion
  • list_store_vendors: the vendors a store can order from
  • list_orderable_vendor_products: what a store can order from one vendor
  • list_purchase_orders: list purchase orders, filterable by store, vendor, status, or whether Vori recommended them
  • get_purchase_order_by_id: retrieve one purchase order with its line items
  • get_purchase_order_status_history: the status changes recorded for a purchase order
  • create_purchase_order_draft: start a draft order for a store and vendor
  • add_purchase_order_line_items, update_purchase_order_line_item, remove_purchase_order_line_items: edit the lines on a draft
  • delete_purchase_order_draft: delete a draft and its lines
  • get_store_vendor_by_id, create_store_vendor, update_store_vendor: view and maintain a store vendor’s contact and ordering settings
  • list_store_vendor_products_for_maintenance: every vendor product for a store vendor, including unlinked items
  • get_store_vendor_product_by_id, create_store_vendor_product, update_store_vendor_product: view and maintain a vendor product’s pack, cost and ordering settings
The purchase order tools work on draft orders only. Submitting an order to the vendor still happens in the Back Office or the Vori mobile app.
  • list_product_rules: list the rules and groups for a store
  • get_product_rule: retrieve a rule or group with its conditions and values
  • get_rules_for_product: which rules and groups affect a product, and which one wins
  • preview_product_rule: preview how many products a rule would touch before you create or change it
  • analyze_product_rules_setup: audit a store’s rules and groups for gaps and conflicts
  • create_product_rule, update_product_rule, delete_product_rule: manage condition-based rules
  • set_product_rule_status: activate or deactivate a rule or group
  • create_product_group, update_product_group: manage groups of linked products
  • exclude_product_from_rule: exempt one product from a rule
  • list_stores: list the stores you can access, paginated
  • get_store_by_id: retrieve a store by ID; payment credentials are never returned
  • update_store: update a store’s settings; fields you leave out stay unchanged
  • list_tags_to_print: the queue of paper tags waiting to print for a store, filterable
  • mark_tags_printed: mark tags as printed by ID or by the same filters
  • list_tag_templates: list your tag templates (price tag designs)
  • get_tag_template: retrieve one template with its canvas and label stock
  • list_label_stocks: the label stock catalog (sheet profiles and products)
  • list_tag_template_assets: your reusable artwork assets
  • get_dynamic_tag_fields_for_template_type: the placeholder fields a template type can use
  • create_tag_template, update_tag_template, duplicate_tag_template, delete_tag_template: manage templates
  • save_tag_template_asset: save an image as a reusable asset
  • inspect_paper_artwork, find_label_stock_die, create_label_stock_paper, view_label_stock_artwork: match artwork you attach in chat to a label die and create a custom paper from it
  • list_transactions: list completed transactions for a store, filterable by lane, employee, date range or shopper-facing ID; for a printed receipt number, set storeId and shopperFacingId, then use the returned id
  • get_transaction_by_id: retrieve a checkout transaction by its internal UUID returned by list_transactions, including line items, payments and linked refunds

​
Data and privacy

Your AI client sends Vori only the tool calls it makes, never the rest of your conversation. Vori records each tool call for security and support. See the Vori privacy policy.

​
Questions or issues?

Reach out through your normal Vori support channel.