工具参考
全部 29 个 MCP 工具，按权限分组，逐个说明它做什么、需要什么。
一共 29 个工具，按解锁它们的权限分组。这张表是给你决定该授权什么用的 —— 参数由助手自己读，这里不重复。
授权之前先看权限分组：一个分组的写入级别总是包含删除，而删除是级联的。
所有列表类工具每次只返回一页 —— 默认 20 条，最多 100 条 —— 所以走完一个大笔记库需要多次调用。
账户信息
只有读取，这个分组没有写入级别。
| 工具 | 作用 | 需要 |
|---|---|---|
whoami | 报告这个连接被授权为哪个陪读蛙账号。只有连接同时持有邮箱权限时才包含邮箱。 | account 读取 |
笔记库与字段
| 工具 | 作用 | 需要 |
|---|---|---|
list_notebases | 列出你拥有的笔记库。 | notebases 读取 |
get_notebase_schema | 读取一个笔记库的名称和字段定义，包括写笔记时作为键的字段 ID。不返回笔记内容。 | notebases 读取 |
create_notebase | 新建一个空笔记库，可带上最初的字段。笔记单独添加。 | notebases 读写 |
rename_notebase | 重命名笔记库，不改动它的学习设置。 | notebases 读写 |
delete_notebase | 永久删除一个笔记库，连同它的字段、笔记、模板、卡片和复习记录。 | notebases 读写 |
create_notebase_field | 给笔记库新增一个字段并返回它的 ID。 | notebases 读写 |
update_notebase_field | 重命名字段或修改它的配置，类型不能改。删掉一个单选选项会清空所有笔记中对应的值。 | notebases 读写 |
delete_notebase_field | 删除字段并清除所有笔记里它的值。主字段和被模板引用的字段不能删除。 | notebases 读写 |
笔记内容
| 工具 | 作用 | 需要 |
|---|---|---|
list_notes | 浏览笔记，或在某一个笔记库内搜索。搜索是至少两个字符的字面、不区分大小写的子串，只匹配文本字段。 | notes 读取 |
get_note | 读取一条笔记的字段内容，以及后续修改时用于校验的时间戳。 | notes 读取 |
create_notes | 在一个笔记库里一次原子性地新建 1–50 条笔记。已有的模板会立刻把它们变成卡片。 | notes 读写 |
update_note | 把新值合并进一条笔记，没提到的字段保持原值，null 表示清空。若笔记在读取后被改动则失败，不覆盖。 | notes 读写 |
delete_note | 永久删除一条笔记，连同由它生成的卡片和这些卡片的复习记录。 | notes 读写 |
卡片模板
| 工具 | 作用 | 需要 |
|---|---|---|
list_card_templates | 列出你的卡片模板，可限定在某一个笔记库内。 | card_templates 读取 |
get_card_template | 读取一个模板的完整定义，以及后续修改时用于校验的时间戳。 | card_templates 读取 |
create_card_template | 用已有的字段 ID 新建一个模板。这会为笔记库里已有的每条笔记生成卡片。 | card_templates 读写 |
update_card_template | 修改模板的名称或定义。渲染出的卡片跟随已保存的模板。 | card_templates 读写 |
delete_card_template | 永久删除一个模板，连同由它生成的卡片和这些卡片的复习记录。源笔记保留。 | card_templates 读写 |
渲染后的卡片
卡片是笔记内容加排程状态，所以这两个工具都需要同时具备两项读取权限。
| 工具 | 作用 | 需要 |
|---|---|---|
list_cards | 浏览卡片，带渲染后的正反面、来源 ID 和学习状态。可按笔记库、模板或排程状态筛选。 | notes 读取 + study 读取 |
get_card | 以同样的方式读取一张卡片。 | notes 读取 + study 读取 |
复习与学习记录
| 工具 | 作用 | 需要 |
|---|---|---|
get_study_stats | 按给定时区读取各笔记库的学习队列数量。不返回笔记内容或卡片正反面。 | study 读取 |
get_study_settings | 读取一个笔记库的每日新卡上限、每日复习上限和目标记忆保留率。不返回它的名称和内容。 | study 读取 |
list_review_history | 读取你的复习记录，可按笔记库或卡片筛选。不含笔记内容和卡片正反面。 | study 读取 |
update_study_settings | 只修改上面那三项设置 —— 每日新卡上限、每日复习上限、目标记忆保留率。 | study 读写 |
record_review | 为一张卡片提交一次评分。 FSRS 会当成真实复习，更新卡片的稳定度、难度和到期时间。需要时区，因为它决定这次复习属于哪个学习日。 | study 读写 |
undo_review | 撤销一张卡片最近一次符合条件的复习，恢复它之前的排程。需要那次复习的 ID，因此重试不会误撤销更早的一次。 | study 读写 |
set_card_suspended | 暂停一张卡片，让它退出学习直到被恢复，或者恢复它。 | study 读写 |
set_card_buried | 搁置一张卡片，把它藏到当天学习日结束，或者取消搁置。 | study 读写 |