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.
`get_swap_options`	Read	What each product on a subscription can be swapped to, products of the same type only.
`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.
`swap_subscription_product`	Write	Swap a product for another of the same type. A box swap suggests contents to confirm first.
`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.
`list_billing_issues`	Read	Orders on hold because of stock or inventory location problems.
`retry_billing_issue`	Write	Charge a held order again once the stock problem is fixed. Confirms first.

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.
`get_customer_credit`	Read	A customer’s store credit balance and credit ledger, with who changed it and why.
`adjust_customer_credit`	Write	Add or remove store credit with a reason and an optional note. Confirms first.

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_boost`	Read	Whether a sent campaign can be boosted, and how many non-openers and non-clickers it would reach.
`boost_campaign`	Write	Campaign Booster: resend to the people who didn’t open or didn’t click, up to 72 hours after the original.
`plan_campaign_boost`	Write	Plan a booster on a campaign that hasn’t finished sending; it’s created when the send finishes.
`get_campaign_stats`	Read	Sends, opens, clicks, unsubscribes and revenue for a campaign.
`get_campaign_links`	Read	Every link clicked in an email campaign, with clicks and unique clickers.
`get_deliverability`	Read	Delivery, bounce, complaint and deferral rates by mailbox provider and domain, for the store or one 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, in each recipient’s local time, or at their best hour.
`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.
`draft_segment`	Read	Propose a segment’s rules from a plain description, with how many people match. Saves nothing.
`create_segment`	Write	Save a new segment from a name and conditions.
`list_message_sends`	Read	Individual email and SMS sends. For one campaign: who opened, didn’t open, clicked or clicked a link, with their opens and clicks.

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, optionally as a real customer.
`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.