> ## Documentation Index
> Fetch the complete documentation index at: https://help.vori.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect to Vori MCP (mcp.vori.com)

> Connect any MCP-compatible AI client to mcp.vori.com for authenticated access to your store's data.

<Warning>
  `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](http://app.vori.com) or the Vori mobile app. Expect gaps and rough edges while it matures.
</Warning>

<Note>
  **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.
</Note>

Vori runs a grocer-facing [Model Context Protocol (MCP)](https://modelcontextprotocol.io) 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:

```
https://mcp.vori.com
```

<Tabs>
  <Tab title="Claude.ai">
    <Steps>
      <Step title="Open connector settings">
        Go to **Settings → Connectors**.
      </Step>

      <Step title="Add a custom connector">
        Click **Add custom connector** at the bottom of the Connectors section.
      </Step>

      <Step title="Name and point it at Vori">
        Set the name to `Vori`, and the URL to `https://mcp.vori.com`.
      </Step>

      <Step title="Connect">
        Click **Add**, then **Connect** — a browser window opens for you to sign in with your Vori credentials.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Cursor">
    Add to `~/.cursor/mcp.json` (user-level) or `.cursor/mcp.json` in a specific project:

    ```json theme={null}
    {
      "mcpServers": {
        "vori": {
          "type": "http",
          "url": "https://mcp.vori.com"
        }
      }
    }
    ```

    Restart Cursor after saving, then authenticate when prompted.
  </Tab>

  <Tab title="ChatGPT">
    `mcp.vori.com` is built to work with any MCP-compatible client, ChatGPT included — add it as a connector using the same `https://mcp.vori.com` endpoint and sign in with your Vori credentials when prompted.
  </Tab>
</Tabs>

## Troubleshooting

<Warning>
  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.
</Warning>

* **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.

<AccordionGroup>
  <Accordion title="Analytics">
    * `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
  </Accordion>

  <Accordion title="Departments">
    * `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
  </Accordion>

  <Accordion title="Food modifiers">
    * `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
  </Accordion>

  <Accordion title="Help docs">
    * `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](http://help.vori.com))
  </Accordion>

  <Accordion title="Inventory">
    * `get_product_inventory` — retrieve the current on-hand inventory quantity for a product
  </Accordion>

  <Accordion title="Invoices">
    * `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
  </Accordion>

  <Accordion title="Products">
    * `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
  </Accordion>
</AccordionGroup>

## Questions or issues?

Reach out through your normal Vori support channel.


## Related topics

- [Connect to the Vori REST API](/apis-and-ai-tools/connect-to-the-vori-rest-api.md)
- [Troubleshoot Network Connectivity Issues with the POS](/hardware-and-peripherals/cashier-screen-and-shopper-display/troubleshoot-network-connectivity-issues-with-the-pos.md)
- [How to fix a POS receipt printer that's not printing](/hardware-and-peripherals/receipt-printer-and-supplies/how-to-fix-a-pos-receipt-printer-thats-not-printing.md)