All 16 tools

When you create a token you choose which of these it may use: Read only (the nine read tools), Read and change (all sixteen), or Pick tools. A token can never use a tool it wasn’t given — the app re-checks on every call. Every tool also needs a plan that includes AI MCP Integration, checked on every call.

Read tools

Safe to grant broadly. None of these change anything in your store or your app.

Tool	What it does	Notes & limits
`get_shop_overview`	Store details and time zone, wallet balance, whether custom SMTP is on, current plan and status, days until the allowance resets, active channels, quotas and the restock rule.	Takes no input. The usual first call.
`get_analytics`	One of ten reports — see Which analytics report do I want?	Date range (last 30 days by default), paging up to 100 rows a page, a channel filter (email, web push, SMS, WhatsApp or all), filter and search. The products report can be grouped by product or variant. Five reports can render as a widget.
`get_entity_details`	One product, variant or customer.	Product: analytics per variant. Variant: its sign-ups, up to 100. Customer: the customer report — and when you ask by email, each sign-up, form answers, unsubscribes and whether email is blocked. Optional date range.
`get_settings`	One section of your configuration: channels, reports, security, templates, SMTP, or activation requests.	Your SMTP password is never returned.
`shopify_product_lookup`	Live lookup against Shopify: finds variants by a search term and, if asked, reads inventory per location.	Reads Shopify directly, so figures are current. Up to 50 results (10 by default).
`get_usage_and_quota`	This period and when it resets; for each pool, the plan allowance granted, used and remaining and what you spent this cycle; your shared wallet (total, used, available, in USD); and any sends waiting for credit.	Pools are notification, SMS and WhatsApp. Email and web push share the notification pool. There is one shared wallet — no separate SMS or WhatsApp wallet.
`get_billing_overview`	Current plan (name, price, interval, trial), subscription status and next billing date, billing cycle, wallet, included and not-included features and allowances, and your AI connector allowance (included, requests a minute, maximum tokens).	Doesn’t repeat usage numbers — that’s `get_usage_and_quota`.
`get_billing_history`	Past cycles (granted, used, lapsed, plan before and after), individual ledger rows, and wallet top-ups.	Filter by cycle, date range, pool and row type. Paginated.
`compare_plans`	Your current plan, every plan with price, quotas and features, what your current plan is missing, and the cheapest plan that has it.	Ask about up to 40 features at once. The full feature matrix is opt-in — it’s a large answer. Changing plan happens on the app’s Plans page, with Shopify’s approval; there’s no fee to switch.

Tools that change something

Grant these deliberately. Each one works in two steps:

The first call previews the change and changes nothing. It returns a summary, any warnings, and a confirmation ticket — or a refusal with the reason.
The AI shows you the summary. Only after you confirm in the chat does it call again with the ticket and make the change.

The ticket lasts 5 minutes, works once, and is tied to the tool, your store and the exact arguments. See Error codes for what each status means.

Tool	What it does	Notes & limits
`send_test_notification`	Sends a test notification for one variant to one recipient, by email, SMS or web push.	A real send that uses your allowance or wallet. Email goes only to your store’s own addresses: staff accounts, report recipients and sign-up alert recipients. Phone numbers must be in international format. At most 20 tests an hour. Refused with no credit left, or for a variant from another store. WhatsApp alerts aren’t being sent yet (the app shows Coming soon), so WhatsApp tests are refused.
`update_store_settings`	Changes one setting: a channel on or off (email, SMS, web push, WhatsApp), the summary, customer or immediate report switch, or the restock rule (`restock_threshold`, the delivery rule under Settings → Delivery rules).	One setting per call. Refused if it’s already set that way, or when turning SMS or WhatsApp on before the channel is approved. The preview warns when you turn a channel off or a paid channel on.
`manage_subscriber`	Unsubscribes a customer, re-sends an alert, or cancels a pending alert.	Unsubscribe needs an email or phone number — a customer id alone is refused — and can’t be undone from the connector. Re-send and cancel need the sign-up. Re-send works for email sign-ups only. Cancel is refused if the alert was already sent or cancelled.
`export_analytics_csv`	Builds the signups, products, notifications, customers or orders report as a CSV and returns a download link.	Up to 1,000 rows. The products report has no date range. Best converting and most wanted can’t be exported here — download them from the app’s Analytics page. The link works for anyone who has it, for 24 hours — treat it like the file.
`request_channel_activation`	Asks for SMS or WhatsApp to be activated.	A request, not an activation — the Notifylyst team reviews it. Refused if the channel is already approved or a request is pending.
`configure_report_settings`	Configures summary and customer reports: on or off, daily or weekly, who receives them (up to 50 emails), and the period they cover (all time, 7, 30 or 90 days, or a custom number of days).	Change one field or several — at least one. The preview shows each change from → to and warns about new recipients.
`configure_immediate_alerts`	Configures immediate alerts: on or off, the maximum per day, and who receives them (up to 50 emails).	Change one field or several — at least one. Same preview as above.

What no token can do: change your plan or billing, top up the wallet, delete data, or edit templates.

Which analytics report do I want?

get_analytics takes a report name. Ten choices, and the naming isn’t always obvious:

Report	Answers
`signups`	Who signed up, and for what.
`products`	The waiting list by product or variant.
`notifications`	What was sent, on which channel.
`customers`	Per-customer view.
`orders`	Orders that followed a restock alert.
`best_converting`	Which products actually convert after being notified.
`most_wanted`	Highest demand right now — the restock shortlist.
`recovery_overview`	The headline recovery numbers for a period.
`dashboard_summary`	The at-a-glance figures from the app’s dashboard.
`recent_activity`	What has happened lately.

You rarely need to name these yourself — asking the question in plain English is enough. The list is here for when you want a specific report and don’t want to negotiate.

Saved prompts & widgets — ready-made questions built on these tools.

Get started

Set up and connect

Usage examples

Trust & help

MCP reference

Read tools

Tools that change something

Which analytics report do I want?

Next

​Read tools

​Tools that change something

​Which analytics report do I want?

​Next

Read tools

Tools that change something

Which analytics report do I want?

Next