工具參考
全部 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 讀寫 |