Tools reference
The complete surface. Every tool is read-only and free to call. What each one is for is in the tool guide.
All tools
| Tool | Parameters | Answers |
|---|---|---|
get_setup_health | — | Is the drawer switched on and working? |
get_drawer_settings | — | Which features are on? |
get_analytics | start? end? | Revenue, orders, AOV, top upsell products |
get_all_templates | — | Which templates exist, and which is live? |
get_translations | template? locale? | What wording does the drawer show? |
get_plan_status | — | Subscription and drawer-attributed orders |
Parameters marked ? are optional. None of these tools has a required parameter.
The same data over REST
Cart Drawer serves this data on two surfaces that share one set of handlers. Whatever a tool returns, its matching endpoint returns.
| Tool | REST endpoint |
|---|---|
get_setup_health | GET /setup-health |
get_drawer_settings | GET /drawer-settings |
get_analytics | GET /analytics |
get_all_templates | GET /templates |
get_translations | GET /translations |
get_plan_status | GET /plan |
The Store API lives at /store-api/v1, takes its own key beginning aov_sk_,
and is meant for scripts rather than AI clients. Keys are not interchangeable between the two.
Limits
| Requests | 60 per minute, per connection |
| Result size | 16,000 characters per call |
A result that hits the size limit is cut off with a note saying so. That note is real information: an
assistant that ignores it will summarise a partial answer as though it were complete. On this app the
one payload that regularly overflows is get_translations on a multi-language store — ask for a
single locale and it fits.
What is deliberately absent
- No write tools. Not restricted — not implemented. Nothing an assistant calls can change a template, a setting, or a subscription.
- No customer data. No names, emails, addresses, or individual orders.
- No internal identifiers. The store's record id and access token never leave the server.
- No pricing.
get_plan_statusreports your store's subscription and usage, never a price list.