# Plans and limits

Your Subbly plan decides what a connected app can do. You do not pick
permissions when you connect: Subbly checks the plan on every call. An
upgrade or a downgrade applies on the next call, and you never need to
connect again.

## What each plan opens

The tools fall into three areas.

| Area | What it covers | Subbly X | Every other plan |
| --- | --- | --- | --- |
| Store setup | Products, variants, plans, bundles, collections, coupons, inventory, metafields, surveys, funnels, options, tags, countries | Yes | Yes |
| Running the business | Customers, addresses, payment methods, pickup info, subscriptions, cancellation reasons, invoices, orders, transactions | Yes | No |
| Webhooks | Webhook endpoints, events and deliveries | Yes | No |

“Every other plan” includes trials. A shop on the Freeze plan reaches no
tools. The [Tools](/developer-resources/subbly-mcp/tools) page lists every
tool under its area.

## Limits by resource

Inside an area, some fields need a plan feature. The current plans are
Subbly, Subbly AI, Max and Subbly for $1/wk. Older shops may still be on a
legacy plan: Lite, Basic, the old Subbly plan or Advanced.

| Resource | Subbly X | Current plans | Legacy plans |
| --- | --- | --- | --- |
| Subscription products | Every tool | Every tool | Lite and Basic cannot make pause optional (`pauseEnabled: 0`). |
| One-time products | Every tool | Every tool | Lite cannot create or publish gift card products. |
| Variants | Every tool | Every tool | Every tool |
| Plans | Every tool | Every tool | Lite cannot set commitment billing (`commitmentBillingCount`). Lite, Basic and the old Subbly plan cannot set a cut-off time (`cutOffTime`). |
| Bundles, bundle items and bundle plans | Every tool | Every tool | Lite and Basic cannot make pause optional. Lite cannot set commitment billing on a bundle plan. |
| Collections | Every tool | Every tool | Every tool |
| Coupons | Every tool | Every tool | Lite can make simple coupons only: no conditions, no `appliesTo` rules, no gifts and no customer rules. |
| Inventory | Every tool | Every tool | Every tool |
| Metafields | Every tool | Every tool | Every tool |
| Tags, surveys, funnels, options, countries | Every tool | Every tool | Every tool |
| Customers, addresses, payment methods, pickup info | Every tool | None | None |
| Subscriptions and subscription items | Every tool, with more than one subscription product on one subscription | None | None |
| Invoices, orders, transactions | Every tool | None | None |
| Cancellation reasons | Every tool | None | None |
| Webhooks | Every tool | None | None |

Only Subbly X can put more than one subscription product on one
subscription, with `create_subscription` or `create_subscription_item`.

## When a tool is outside your plan

A tool in a closed area fails with a message like this one:

```text
This action needs the Subbly X plan. The shop is on the Max plan.
Upgrade at https://www.subbly.co/admin/plans.
```

A field that needs a plan feature fails with a message that names the
feature, for example “The gift cards feature is not available on your
current plan.”

In both cases nothing changes in the shop. The agent reads the message and
can tell you which plan you need.

## Who can connect

- The shop owner, or a user with the admin role. Other roles cannot.
- The shop has an active Subbly subscription.
- You are not signed in to the shop from the Subbly admin as a superadmin.

The app acts for the whole shop within the plan's areas, whoever connected
it. Each person has one connection per app; connecting again replaces the
old one. See [Security and access](/developer-resources/subbly-mcp/security-and-access).

## Rate limits

| Limit | Value |
| --- | --- |
| Private API calls per shop | 300 per minute, shared by every app and integration on the shop |
| Subscription changes | One at a time per shop: pause, resume, skip, cancel, reactivate, switch plan, change plans and item plan or variant changes |
| Webhook delivery retries | 60 per minute per shop |
| MCP server | Its own cap per connection |

A call over a limit fails with `Too Many Attempts.` Wait a minute and try
again. For many changes, ask the agent to work one record at a time.

## Size limits

- **Lists.** A list tool returns up to 100 records per page. The agent
  pages through larger sets. A filter, such as a date range or a status,
  keeps answers short and fast.
- **Batch tools.** One call to `batch_variants` creates up to 100 variants.
  One call to `batch_bundle_items` creates up to 200 bundle items.
- **Lookups.** `list_customers` takes up to 100 IDs or emails per call.

## Sessions

- The app stays signed in by itself. It refreshes its access every hour.
- If you do not use the app for 30 days, it must connect again.
- Disconnecting the app in **Settings › Connected apps** ends its access at
  once.

## Next steps

- [Tools](/developer-resources/subbly-mcp/tools) — every tool, grouped by
  area.
- [Example workflows](/developer-resources/subbly-mcp/example-workflows) —
  tasks for each area.