Tool catalog
What your AI assistant can do with VYG, including which tools make changes.
These are the tools your AI assistant gets when it connects to https://api.vyg.app/mcp. Your assistant
picks the right tool for your question, so you do not need to name tools yourself. This page is for
checking what is possible and what each tool touches.
How to read the table:
- Reads or changes. "Reads only" tools never change anything. "Makes changes" tools create or edit something in your account, such as a draft campaign or a discount rule; your assistant should ask you before it runs one.
- Who can call it. "Sign-in only" tools work when a person signs in with their VYG account. They do not work with an API key. See Authentication.
- REST. The same operation in the REST API, when there is one.
Four email tools are on api.vyg.app for brands with the beta:email-channel feature
(Beta features): klaviyo_import brings Klaviyo flows and templates over as drafts,
email_templates creates new drafts and reviews and approves them, email_broadcasts reads broadcasts and AI drafts,
and manage_email_broadcast schedules, changes, pauses, resumes and cancels broadcasts and adds variants. All four are
sign-in only. See Move from Klaviyo and Email broadcasts.
The other email channel tools are served to LiveRecover operators on
https://agents-mcp.vyg.app/mcp, not on api.vyg.app; see Email tools. Old tool names and their current names are in the
migration guide.
The klaviyo tool works in your own Klaviyo account through the Klaviyo connection saved in Settings, Integrations.
Your assistant can look up profiles, lists, segments, flows, campaigns, templates and Klaviyo reports, and, with your
approval, create or change lists, segments, flows, campaigns and templates. It never asks for or shows your Klaviyo
API key. New flows are created as drafts and new campaigns are not sent; turning a flow on, sending a campaign or
subscribing people only happens when you ask for it. Reading needs integrations:read and changes need
integrations:write and a sign-in with your own VYG login; a brand API key can read but not change Klaviyo data.
Your Klaviyo key must include the scopes for what you ask (for example segments:write to
create a segment).
Brand
The brand the credential belongs to: name, plan, connected apps and support contacts.
| Tool | What it does | Reads or changes | Who can call it | REST |
|---|---|---|---|---|
get_brand | Brand profile. View your business details, website, plan, connected apps and support contacts. | Reads only | Sign-in or API key | GET /v1/brand |
Conversations
Customer conversations and their messages, conversation search, AI-generated conversation insights, and contacts.
| Tool | What it does | Reads or changes | Who can call it | REST |
|---|---|---|---|---|
conversations | Conversations. Read the brand's customer text conversations. | Reads only | Sign-in or API key | MCP only |
get_checkout_purchase_likelihood | Checkout purchase likelihood. Read the cart and per-product purchase likelihood for a checkout of the calling brand. | Reads only | Sign-in or API key | GET /v1/checkouts/{checkout_id}/purchase-likelihood |
Customers
Customer profiles, lookup, activity timelines, a customer's orders and subscriptions, and the customer field catalog.
| Tool | What it does | Reads or changes | Who can call it | REST |
|---|---|---|---|---|
customers | Customers. Read the brand's customers. | Reads only | Sign-in or API key | MCP only |
Segments
Saved customer segments: rules, size estimates, members and join/leave history.
Insights
Brand-wide lifetime value, RFM tiers, top products and customers at risk of churning.
| Tool | What it does | Reads or changes | Who can call it | REST |
|---|---|---|---|---|
stats | Stats. Read the brand's dashboard numbers for one period: customer insights, Cockpit metrics and funnel, product performance, LiveRecover SMS recovery numbers (recovered revenue and orders, and the Telegram line for brands with Telegram), LiveRecover campaign performance, and the product list. | Reads only | Sign-in or API key | MCP only |
reports | Reports. Read the brand's reports (the Reports section of the vyg.ai app). | Reads only | Sign-in or API key | MCP only |
manage_report | Create or change a report. Create and change the brand's custom reports. | Makes changes | Sign-in or API key | MCP only |
manage_funnel | Edit the Cockpit funnel. Read or change the steps of the brand's Cockpit conversion funnel. | Makes changes | Sign-in or API key | MCP only |
cdp_insights_propensity | Purchase propensity insights. Read purchase propensity band counts for the authenticated brand, expected buyers for 30 and 90 days, and model readiness. | Reads only | Sign-in or API key | MCP only |
get_website_breakdown | Website traffic breakdown. See website traffic from the VYG web pixel for a date range: page views, unique visitors and conversions grouped by page, landing page, traffic source (UTM source, medium, campaign, referrer), event, page variant or a custom event property. | Reads only | Sign-in or API key | POST /v1/website/breakdown |
Campaigns
Campaigns, message variants, campaign building options and performance stats.
Discounts
Reusable discount rules in the brand's discount library.
| Tool | What it does | Reads or changes | Who can call it | REST |
|---|---|---|---|---|
create_discount | Create a discount. Create a percentage, fixed-amount or free-shipping discount. | Makes changes | Sign-in only | POST /v1/discounts |
update_discount | Update a discount. Edit a discount’s value, duration, name, code prefix or minimum purchase. | Makes changes | Sign-in only | PATCH /v1/discounts/{discount_rule_id} |
Integrations
Connected apps, event types, and custom integration providers and their event definitions.
List building
Add subscribers to a live SMS sign-up campaign from your own site or app.
Onboarding
Sign up for LiveRecover from an AI agent with no account. Served on the public MCP start endpoint.
Help and documentation
What this connection can do, and the VYG documentation behind each tool.