用途:通过已安装的 klaviyo CLI 读取和管理用户的 Klaviyo 邮件与短信营销活动、简报、流程(flows)、订阅者列表和受众分群。连接请求可访问受支持的完整目录。写入、发送和删除操作需要 Hatch 审批。
主要能力:设置将目录分为八类能力——读取、营销内容、活动投递、流程、受众与订阅、目录与优惠券、跟踪与集成、删除。内容编辑不授予发送活动或删除数据的权限。每次审批仍会预览具体操作与输入;创建活动及编辑活动/消息时会展示提交的受众、发件人、主题和消息(如存在)。
使用方式:运行 klaviyo list-tools 获取精简要审阅工具目录;运行 klaviyo list-tools --name <tool-name> 查看某个受审阅工具的实时输入 schema(提供方输出 schema 有意省略)。不要猜测工具名或参数 schema。若 klaviyo status 报告 auth_status: not_connected,运行 klaviyo authorize-url 并只分享返回的 connect_url。Klaviyo 要求 Owner、Admin 或 Manager 角色。不要在聊天中构造 OAuth URL 或请求令牌。可用命令示例:klaviyo call-tool --help、klaviyo status、klaviyo list-tools [--name <tool-name>]、klaviyo call-tool --name <tool-name> --arguments-json '<JSON object>'、klaviyo account-details、klaviyo list-campaigns --channel <email|sms|mobile-push> [--page-cursor <cursor>]、klaviyo list-flows [--page-cursor <cursor>] [--page-size <1-100>]、klaviyo list-metrics [--page-cursor <cursor>]。
限制与注意事项:目录涵盖稳定的远程活动、流程、受众、订阅、模板、图像、目录、事件、指标、报告、优惠券、标签、webhook、表单、评论、推送令牌和个人资料删除工具;测试版和仅本地工具被排除。Klaviyo 的 MCP 支持发送活动,Hatch 的显式允许列表控制此处可调用的工具。发送与取消共用活动投递权限,与内容编辑分离;成功请求会启动异步任务,需检查 get_campaign_send_job 和 get_campaign 再报告结果。取消无法撤回已送达邮件。创建的草稿不会自动发送。流程 create_flow 使用编码的流程定义并保留返回的 ID;update_flow 会同时更改流程状态及其所有操作,变更前后应读取 get_flow、get_flow_action 和 get_flow_message。列表成员关系不授予或撤销营销同意,需使用订阅工具。批量更改、合并与删除需确认目标集与后果,个人资料删除不可逆。assign_template_to_campaign_message 返回新的消息所属模板副本,其 ID 与源不同,不要因此重试,可用 get_campaign(include=campaign-messages)验证。