FluentBoards MCP Server

Instructions

Implementation Reference

• src/tools/boards.ts:95-117 (handler)

  The main handler function for the 'create_stage' tool. It destructures the input arguments, validates board access using validateBoardAccess, constructs the stage data (title required, position optional), performs an API POST to `/projects/${board_id}/stage-create`, and returns the formatted response.

  async (args) => {
    const { board_id, title, position } = args;
  
    // Validate board access
    const accessCheck = validateBoardAccess(board_id);
    if (!accessCheck.allowed) {
      return formatResponse(createBoardFocusError(accessCheck));
    }
  
    const stageData: any = {
      title,
    };
  
    if (position !== undefined) {
      stageData.position = position;
    }
  
    const response = await api.post(
      `/projects/${board_id}/stage-create`,
      stageData
    );
    return formatResponse(response.data);
  }

• src/tools/boards.ts:87-118 (registration)

  Direct registration of the 'create_stage' MCP tool within registerBoardTools, including tool name, description, Zod input schema, and the handler function.

  server.tool(
    "create_stage",
    "Create a new stage in a board",
    {
      board_id: z.number().int().positive().describe("Board ID"),
      title: z.string().min(1).describe("Stage title"),
      position: z.number().optional().describe("Stage position (optional)"),
    },
    async (args) => {
      const { board_id, title, position } = args;
  
      // Validate board access
      const accessCheck = validateBoardAccess(board_id);
      if (!accessCheck.allowed) {
        return formatResponse(createBoardFocusError(accessCheck));
      }
  
      const stageData: any = {
        title,
      };
  
      if (position !== undefined) {
        stageData.position = position;
      }
  
      const response = await api.post(
        `/projects/${board_id}/stage-create`,
        stageData
      );
      return formatResponse(response.data);
    }
  );

• src/types/index.ts:14-18 (schema)

  Zod schema for 'CreateStage' inputs (board_id, title, position), matching the inline schema used in the tool registration. Also used to derive TypeScript type CreateStage.

  export const CreateStageSchema = z.object({
    board_id: z.number().int().positive(),
    title: z.string().min(1),
    position: z.number().optional(),
  });