FluentBoards MCP Server

Instructions

Implementation Reference

• src/tools/labels.ts:57-77 (handler)

  Handler function for 'edit_label' tool: destructures args, conditionally adds bg_color and color to labelData, performs PUT API request to update label, returns formatted response.

  async (args) => {
    const { board_id, label_id, title, bg_color, color } = args;
  
    const labelData: any = {
      label: title,
    };
  
    if (bg_color) {
      labelData.bg_color = bg_color;
    }
  
    if (color) {
      labelData.color = color;
    }
  
    const response = await api.put(
      `/projects/${board_id}/labels/${label_id}`,
      labelData
    );
    return formatResponse(response.data);
  }

• src/tools/labels.ts:47-78 (registration)

  Registers the 'edit_label' MCP tool with server.tool(), providing description, inline Zod input schema, and handler function.

  server.tool(
    "edit_label",
    "Edit a label's title and colors",
    {
      board_id: z.number().int().positive().describe("Board ID"),
      label_id: z.number().int().positive().describe("Label ID"),
      title: z.string().min(1).describe("Label title/text"),
      bg_color: z.string().optional().describe("Background color (hex)"),
      color: z.string().optional().describe("Text color (hex)"),
    },
    async (args) => {
      const { board_id, label_id, title, bg_color, color } = args;
  
      const labelData: any = {
        label: title,
      };
  
      if (bg_color) {
        labelData.bg_color = bg_color;
      }
  
      if (color) {
        labelData.color = color;
      }
  
      const response = await api.put(
        `/projects/${board_id}/labels/${label_id}`,
        labelData
      );
      return formatResponse(response.data);
    }
  );

• src/types/index.ts:54-61 (schema)

  Zod schema definition for EditLabel inputs, matching the inline schema used in the tool registration.

  export const EditLabelSchema = z.object({
    board_id: z.number().int().positive(),
    label_id: z.number().int().positive(),
    title: z.string().min(1),
    bg_color: z.string().optional(),
    color: z.string().optional(),
  });

• src/index.ts:25-25 (registration)

  Top-level registration call that invokes registerLabelTools to add all label tools, including 'edit_label', to the MCP server.

  registerLabelTools(server);