change_task_status
Update task progress by moving it to a different stage within a FluentBoards project management board.
Instructions
Change the status/stage of a task
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| board_id | Yes | Board ID | |
| task_id | Yes | Task ID | |
| stage_id | Yes | New stage ID |
Implementation Reference
- src/tools/tasks.ts:129-137 (handler)Handler function that executes the tool logic: destructures args, makes a PUT request to update the task's stage_id via the API, and formats the response.
async (args) => { const { board_id, task_id, stage_id } = args; const response = await api.put(`/projects/${board_id}/tasks/${task_id}`, { property: 'stage_id', value: stage_id, }); return formatResponse(response.data); } - src/tools/tasks.ts:124-128 (schema)Zod schema defining the input parameters: board_id, task_id, and stage_id, all positive integers.
{ board_id: z.number().int().positive().describe("Board ID"), task_id: z.number().int().positive().describe("Task ID"), stage_id: z.number().int().positive().describe("New stage ID"), }, - src/tools/tasks.ts:121-138 (registration)Registers the change_task_status tool on the MCP server using server.tool, providing name, description, input schema, and handler function.
server.tool( "change_task_status", "Change the status/stage of a task", { board_id: z.number().int().positive().describe("Board ID"), task_id: z.number().int().positive().describe("Task ID"), stage_id: z.number().int().positive().describe("New stage ID"), }, async (args) => { const { board_id, task_id, stage_id } = args; const response = await api.put(`/projects/${board_id}/tasks/${task_id}`, { property: 'stage_id', value: stage_id, }); return formatResponse(response.data); } ); - src/index.ts:23-23 (registration)Top-level registration call that invokes registerTaskTools on the main MCP server instance, thereby registering the change_task_status tool among others.
registerTaskTools(server);