MCP tools reference

Once you connect an AI assistant to Gro, it can call the tools below. Tools marked Read only look things up. Tools marked Write change data and need the gro:write permission. Tools marked Confirms first are flagged as destructive, so assistants that respect MCP annotations ask before running them.

Subscriptions

Tool	Type	What it does
list_subscriptions	Read	Search subscriptions by status, customer, phone, entity name or subscription number.
get_subscription	Read	Full detail of one subscription, with a plain summary of next delivery and last order.
get_subscription_reschedule_options	Read	The delivery dates and slots available for a reschedule.
get_subscription_stats	Read	Active, new, churned and lifetime value figures for a date range.
get_subscription_forecast	Read	Upcoming revenue and orders for the next period.
get_churn_reasons	Read	Why customers cancelled, paused or skipped.
get_retention_offers	Read	How cancellation and pause save offers are performing.
get_cohort_retention	Read	Retention by signup week or month.
get_box_selections	Read	What is in each build your own box, and the products each slot can take.
pause_subscription	Write	Pause a subscription. Confirms first.
resume_subscription	Write	Resume a paused subscription.
skip_subscription	Write	Skip the next order forward by one or two weeks.
reschedule_subscription	Write	Move the next delivery or billing date.
change_subscription_frequency	Write	Change how often a subscription bills.
update_box_selection	Write	Change what is in a build your own box, using the box’s own rules.
apply_subscription_discount	Write	Add a discount to a subscription. Confirms first.
reactivate_subscription	Write	Reactivate a cancelled subscription. Confirms first.
cancel_subscription	Write	Cancel a subscription. Confirms first.
generate_portal_link	Write	Create a magic login link for the customer portal.

Customers

Tool	Type	What it does
list_profiles	Read	Find customers by email or name.
get_profile	Read	One customer with their segments and details.
create_profile	Write	Add a customer profile.
update_profile	Write	Edit a customer’s name, email or phone, or opt them out of email. It can never re-subscribe someone.
list_activity_logs	Read	The history of what happened to a customer or subscription.

Marketing

Tool	Type	What it does
list_campaigns	Read	Email and SMS campaigns by channel, status or search.
get_campaign	Read	One campaign with its message counts.
get_campaign_stats	Read	Sends, opens, clicks, unsubscribes and revenue for a campaign.
create_campaign	Write	Create a draft campaign with its template, audience and subject.
list_senders	Read	The verified sending domains a campaign can go out from.
set_campaign_sender	Write	Pick which sending domain a draft campaign goes out from.
send_test_campaign	Write	Email a test copy of a campaign to one address.
schedule_campaign	Write	Schedule a draft campaign to send at a set time.
list_flows	Read	Automation flows.
get_flow	Read	One flow with its steps.
list_segments	Read	Audience segments.
get_segment	Read	One segment with its conditions and member count.
list_message_sends	Read	Individual email and SMS sends, useful for delivery problems.

SMS

Tool	Type	What it does
get_sms_compliance_status	Read	Which countries your store can text, and which are still pending approval.
create_sms_campaign	Write	Draft a text message campaign with its message and audience.
get_sms_stats	Read	How many texts went out in a date range, delivered and failed.

SMS campaigns are scheduled with schedule_campaign, the same as email. A draft is only created once at least one country is approved, and Gro adds the opt out line to every marketing text for you.

Templates and content

Tool	Type	What it does
list_templates	Read	Email templates.
get_template	Read	One template’s block JSON, handy for matching an existing style.
create_template	Write	Build a new email template in the block editor format.
update_template	Write	Change an existing template.
list_products	Read	Products from your store, so product blocks use real items.
search_media	Read	Images in your media library.
preview_email	Read	Show a live preview of a template or email campaign.
open_gro_studio	Read	Open Gro Studio, a visual gallery of your emails.

Gro Studio in ChatGPT

In ChatGPT, Gro shows your emails instead of describing them.

• Live previews. When Gro creates or edits an email, the rendered email appears right in the chat, with desktop and mobile views and how it looks in the inbox.
• Gro Studio. Open it from the ChatGPT sidebar or beside any chat to browse your campaigns and templates, see how sent campaigns performed, and pick an email to work on.
• One tap edits. Each preview has quick asks like a punchier subject line or a product grid. Tap one and Gro gets to work on that exact email.

Previews use sample customer details, so merge tags show a real looking name. Nothing is sent from a preview.

Account

Tool	Type	What it does
get_account	Read	Your store’s setup, settings and plan, and which Gro Shopify apps are connected and what each adds.

Resources

Resources are reference documents the assistant reads to do a better job. They never change anything.

Resource	What it holds
brand-kit	Logos, brand colours, button styles and social links.
email-block-schema	The JSON format for email templates.
metrics	Definitions of the numbers Gro reports.
segments	Your segments and how they are built.
selling-plans	Your subscription selling plans.
sender-configs	The from names and addresses you send email from.

What the assistant sees

The assistant only sees what a tool returns for the store you signed in to. Gro never receives your conversation, and every tool call is logged in your activity log under your name.