> ## 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 only (SQL is rejected) |

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