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 or product.
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.
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.
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.
list_activity_logs	Read	The history of what happened to a customer or subscription.

Marketing

Tool	Type	What it does
list_campaigns	Read	Campaigns by 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.
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.

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.

Account

Tool	Type	What it does
get_account	Read	Your store’s setup, settings and plan.

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.