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

# Subtotal: For Shoppers

> Connect AI assistants like Claude and Muse to your own purchases and linked retail accounts.

## Overview

Subtotal: For Shoppers connects a shopper's AI assistant to their own Subtotal data. Once it's connected, shoppers can ask about their purchases, link more retail accounts, and choose which brands keep receiving their purchases, in plain language.

The assistant sees the same accounts and purchases the shopper sees in the [Subtotal App](https://docs.subtotal.com/docs/app/introduction.md). It never sees retailer passwords and can't place orders.

> [!NOTE]
>
> If you're a brand looking to query your team's purchase data, use [Subtotal: For Brands](https://docs.subtotal.com/docs/connector/introduction.md) instead.

## How it works

Subtotal: For Shoppers is built on the [Model Context Protocol](https://modelcontextprotocol.io/) (MCP). Any assistant that supports custom MCP connectors can use it with this server URL:

```
https://consumer-api.subtotal.com/mcp
```

Step-by-step setup is available for [Claude](https://docs.subtotal.com/docs/connector/shoppers/claude.md). For other assistants, add a custom connector in that assistant's settings using the URL above.

## Sign in

Subtotal: For Shoppers uses OAuth. When you connect, a Subtotal sign-in window opens with two options:

* **With your email:** full access. A new email creates a Subtotal account. Use the email you gave when linking an account on a brand's site, so those accounts show up too.
* **With your store:** pick a retailer and sign in to it through [Subtotal Link](https://docs.subtotal.com/docs/subtotal-link/introduction.md). Access is read-only and limited to that one retail account.

If you don't use the connector for 30 days, you'll be asked to sign in again.

## What the assistant can see

* **Accounts you linked yourself:** your full purchase history, with items.
* **Accounts a brand linked under your email:** only the purchases that brand received.

Items marked sensitive are never included.

## Tools

| Tool | What it does |
| :- | :- |
| `list_retailers` | Lists the retailers you can link |
| `link_retailer_account` | Creates a secure link for you to sign in to a retailer, or to sign an expired account back in. The link expires after 30 minutes |
| `list_accounts` | Lists your retail accounts, their status, and the brands that receive purchases from each |
| `get_purchases` | Returns your purchases with items, newest first, filtered by date, retailer, category, account, or brand |
| `disconnect_account` | Disconnects a retail account you linked. Brands keep receiving its purchases until you stop sharing with each |
| `disconnect_brand_access` | Stops a brand from receiving new purchases from one of your accounts. Purchases it already received don't change |

Neither disconnect can be undone from the assistant. With store sign-in, the assistant can read your purchases but can't link accounts or disconnect anything.

## Privacy and support

* **Privacy policy:** [legal.subtotal.com/legal/end-users/privacy-policy](https://legal.subtotal.com/legal/end-users/privacy-policy)
* **Support:** email [support@subtotal.com](mailto:support@subtotal.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.