FluentBoards MCP Server

Instructions

Implementation Reference

• src/tools/labels.ts:93-107 (handler)

  The handler function for the 'create_label' tool. It destructures the arguments, prepares the label data, makes a POST request to the API to create the label, and formats the response.

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

• src/tools/labels.ts:81-108 (registration)

  Registers the 'create_label' tool with the MCP server, providing name, description, input schema, and handler function.

  server.tool(
    "create_label",
    "Create a new label on a board",
    {
      board_id: z.number().int().positive().describe("Board ID"),
      title: z.string().min(1).describe("Label title/text"),
      bg_color: z.string().describe("Background color (hex) - e.g., #4bce97"),
      color: z
        .string()
        .default("#1B2533")
        .describe("Text color (hex) - defaults to #1B2533"),
    },
    async (args) => {
      const { board_id, title, bg_color, color } = args;
  
      const labelData: any = {
        label: title,
        bg_color,
        color,
      };
  
      const response = await api.post(
        `/projects/${board_id}/labels`,
        labelData
      );
      return formatResponse(response.data);
    }
  );

• src/types/index.ts:47-52 (schema)

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

  export const CreateLabelSchema = z.object({
    board_id: z.number().int().positive(),
    title: z.string().min(1),
    bg_color: z.string(),
    color: z.string().default("#1B2533"),
  });

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

  Calls registerLabelTools to register all label-related tools, including 'create_label', on the MCP server.

  registerLabelTools(server);