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:
1

Open connector settings

Go to Settings → Connectors.
2

Add a custom connector

Click Add custom connector at the bottom of the Connectors section.
3

Name and point it at Vori

Set the name to Vori, and the URL to https://mcp.vori.com.
4

Connect

Click Add, then Connect — a browser window opens for you to sign in with your Vori credentials.

​
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.
  • cube_meta — returns the semantic model (cubes, measures, dimensions) available for querying; call this first
  • cube_query — execute a structured analytics query, scoped to your banner/stores
  • create_department — create a new department (optionally a sub-department)
  • get_department_by_id — retrieve a single department by ID
  • list_departments — list departments in a store, filterable by name
  • update_department — update a department, including deactivating or reactivating it
  • list_food_modifier_categories and related tools to create, update, and delete modifier categories and their modifiers, look up modifiers assigned to a product, and analyze a store’s modifier setup for gaps
  • docs_fetch — fetch the full content of a help doc by slug returned from docs_search
  • docs_search — search the Vori help-center docs (help.vori.com)
  • get_product_inventory — retrieve the current on-hand inventory quantity for a product
  • get_invoice_raw_extracted_values — the raw extracted line values on an invoice’s active revision, before any Extraction Rule transformations
  • get_invoice_standardized_line_items — the standardized line items after Extraction Rules and reconciliation have run
  • create_product — create a new retail product
  • get_product_by_id — retrieve a retail product by ID
  • list_products — list products, filterable by store, department, or barcode
  • search_products — search products by name or barcode across one or more stores
  • update_product — update an existing retail product

​
Questions or issues?

Reach out through your normal Vori support channel.

Related topics

Connect to the Vori REST APITroubleshoot Network Connectivity Issues with the POSHow to fix a POS receipt printer that's not printing