Add pagination support to get_comments

- Add page parameter to get_comments (default: 1)
- Parse X-Total-Count header for total comments count
- Parse Link header for next_page indicator
- Update FastMCP tool and CLI server to return pagination metadata

Response now includes total_count and next_page fields to help
clients navigate through paginated comments.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

basecamp_client.py

@@ -405,21 +405,46 @@ class BasecampClient:
             raise Exception(f"Failed to get schedule: {str(e)}")
 
     # Comments methods
-    def get_comments(self, project_id, recording_id):
+    def get_comments(self, project_id, recording_id, page=1):
         """
-        Get all comments for a recording (todos, message, etc.).
-        
+        Get comments for a recording (todos, message, etc.).
+
         Args:
+            project_id (int): Project/bucket ID.
             recording_id (int): ID of the recording (todos, message, etc.)
-            project_id (int): Project/bucket ID. If not provided, it will be extracted from the recording ID.
-            
+            page (int): Page number for pagination (default: 1).
+                        Basecamp uses geared pagination: page 1 has 15 results,
+                        page 2 has 30, page 3 has 50, page 4+ has 100.
+
         Returns:
-            list: Comments for the recording
+            dict: Contains 'comments' list and pagination metadata:
+                  - comments: list of comments
+                  - total_count: total number of comments (from X-Total-Count header)
+                  - next_page: next page number if available, None otherwise
         """
         endpoint = f"buckets/{project_id}/recordings/{recording_id}/comments.json"
-        response = self.get(endpoint)
+        response = self.get(endpoint, params={"page": page})
         if response.status_code == 200:
-            return response.json()
+            # Parse pagination headers
+            total_count = response.headers.get('X-Total-Count')
+            total_count = int(total_count) if total_count else None
+
+            # Parse Link header for next page
+            next_page = None
+            link_header = response.headers.get('Link', '')
+            if 'rel="next"' in link_header:
+                # Extract page number from Link header
+                # Format: <https://3.basecampapi.com/.../comments.json?page=2>; rel="next"
+                import re
+                match = re.search(r'page=(\d+).*rel="next"', link_header)
+                if match:
+                    next_page = int(match.group(1))
+
+            return {
+                "comments": response.json(),
+                "total_count": total_count,
+                "next_page": next_page
+            }
         else:
             raise Exception(f"Failed to get comments: {response.status_code} - {response.text}")