Report Progress
report_progress is one of the 32 MCP tools in Weft, the AI task manager you run by talking to Claude, Cursor, Codex or ChatGPT through one MCP endpoint. Say you are still working. A claim on a task expires if the client goes quiet, and this renews it. Without a heartbeat a long-running task is treated as abandoned and offered to someone else — deliberately, because an agent that dies mid-run reports nothing, so silence is the only signal the board has.
Weft 是為獨立創業者和小團隊打造的 AI 任務管理工具。
工具參考文件以英文維護:工具名稱、參數與範例在每種語言中都相同。
參數
| 名稱 | 型別 | 必填 | 說明 |
|---|---|---|---|
| runId | string | 是 | The runId returned by start_task |
| leaseToken | string | 是 | The leaseToken returned by start_task |
| status | 'working' | 'blocked' | 'needs_input' | 否 | 'working' (default) renews the claim; the other two park the task for the human |
| note | string | 否 | One line on where you are (≤280 chars) |
| learnings | (string | { trigger, content })[] | 否 | Up to 3 lessons worth remembering beyond this task — saved as memory notes, surfaced in future get_my_work calls. |
回傳
ok plus the new leaseExpiresAt and renewEverySeconds. When the claim has expired or moved to another client, ok:false with reason "lease_lost" — stop working and call start_task again.
註記
- 冪等。用相同參數呼叫兩次,效果和呼叫一次一樣。
範例
使用者說的話:
"Keep going, this will take a while."AI 在背後呼叫的東西:
json
{
"name": "report_progress",
"arguments": {
"runId": "…",
"leaseToken": "…",
"status": "working"
}
}相關
- 全部 32 個 MCP 工具 — 目錄檢視。
- 梭子 — AI 客戶端如何使用這些工具。
- 用你自己的客戶端呼叫這個工具:參考設定指南,或直接打
https://letsweft.com/api/mcp。