> ## 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 Data MCP

> Give AI agents read-only access to your purchase data via the Model Context Protocol.

## Overview

The Subtotal Data MCP gives AI agents read-only access to your purchase data through the [Model Context Protocol](https://modelcontextprotocol.io/) (MCP). Connect any MCP-compatible client to query connections, purchases, items, retailers, products, and brands using natural language.

**Use cases:**

* AI shopping assistants that reference real purchase history
* Analytics copilots that answer questions about customer behavior
* Purchase data Q\&A for support and operations teams

## MCP Server URL

All requests use this URL:

```
https://mcp.subtotal.com/mcp
```

## Authentication

The Subtotal Data MCP uses OAuth. Add Subtotal as a [Claude connector](/docs/mcp-server/claude-connector) and authentication is handled automatically — no API keys to manage.

## Security and limits

All queries are scoped to your team — you can only access your own team's data. The following limits apply:

| Constraint         | Limit                                                                                      |
| :----------------- | :----------------------------------------------------------------------------------------- |
| Rate limit         | 60 queries per minute                                                                      |
| Row limit          | 100 results per request                                                                    |
| Response size      | 5 MB max                                                                                   |
| Query timeout      | 5 seconds                                                                                  |
| Allowed operations | SELECT only                                                                                |
| Input format       | Natural language for `ask` (SQL is rejected); `get_retailers` takes an `include` parameter |

<Note>
  For a full reference of available tools, see the [Tools](/docs/mcp-server/tools) page.
</Note>