FluentBoards MCP Server

Instructions

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);