FluentBoards MCP Server

Instructions

Implementation Reference

• src/tools/boards.ts:38-49 (handler)

  Handler function that validates access to the board, fetches board details using the API client, and returns a formatted response.

  async (args) => {
    const { board_id } = args;
  
    // Validate board access
    const accessCheck = validateBoardAccess(board_id);
    if (!accessCheck.allowed) {
      return formatResponse(createBoardFocusError(accessCheck));
    }
  
    const response = await api.get(`/projects/${board_id}`);
    return formatResponse(response.data);
  }

• src/tools/boards.ts:35-37 (schema)

  Zod input schema defining board_id as a positive integer.

  {
    board_id: z.number().int().positive().describe("Board ID"),
  },

• src/tools/boards.ts:32-50 (registration)

  Registers the get_board tool on the MCP server with name, description, input schema, and handler function.

  server.tool(
    "get_board",
    "Get details of a specific board",
    {
      board_id: z.number().int().positive().describe("Board ID"),
    },
    async (args) => {
      const { board_id } = args;
  
      // Validate board access
      const accessCheck = validateBoardAccess(board_id);
      if (!accessCheck.allowed) {
        return formatResponse(createBoardFocusError(accessCheck));
      }
  
      const response = await api.get(`/projects/${board_id}`);
      return formatResponse(response.data);
    }
  );

• src/utils/index.ts:169-187 (helper)

  Helper function to validate if access to a specific board is allowed based on board focus configuration. Used in get_board handler.

  export function validateBoardAccess(boardId: number): BoardFocusResult {
    const { boardFocus } = config;
  
    // If board focus is not enabled, allow all boards
    if (!boardFocus.enabled || !boardFocus.boardId) {
      return { allowed: true };
    }
  
    // Check if the requested board matches the focused board
    if (boardId !== boardFocus.boardId) {
      return {
        allowed: false,
        reason: `Operations are focused on board ${boardFocus.boardId}. Access to board ${boardId} is outside the current focus scope.`,
        code: "OUT_OF_FOCUS"
      };
    }
  
    return { allowed: true };
  }