tools/list 发现下方的全部工具，然后通过 tools/call 调用每个工具。服务器同时支持当前的 MCP 修订版（2026-07-28，客户端以 server/discover 开始）和更早的修订版（客户端以 initialize 开始），并以 scanova-mcp 标识自身。全部 82 个工具都作用于您自己的 Scanova 账户，并使用您的客户端所认证的凭据 —— 参见 Setup。
每个工具的类型对应它的 MCP 注解：只读工具只读取数据，写入工具会新增或修改内容，但不会移除任何东西，破坏性工具则可能删除、覆盖或关闭正在生效的内容 —— 包括更改已印刷二维码所展示的内容。下方的分组是我们为便于浏览而整理的 —— 服务器本身只返回一个扁平列表。
Scanova 文档桥接
让助手在对话过程中实时查阅本文档站点。| 工具 | 类型 | 说明 |
|---|---|---|
probe_docs_mcp | 只读 | 检查与 Scanova 文档 MCP 服务器的连通性，并列出其可用工具 |
query_docs | 只读 | 搜索本文档（mode="search"），或对文档执行只读的文件系统式命令 —— cat、head、rg、tree、jq —— 以直接读取某个参考页面（mode="filesystem"） |
类别与校验
助手在创建任何内容之前可以查阅的参考数据。| 工具 | 类型 | 说明 |
|---|---|---|
get_qr_categories | 只读 | 列出可用的二维码类别（URL、vCard、WiFi、Document、Social Media 等） |
get_qr_category_fields | 只读 | 返回某个类别所需和可选的 info JSON 字段说明，也可一次返回全部类别。属于静态参考数据，因此不消耗任何 API 调用 |
validate_qr_info | 只读 | 在 create_qr_code 或 update_qr_code 运行前校验类别与 info 负载，可发现格式错误的 JSON、缺失的必填字段和无效取值 |
二维码设计
设计预览从不保存：助手会先展示可选方案，再用set_qr_design 应用您选定的那一个。
| 工具 | 类型 | 说明 |
|---|---|---|
get_qr_design_options | 只读 | 返回设计选项的完整目录——数据图案、渐变样式、定位点形状、外框、纠错级别和字体——以便助手在调用 set_qr_design 之前提供真实的选择 |
preview_qr_design | 只读 | 在不保存的前提下预览设计：返回合并后的设计、扫描安全检查（码点与定位点的颜色对比度、添加 Logo 时的纠错级别、反色或透明背景）、基于渲染图的真实扫描测试，以及图片本身。既适用于现有二维码，也适用于新内容 |
set_qr_design | 破坏性 | 使用易懂的命名参数为现有二维码应用视觉设计。只有您指定的字段会改变，其余设置将与该二维码当前的设计合并。未通过扫描安全检查的设计会被拒绝，除非您明确接受风险（accept_risk） |
二维码管理
| 工具 | 类型 | 说明 |
|---|---|---|
create_qr_code | 写入 | 在名称、类别、类型和 info 负载均已明确后，创建一个新的二维码 |
open_qr_code_creation_form | 只读 | 改为打开一个交互式表单 —— 适用于您请求创建二维码但未提供全部必要信息的情况 |
list_qr_codes | 只读 | 列出账户中的二维码和页面，支持分页与搜索，也可只列出其中一类 |
retrieve_qr_code | 只读 | 获取某个特定二维码的详情 |
update_qr_code | 破坏性 | 更新一个已有的二维码 |
activate_qr_code | 写入 | 启用一个二维码 |
deactivate_qr_code | 破坏性 | 停用一个二维码 |
delete_qr_code | 破坏性 | 永久删除一个二维码 |
download_qr_code | 只读 | 以 PNG、JPG 或 PDF 格式下载二维码图片 |
list_tags | 只读 | 列出账户二维码上的标签。按设计仅支持读取 —— 标签是在附加到二维码时产生的，而非通过创建调用 |
update_qr_tags | 破坏性 | 用您提供的标签替换某个二维码的现有标签（传入空列表则移除全部标签）。尚不存在的标签会被自动创建 |
回收站与健康检查
| 工具 | 类型 | 说明 |
|---|---|---|
list_trashed_qr_codes | 只读 | 列出回收站中的二维码（已删除但仍可恢复），并显示每个二维码的删除时间和扫描次数 |
restore_qr_codes | 写入 | 按 qrid 从回收站恢复二维码，使其重新生效。恢复的二维码会计入套餐的二维码配额，且不会在一次调用中恢复整个回收站 |
get_qr_health | 只读 | 对账户中的二维码运行健康检查，找出导致二维码无法按预期工作的问题，例如未启用或已过期的二维码、失效的目标地址，以及需要处理的表单或自定义域名 |
GS1 召回
| 工具 | 类型 | 说明 |
|---|---|---|
list_gs1_recalls | 只读 | 列出账户的 GS1 批次召回通知 —— 涉及的 GTIN 和批次、扫描受影响产品的人所看到的消息，以及每条通知是否生效 |
create_gs1_recall | 写入 | 召回某个产品批次：所有扫描该 GTIN 及批次对应 GS1 二维码的人，都会改为看到您的消息 |
update_gs1_recall | 破坏性 | 修改召回通知的消息，或在召回结束后将其关闭。其历史记录会被保留 |
文件夹
| 工具 | 类型 | 说明 |
|---|---|---|
create_folder | 写入 | 创建一个新文件夹，用于组织二维码或页面 |
list_folders | 只读 | 列出某个给定类型（qr 或 page）的所有文件夹 |
update_folder | 写入 | 重命名一个已有的文件夹 |
delete_folder | 破坏性 | 删除文件夹。工具会先询问其中的二维码如何处理 —— 移入 Uncategorized，还是随文件夹一并删除 |
move_qr_codes_to_folder | 写入 | 将多个二维码移动到某个文件夹中 |
unassign_qr_codes_from_folder | 写入 | 将多个二维码从某个文件夹中移除（它们会变为 Uncategorized） |
表单
| 工具 | 类型 | 说明 |
|---|---|---|
list_forms | 只读 | 列出所有潜在客户捕获表单，可选按启用状态筛选 |
retrieve_form | 只读 | 获取某个特定表单的详细信息，包括其配置 |
create_form | 写入 | 根据标题和问题创建表单 —— 每个问题都有一种回答类型（简答、邮箱、多选、星级评分等），选择题还可附带选项；若同时传入动态二维码，则立即将表单附加到该二维码。也可接受表单的完整区块结构 |
update_form | 破坏性 | 更新一个表单的名称或启用状态 |
delete_form | 破坏性 | 永久删除一个表单 |
attach_form_to_qr | 写入 | 通过表单的数字 id 或其 form_id，为一个二维码附加一个潜在客户捕获表单 |
detach_form_from_qr | 破坏性 | 移除一个二维码上的潜在客户捕获表单 |
list_form_templates | 只读 | 列出可用于新建表单的现成表单模板 |
list_form_responses | 只读 | 按从新到旧的顺序列出表单收集到的回复：包括回答内容、提交时间，以及通过哪个二维码提交。可按日期范围、二维码或搜索词筛选 |
get_form_analytics | 只读 | 获取表单的表现数据：回复总数和跳过总数（与上一周期对比，并按日期细分），以及按来源二维码统计的回复数 |
get_form_question_analytics | 只读 | 获取表单中每个问题的作答情况：有多少条回复回答了该问题，以及对于选择题、评分题和量表题，每个答案被选择的次数 |
list_form_notifications | 只读 | 列出为新表单回复设置的邮件提醒 —— 发送给谁、发送频率、涉及哪些表单，以及每条提醒是否开启 |
create_form_notification | 写入 | 在表单收到新回复时发送邮件通知 —— 可以每条回复都通知，也可以按日、周或月汇总发送。收件地址会收到填写者的回答内容 |
update_form_notification | 破坏性 | 修改表单提醒的收件人、频率或涉及的表单，或将其关闭。除非您传入新的表单，否则原有表单保持不变 |
潜在客户列表
| 工具 | 类型 | 说明 |
|---|---|---|
list_lead_lists | 只读 | 列出所有潜在客户列表，可按启用状态筛选。新项目建议改用表单 |
retrieve_lead_list | 只读 | 获取某个特定潜在客户列表的详细信息，包括其 webhook 配置 |
update_lead_list | 破坏性 | 更新一个潜在客户列表的名称或启用状态 |
delete_lead_list | 破坏性 | 永久删除一个潜在客户列表 |
attach_lead_list_to_qr | 写入 | 为一个二维码附加一个潜在客户列表以进行潜在客户捕获 |
detach_lead_list_from_qr | 破坏性 | 移除一个二维码上的潜在客户列表 |
分析数据与报告
| 工具 | 类型 | 说明 |
|---|---|---|
get_account_stats | 只读 | 获取账户级的使用计数器——二维码总数、扫码总数、用户总数等 |
get_qr_analytics | 只读 | 获取按设备、地理位置和日期细分的二维码效果指标 |
get_analytics_overview | 只读 | 获取账户的扫描概览：历史总计、本月、最近几个月，以及按日期统计的扫描次数 |
list_analytics_reports | 只读 | 列出为账户生成的扫描分析报告，包括每份报告的范围、日期和状态，报告就绪后还会附带下载链接 |
create_analytics_report | 写入 | 针对选定的二维码、标签或文件夹，在指定日期范围内生成扫描分析报告 —— 汇总分析、原始扫描数据或两者兼有。报告在后台生成，完成后通过邮件发送给发起请求的人 |
套餐与计费
仅限只读：助手可以解释套餐和计费历史，但订阅变更仍需在应用中完成。| 工具 | 类型 | 说明 |
|---|---|---|
get_current_plan | 只读 | 获取账户当前生效的套餐 —— 到期时间、计费状态，以及它所授予的完整配额清单 |
list_available_plans | 只读 | 列出账户可以切换到的套餐，以及各套餐的功能和配额 |
get_downgrade_impact | 只读 | 在切换到较低套餐之前，显示账户中有哪些二维码、用户、域名及其他资源超出该套餐的限制 |
list_payments | 只读 | 列出账户的付款历史 —— 每笔付款的金额、日期和状态 |
list_orders | 只读 | 列出账户的订单 —— 套餐购买、续订和额度加购 —— 及其状态 |
list_quota_topups | 只读 | 列出在套餐之外额外购买的配额，以及每笔加购的到期时间 |
用户与角色
| 工具 | 类型 | 说明 |
|---|---|---|
list_users | 只读 | 列出账户中的所有用户 |
get_user | 只读 | 获取某个特定用户的详情 |
add_user | 写入 | 通过邮箱邀请一个新用户加入账户 |
resend_user_invitation | 写入 | 为尚未接受邀请的团队成员重新发送邀请邮件 |
remove_user | 破坏性 | 从账户中移除一个用户 |
list_user_roles | 只读 | 列出所有可分配的用户角色 |
create_custom_role | 写入 | 创建自定义角色。需要专门的套餐配额，若套餐未包含则返回 403。请先调用 list_user_roles 查看已有角色 |
update_user_role | 破坏性 | 更改一个现有用户的角色 |
活动记录
| 工具 | 类型 | 说明 |
|---|---|---|
get_activity_feed | 只读 | 列出账户中发生的操作 —— 谁在什么时间创建、修改或删除了什么 —— 可按事件类型、团队成员或日期筛选 |
get_activity_summary | 只读 | 获取账户在某段时间内的活动计数 |
自定义域名
| 工具 | 类型 | 说明 |
|---|---|---|
list_custom_domains | 只读 | 列出账户的自定义短链接域名（例如 qr.example.com），标明哪个是默认域名，以及每个域名是否已验证 |
get_custom_domain | 只读 | 获取某个自定义域名的详情 —— DNS（TXT/CNAME）验证、SSL 状态，以及它是否为默认域名 |
批量操作与媒体
| 工具 | 类型 | 说明 |
|---|---|---|
list_bulk_operations | 只读 | 列出账户的批量操作 —— 批量生成和批量更新二维码 —— 以及每项操作的状态和结果 |
get_bulk_operation_stats | 只读 | 获取账户所有批量操作的汇总数据 |
list_media | 只读 | 列出账户媒体库中的文件 —— 图片、PDF、视频等 —— 例如用于为二维码挑选 Logo 或文档 |
集成与转化跟踪
| 工具 | 类型 | 说明 |
|---|---|---|
get_integrations_overview | 只读 | 显示账户已连接了哪些集成 —— webhook、Zapier、Slack、HubSpot、Google Analytics —— 以及它们的状态 |
list_webhooks | 只读 | 列出账户的 webhook：每个 webhook 将事件发送到哪里、针对哪些表单或二维码，以及是否开启 |
list_tracking_sites | 只读 | 列出为 Conversion Tracking 设置的网站及其域名 |
list_tracking_funnels | 只读 | 列出某个跟踪网站的转化漏斗 —— 从扫描到转化的各个步骤 |
落地页
| 工具 | 类型 | 说明 |
|---|---|---|
list_page_templates | 只读 | 列出适用于打开页面的二维码的落地页模板 —— 可以是 Scanova 自带的模板，也可以只列出账户中保存的模板 |
破坏性工具在设计上不会弹出确认对话框 —— MCP 协议本身没有内置的”确定吗？“步骤，是否确认完全取决于您所用 AI 客户端自身的界面惯例。在批准之前，请先看清
delete_*、update_* 或 remove_user 调用将要执行的操作，就像对待您委托给助手的任何其他写入操作一样。