@access-mcp/events 0.1.0 → 0.2.0

package/README.md

@@ -8,7 +8,7 @@ A Model Context Protocol server providing access to ACCESS-CI events data includ
 
 - **`get_events`** - Get ACCESS-CI events with comprehensive filtering
 - **`get_upcoming_events`** - Get upcoming events (today onward)
-- **`search_events`** - Search events by keywords in title/description
+- **`search_events`** - **Enhanced!** Search events using API's native full-text search across all content
 - **`get_events_by_tag`** - Get events filtered by specific tags
 
 ### 📊 Resources
@@ -49,10 +49,12 @@ Add to your Claude Desktop configuration:
 What events are coming up in the next week?
 ```
 
-**Search for specific topics:**
+**Search for specific topics (now much more powerful!):**
 
 ```
 Find upcoming Python workshops
+Show me machine learning events
+Search for "office hours" this week
 ```
 
 **Filter by skill level:**
@@ -64,9 +66,33 @@ Show me beginner-level events this month
 **Get events by tags:**
 
 ```
-Find all machine learning events
+Find all GPU computing events
 ```
 
+## Key Improvements
+
+### 🚀 Enhanced Search (v2.1)
+
+**Native API Full-Text Search:**
+- Searches across titles, descriptions, speakers, tags, location, and event type
+- Supports multi-word queries (e.g., "machine learning", "office hours")
+- Much more comprehensive results than previous tag-only filtering
+- Server-side indexing for better performance
+
+**Search Examples:**
+- `"python"` - Find Python programming events
+- `"machine learning"` - Find ML-related content in any field
+- `"gpu computing"` - Find GPU-related events
+- `"office hours"` - Find all office hours sessions
+
+### 🌍 Timezone Support (v2.1)
+
+**Smart Timezone Handling:**
+- All timestamps returned in UTC (ISO 8601 format with Z suffix)
+- Timezone parameter controls relative date calculations
+- Common timezone examples: `America/New_York`, `Europe/London`, `Asia/Tokyo`
+- Default: UTC calculations
+
 ## Filtering Capabilities
 
 ### Date Filtering
@@ -144,18 +170,28 @@ The server adds these computed fields:
 }
 ```
 
-### Search Events
+### Search Events (Enhanced API Search)
 
 ```typescript
-// Search for GPU-related events
+// Search for GPU-related events using native API search
 {
   "tool": "search_events",
   "arguments": {
     "query": "GPU computing",
     "beginning_date_relative": "today",
+    "timezone": "America/New_York",
     "limit": 10
   }
 }
+
+// Multi-word search examples
+{
+  "tool": "search_events",
+  "arguments": {
+    "query": "machine learning",
+    "beginning_date_relative": "-1month"
+  }
+}
 ```
 
 ### Get Events by Tag
@@ -187,10 +223,17 @@ npm test
 
 ## Base URL
 
-The server connects to: `https://support.access-ci.org/api/2.0/events`
+The server connects to: `https://support.access-ci.org/api/2.1/events` (v2.1 with UTC timestamps and enhanced search)
 
 ## Technical Notes
 
+### API Version 2.1 Features
+- **UTC timestamps**: All dates returned in UTC with Z suffix (e.g., `2024-08-30T13:00:00Z`)
+- **Native search**: Uses `search_api_fulltext` parameter for comprehensive searching
+- **Timezone support**: Relative dates calculated using specified timezone
+- **Enhanced metadata**: Responses include API version and timezone info
+
+### General
 - All date comparisons use the event's start date (`date` field)
 - Results include both upcoming and past events unless date filtered
 - Faceted search filters use AND logic when combined

package/dist/server.d.ts

@@ -29,6 +29,11 @@ export declare class EventsServer extends BaseAccessServer {
                     type: string;
                     description: string;
                 };
+                timezone: {
+                    type: string;
+                    description: string;
+                    default: string;
+                };
                 event_type: {
                     type: string;
                     description: string;
@@ -74,6 +79,11 @@ export declare class EventsServer extends BaseAccessServer {
                     type: string;
                     description: string;
                 };
+                timezone: {
+                    type: string;
+                    description: string;
+                    default: string;
+                };
                 beginning_date_relative?: undefined;
                 end_date_relative?: undefined;
                 beginning_date?: undefined;
@@ -103,6 +113,11 @@ export declare class EventsServer extends BaseAccessServer {
                     default: string;
                     enum?: undefined;
                 };
+                timezone: {
+                    type: string;
+                    description: string;
+                    default: string;
+                };
                 limit: {
                     type: string;
                     description: string;
@@ -137,6 +152,11 @@ export declare class EventsServer extends BaseAccessServer {
                     enum: string[];
                     default: string;
                 };
+                timezone: {
+                    type: string;
+                    description: string;
+                    default: string;
+                };
                 limit: {
                     type: string;
                     description: string;

package/dist/server.js

@@ -3,7 +3,7 @@ import axios from "axios";
 export class EventsServer extends BaseAccessServer {
     _eventsHttpClient;
     constructor() {
-        super("access-mcp-events", "0.1.0", "https://support.access-ci.org");
+        super("access-mcp-events", "0.2.0", "https://support.access-ci.org");
     }
     get httpClient() {
         if (!this._eventsHttpClient) {
@@ -28,14 +28,14 @@ export class EventsServer extends BaseAccessServer {
         return [
             {
                 name: "get_events",
-                description: "Get ACCESS-CI events with comprehensive filtering capabilities",
+                description: "Get ACCESS-CI events with comprehensive filtering capabilities. Returns events in UTC timezone with enhanced metadata.",
                 inputSchema: {
                     type: "object",
                     properties: {
                         // Relative date filtering
                         beginning_date_relative: {
                             type: "string",
-                            description: "Start date using relative values (today, +1week, -1month, etc.)",
+                            description: "Start date using relative values. Calculated in UTC by default, or use 'timezone' parameter for local calculations.",
                             enum: [
                                 "today",
                                 "+1week",
@@ -50,7 +50,7 @@ export class EventsServer extends BaseAccessServer {
                         },
                         end_date_relative: {
                             type: "string",
-                            description: "End date using relative values (today, +1week, -1month, etc.)",
+                            description: "End date using relative values. Calculated in UTC by default, or use 'timezone' parameter for local calculations.",
                             enum: [
                                 "today",
                                 "+1week",
@@ -66,11 +66,17 @@ export class EventsServer extends BaseAccessServer {
                         // Absolute date filtering
                         beginning_date: {
                             type: "string",
-                            description: "Start date in YYYY-MM-DD or YYYY-MM-DD HH:MM:SS format",
+                            description: "Start date in YYYY-MM-DD or YYYY-MM-DD HH:MM:SS format. Always interpreted as provided (no timezone conversion).",
                         },
                         end_date: {
                             type: "string",
-                            description: "End date in YYYY-MM-DD or YYYY-MM-DD HH:MM:SS format",
+                            description: "End date in YYYY-MM-DD or YYYY-MM-DD HH:MM:SS format. Always interpreted as provided (no timezone conversion).",
+                        },
+                        // Timezone parameter for relative date calculations
+                        timezone: {
+                            type: "string",
+                            description: "Timezone for relative date calculations (default: UTC). Common values: UTC, America/New_York (Eastern), America/Chicago (Central), America/Denver (Mountain), America/Los_Angeles (Pacific), Europe/London (British), Europe/Berlin (CET). Only affects relative dates, not absolute dates. Invalid timezones default to UTC.",
+                            default: "UTC",
                         },
                         // Faceted search filters
                         event_type: {
@@ -102,7 +108,7 @@ export class EventsServer extends BaseAccessServer {
             },
             {
                 name: "get_upcoming_events",
-                description: "Get upcoming ACCESS-CI events (today onward)",
+                description: "Get upcoming ACCESS-CI events (from today onward in UTC). Convenient shortcut for get_events with beginning_date_relative=today.",
                 inputSchema: {
                     type: "object",
                     properties: {
@@ -114,7 +120,12 @@ export class EventsServer extends BaseAccessServer {
                         },
                         event_type: {
                             type: "string",
-                            description: "Filter by event type (workshop, webinar, etc.)",
+                            description: "Filter by event type (workshop, webinar, Office Hours, Training, etc.)",
+                        },
+                        timezone: {
+                            type: "string",
+                            description: "Timezone for 'today' calculation (default: UTC). Use user's local timezone for better relevance.",
+                            default: "UTC",
                         },
                     },
                     required: [],
@@ -122,19 +133,24 @@ export class EventsServer extends BaseAccessServer {
             },
             {
                 name: "search_events",
-                description: "Search events by keywords in title and description",
+                description: "Search events using API's native full-text search. Searches across titles, descriptions, speakers, tags, location, and event type. Much more powerful than tag filtering.",
                 inputSchema: {
                     type: "object",
                     properties: {
                         query: {
                             type: "string",
-                            description: "Search query for event titles and descriptions",
+                            description: "Search query (case-insensitive). Use spaces for multiple words (e.g., 'machine learning', 'office hours'). Searches across all event content including descriptions.",
                         },
                         beginning_date_relative: {
                             type: "string",
-                            description: "Start date using relative values (default: today)",
+                            description: "Start date using relative values (default: today). Use '-1month' or '-1year' to search past events, or omit for all-time search.",
                             default: "today",
                         },
+                        timezone: {
+                            type: "string",
+                            description: "Timezone for relative date calculation (default: UTC)",
+                            default: "UTC",
+                        },
                         limit: {
                             type: "number",
                             description: "Maximum number of events to return (default: 25)",
@@ -147,20 +163,25 @@ export class EventsServer extends BaseAccessServer {
             },
             {
                 name: "get_events_by_tag",
-                description: "Get events filtered by specific tags",
+                description: "Get events filtered by specific tags. Useful for finding events on topics like 'python', 'ai', 'machine-learning', 'gpu', etc.",
                 inputSchema: {
                     type: "object",
                     properties: {
                         tag: {
                             type: "string",
-                            description: "Event tag to filter by (e.g., python, machine-learning, gpu)",
+                            description: "Event tag to filter by. Common tags: python, ai, machine-learning, gpu, deep-learning, neural-networks, big-data, hpc, jetstream, neocortex",
                         },
                         time_range: {
                             type: "string",
-                            description: "Time range for events",
+                            description: "Time range for events (upcoming=today onward, this_week=next 7 days, this_month=next 30 days, all=no date filter)",
                             enum: ["upcoming", "this_week", "this_month", "all"],
                             default: "upcoming",
                         },
+                        timezone: {
+                            type: "string",
+                            description: "Timezone for time_range calculations (default: UTC)",
+                            default: "UTC",
+                        },
                         limit: {
                             type: "number",
                             description: "Maximum number of events to return (default: 25)",
@@ -280,7 +301,11 @@ export class EventsServer extends BaseAccessServer {
         }
     }
     buildEventsUrl(params) {
-        const url = new URL("/api/2.0/events", this.baseURL);
+        const url = new URL("/api/2.1/events", this.baseURL);
+        // Add full-text search parameter (API native search)
+        if (params.search_api_fulltext) {
+            url.searchParams.set("search_api_fulltext", params.search_api_fulltext);
+        }
         // Add date filtering parameters
         if (params.beginning_date_relative) {
             url.searchParams.set("beginning_date_relative", params.beginning_date_relative);
@@ -294,6 +319,10 @@ export class EventsServer extends BaseAccessServer {
         if (params.end_date) {
             url.searchParams.set("end_date", params.end_date);
         }
+        // Add timezone parameter for relative date calculations
+        if (params.timezone) {
+            url.searchParams.set("timezone", params.timezone);
+        }
         // Add faceted search filters
         let filterIndex = 0;
         if (params.event_type) {
@@ -349,6 +378,11 @@ export class EventsServer extends BaseAccessServer {
             upcoming_events: enhancedEvents.filter((e) => e.starts_in_hours >= 0)
                 .length,
             events_this_week: enhancedEvents.filter((e) => e.starts_in_hours <= 168 && e.starts_in_hours >= 0).length,
+            api_info: {
+                endpoint_version: "2.1",
+                timezone_handling: "All timestamps in UTC (Z suffix). Relative dates calculated using timezone parameter (default: UTC).",
+                timezone_used: params.timezone || "UTC",
+            },
             event_types: [
                 ...new Set(enhancedEvents.map((e) => e.event_type).filter(Boolean)),
             ],
@@ -375,27 +409,30 @@ export class EventsServer extends BaseAccessServer {
             ...params,
             beginning_date_relative: "today",
             limit: params.limit || 50,
+            // Pass through timezone if provided
+            ...(params.timezone && { timezone: params.timezone }),
         };
         return this.getEvents(upcomingParams);
     }
     async searchEvents(params) {
+        // Use API's native full-text search instead of client-side filtering
         const searchParams = {
+            search_api_fulltext: params.query,
             beginning_date_relative: params.beginning_date_relative || "today",
             limit: params.limit || 25,
+            // Pass through timezone if provided
+            ...(params.timezone && { timezone: params.timezone }),
         };
-        // Get events and filter by search query
+        // Use the API's native search capabilities
         const eventsResponse = await this.getEvents(searchParams);
         const eventsData = JSON.parse(eventsResponse.content[0].text);
-        const query = params.query.toLowerCase();
-        const filteredEvents = eventsData.events.filter((event) => event.title?.toLowerCase().includes(query) ||
-            event.description?.toLowerCase().includes(query) ||
-            event.speakers?.toLowerCase().includes(query) ||
-            event.tags?.some((tag) => tag.toLowerCase().includes(query)));
+        // API returns already filtered results, no need for client-side filtering
         const summary = {
             search_query: params.query,
-            total_matches: filteredEvents.length,
-            searched_in: eventsData.total_events,
-            events: filteredEvents,
+            total_matches: eventsData.total_events,
+            search_method: "API native full-text search",
+            search_scope: "titles, descriptions, speakers, tags, location, event type",
+            events: eventsData.events,
         };
         return {
             content: [
@@ -407,7 +444,7 @@ export class EventsServer extends BaseAccessServer {
         };
     }
     async getEventsByTag(params) {
-        const { tag, time_range = "upcoming", limit = 25 } = params;
+        const { tag, time_range = "upcoming", limit = 25, timezone } = params;
         let dateParams = {};
         switch (time_range) {
             case "upcoming":
@@ -429,6 +466,8 @@ export class EventsServer extends BaseAccessServer {
             ...dateParams,
             event_tags: tag,
             limit,
+            // Pass through timezone if provided
+            ...(timezone && { timezone }),
         };
         const eventsResponse = await this.getEvents(taggedParams);
         const eventsData = JSON.parse(eventsResponse.content[0].text);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@access-mcp/events",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "ACCESS-CI Events MCP Server - Get information about workshops, webinars, and training events",
   "type": "module",
   "main": "dist/index.js",

package/src/__tests__/server.integration.test.ts

@@ -164,6 +164,88 @@ describe("EventsServer Integration Tests", () => {
         });
       }
     }, 10000);
+
+    it("should handle timezone parameter with relative dates", async () => {
+      const result = await server["handleToolCall"]({
+        params: {
+          name: "get_events",
+          arguments: {
+            beginning_date_relative: "today",
+            timezone: "America/New_York",
+            limit: 5,
+          },
+        },
+      });
+
+      const responseData = JSON.parse(result.content[0].text);
+
+      expect(responseData).toHaveProperty("events");
+      expect(responseData).toHaveProperty("total_events");
+      expect(responseData).toHaveProperty("api_info");
+      
+      // Should successfully handle timezone parameter (v2.1 API feature)
+      expect(typeof responseData.total_events).toBe("number");
+      expect(responseData.api_info.timezone_used).toBe("America/New_York");
+      expect(responseData.api_info.endpoint_version).toBe("2.1");
+    }, 10000);
+
+    it("should handle upcoming events with timezone", async () => {
+      const result = await server["handleToolCall"]({
+        params: {
+          name: "get_upcoming_events",
+          arguments: {
+            timezone: "Europe/London",
+            limit: 3,
+          },
+        },
+      });
+
+      const responseData = JSON.parse(result.content[0].text);
+
+      expect(responseData).toHaveProperty("events");
+      expect(responseData).toHaveProperty("api_info");
+      expect(responseData.api_info.timezone_used).toBe("Europe/London");
+    }, 10000);
+
+    it("should handle search with Pacific timezone", async () => {
+      const result = await server["handleToolCall"]({
+        params: {
+          name: "search_events",
+          arguments: {
+            query: "office",
+            timezone: "America/Los_Angeles",
+            limit: 2,
+          },
+        },
+      });
+
+      const responseData = JSON.parse(result.content[0].text);
+
+      expect(responseData).toHaveProperty("search_query");
+      expect(responseData.search_query).toBe("office");
+      expect(responseData).toHaveProperty("total_matches");
+    }, 10000);
+
+    it("should handle events by tag with timezone", async () => {
+      const result = await server["handleToolCall"]({
+        params: {
+          name: "get_events_by_tag",
+          arguments: {
+            tag: "ai",
+            time_range: "this_week",
+            timezone: "Asia/Tokyo",
+            limit: 3,
+          },
+        },
+      });
+
+      const responseData = JSON.parse(result.content[0].text);
+
+      expect(responseData).toHaveProperty("tag");
+      expect(responseData.tag).toBe("ai");
+      expect(responseData).toHaveProperty("time_range");
+      expect(responseData.time_range).toBe("this_week");
+    }, 10000);
   });
 
   describe("Error Handling with Real API", () => {

package/src/__tests__/server.test.ts

@@ -32,7 +32,7 @@ describe("EventsServer", () => {
     it("should initialize with correct server name and version", () => {
       expect(server).toBeDefined();
       expect(server["serverName"]).toBe("access-mcp-events");
-      expect(server["version"]).toBe("0.1.0");
+      expect(server["version"]).toBe("0.2.0");
       expect(server["baseURL"]).toBe("https://support.access-ci.org");
     });
 
@@ -64,6 +64,11 @@ describe("EventsServer", () => {
   });
 
   describe("URL Building", () => {
+    it("should build correct URLs with v2.1 endpoint", () => {
+      const url = server["buildEventsUrl"]({});
+      expect(url).toContain("/api/2.1/events");
+    });
+
     it("should build correct URLs with relative date filters", () => {
       const url = server["buildEventsUrl"]({
         beginning_date_relative: "today",
@@ -74,6 +79,16 @@ describe("EventsServer", () => {
       expect(url).toContain("end_date_relative=%2B1week");
     });
 
+    it("should build correct URLs with timezone parameter", () => {
+      const url = server["buildEventsUrl"]({
+        beginning_date_relative: "today",
+        timezone: "America/New_York",
+      });
+
+      expect(url).toContain("beginning_date_relative=today");
+      expect(url).toContain("timezone=America%2FNew_York");
+    });
+
     it("should build correct URLs with absolute date filters", () => {
       const url = server["buildEventsUrl"]({
         beginning_date: "2024-01-01",
@@ -111,6 +126,66 @@ describe("EventsServer", () => {
       expect(url).toContain("f%5B0%5D=custom_event_type%3Awebinar");
       expect(url).toContain("f%5B1%5D=skill_level%3Aintermediate");
     });
+
+    it("should build correct URLs with timezone and mixed parameters", () => {
+      const url = server["buildEventsUrl"]({
+        beginning_date_relative: "today",
+        end_date_relative: "+1month",
+        timezone: "Europe/Berlin",
+        event_type: "workshop",
+      });
+
+      expect(url).toContain("beginning_date_relative=today");
+      expect(url).toContain("end_date_relative=%2B1month");
+      expect(url).toContain("timezone=Europe%2FBerlin");
+      expect(url).toContain("f%5B0%5D=custom_event_type%3Aworkshop");
+    });
+
+    it("should not include timezone parameter when not provided", () => {
+      const url = server["buildEventsUrl"]({
+        beginning_date_relative: "today",
+      });
+
+      expect(url).toContain("beginning_date_relative=today");
+      expect(url).not.toContain("timezone=");
+    });
+
+    it("should handle various timezone formats", () => {
+      const timezones = [
+        "UTC",
+        "America/New_York",
+        "America/Los_Angeles", 
+        "Europe/London",
+        "Asia/Tokyo"
+      ];
+
+      timezones.forEach(tz => {
+        const url = server["buildEventsUrl"]({
+          beginning_date_relative: "today",
+          timezone: tz,
+        });
+        expect(url).toContain(`timezone=${encodeURIComponent(tz)}`);
+      });
+    });
+
+    it("should include search_api_fulltext parameter", () => {
+      const url = server["buildEventsUrl"]({
+        search_api_fulltext: "python machine learning",
+        beginning_date_relative: "today",
+      });
+
+      expect(url).toContain("search_api_fulltext=python+machine+learning");
+      expect(url).toContain("beginning_date_relative=today");
+    });
+
+    it("should not include search parameter when not provided", () => {
+      const url = server["buildEventsUrl"]({
+        beginning_date_relative: "today",
+      });
+
+      expect(url).not.toContain("search_api_fulltext");
+      expect(url).toContain("beginning_date_relative=today");
+    });
   });
 
   describe("Tool Methods", () => {
@@ -273,6 +348,68 @@ describe("EventsServer", () => {
         expect(responseData.popular_tags).toContain("python");
         expect(responseData.popular_tags).toContain("machine-learning");
       });
+
+      it("should include timezone parameter in URL when provided", async () => {
+        mockHttpClient.get.mockResolvedValue({
+          status: 200,
+          data: mockEventsData,
+        });
+
+        const result = await server["handleToolCall"]({
+          params: {
+            name: "get_events",
+            arguments: {
+              beginning_date_relative: "today",
+              timezone: "America/New_York",
+            },
+          },
+        });
+
+        const calledUrl = mockHttpClient.get.mock.calls[0][0];
+        expect(calledUrl).toContain("timezone=America%2FNew_York");
+        expect(calledUrl).toContain("beginning_date_relative=today");
+      });
+
+      it("should include API info with timezone used", async () => {
+        mockHttpClient.get.mockResolvedValue({
+          status: 200,
+          data: mockEventsData,
+        });
+
+        const result = await server["handleToolCall"]({
+          params: {
+            name: "get_events",
+            arguments: {
+              beginning_date_relative: "today",
+              timezone: "Europe/London",
+            },
+          },
+        });
+
+        const responseData = JSON.parse(result.content[0].text);
+        expect(responseData.api_info).toBeDefined();
+        expect(responseData.api_info.endpoint_version).toBe("2.1");
+        expect(responseData.api_info.timezone_used).toBe("Europe/London");
+      });
+
+      it("should default to UTC timezone when not specified", async () => {
+        mockHttpClient.get.mockResolvedValue({
+          status: 200,
+          data: mockEventsData,
+        });
+
+        const result = await server["handleToolCall"]({
+          params: {
+            name: "get_events",
+            arguments: {
+              beginning_date_relative: "today",
+            },
+          },
+        });
+
+        const responseData = JSON.parse(result.content[0].text);
+        expect(responseData.api_info.timezone_used).toBe("UTC");
+      });
     });
 
     describe("get_upcoming_events", () => {
@@ -314,6 +451,27 @@ describe("EventsServer", () => {
         const calledUrl = mockHttpClient.get.mock.calls[0][0];
         expect(calledUrl).toContain("custom_event_type%3Awebinar");
       });
+
+      it("should pass timezone parameter to get_events", async () => {
+        mockHttpClient.get.mockResolvedValue({
+          status: 200,
+          data: mockEventsData,
+        });
+
+        const result = await server["handleToolCall"]({
+          params: {
+            name: "get_upcoming_events",
+            arguments: {
+              timezone: "America/Chicago",
+              limit: 5,
+            },
+          },
+        });
+
+        const calledUrl = mockHttpClient.get.mock.calls[0][0];
+        expect(calledUrl).toContain("beginning_date_relative=today");
+        expect(calledUrl).toContain("timezone=America%2FChicago");
+      });
     });
 
     describe("search_events", () => {
@@ -338,7 +496,7 @@ describe("EventsServer", () => {
         expect(responseData.events[0].title).toContain("Python");
       });
 
-      it("should search events by query in description", async () => {
+      it("should use API native search instead of client-side filtering", async () => {
         mockHttpClient.get.mockResolvedValue({
           status: 200,
           data: mockEventsData,
@@ -353,12 +511,16 @@ describe("EventsServer", () => {
           },
         });
 
+        const calledUrl = mockHttpClient.get.mock.calls[0][0];
+        expect(calledUrl).toContain("search_api_fulltext=ML");
+        
         const responseData = JSON.parse(result.content[0].text);
-        expect(responseData.total_matches).toBe(1);
-        expect(responseData.events[0].description).toContain("ML");
+        expect(responseData.search_query).toBe("ML");
+        expect(responseData.search_method).toBe("API native full-text search");
+        expect(responseData.total_matches).toBe(mockEventsData.length); // API returns raw count
       });
 
-      it("should search events by query in tags", async () => {
+      it("should include search scope information", async () => {
         mockHttpClient.get.mockResolvedValue({
           status: 200,
           data: mockEventsData,
@@ -373,8 +535,11 @@ describe("EventsServer", () => {
           },
         });
 
+        const calledUrl = mockHttpClient.get.mock.calls[0][0];
+        expect(calledUrl).toContain("search_api_fulltext=machine-learning");
+        
         const responseData = JSON.parse(result.content[0].text);
-        expect(responseData.total_matches).toBe(1);
+        expect(responseData.search_scope).toBe("titles, descriptions, speakers, tags, location, event type");
       });
 
       it("should search with custom date range", async () => {
@@ -397,6 +562,27 @@ describe("EventsServer", () => {
         const calledUrl = mockHttpClient.get.mock.calls[0][0];
         expect(calledUrl).toContain("beginning_date_relative=-1month");
       });
+
+      it("should include timezone parameter in search", async () => {
+        mockHttpClient.get.mockResolvedValue({
+          status: 200,
+          data: mockEventsData,
+        });
+
+        const result = await server["handleToolCall"]({
+          params: {
+            name: "search_events",
+            arguments: {
+              query: "python",
+              timezone: "Asia/Tokyo",
+            },
+          },
+        });
+
+        const calledUrl = mockHttpClient.get.mock.calls[0][0];
+        expect(calledUrl).toContain("timezone=Asia%2FTokyo");
+        expect(calledUrl).toContain("beginning_date_relative=today");
+      });
     });
 
     describe("get_events_by_tag", () => {
@@ -487,6 +673,30 @@ describe("EventsServer", () => {
         expect(calledUrl).not.toContain("beginning_date_relative");
         expect(calledUrl).not.toContain("end_date_relative");
       });
+
+      it("should include timezone parameter for time-based ranges", async () => {
+        mockHttpClient.get.mockResolvedValue({
+          status: 200,
+          data: mockEventsData,
+        });
+
+        const result = await server["handleToolCall"]({
+          params: {
+            name: "get_events_by_tag",
+            arguments: {
+              tag: "ai",
+              time_range: "this_week",
+              timezone: "Australia/Sydney",
+            },
+          },
+        });
+
+        const calledUrl = mockHttpClient.get.mock.calls[0][0];
+        expect(calledUrl).toContain("custom_event_tags%3Aai");
+        expect(calledUrl).toContain("beginning_date_relative=today");
+        expect(calledUrl).toContain("end_date_relative=%2B1week");
+        expect(calledUrl).toContain("timezone=Australia%2FSydney");
+      });
     });
 
     describe("Error Handling", () => {

package/src/server.ts

@@ -5,7 +5,7 @@ export class EventsServer extends BaseAccessServer {
   private _eventsHttpClient?: AxiosInstance;
 
   constructor() {
-    super("access-mcp-events", "0.1.0", "https://support.access-ci.org");
+    super("access-mcp-events", "0.2.0", "https://support.access-ci.org");
   }
 
   protected get httpClient(): AxiosInstance {
@@ -35,7 +35,7 @@ export class EventsServer extends BaseAccessServer {
       {
         name: "get_events",
         description:
-          "Get ACCESS-CI events with comprehensive filtering capabilities",
+          "Get ACCESS-CI events with comprehensive filtering capabilities. Returns events in UTC timezone with enhanced metadata.",
         inputSchema: {
           type: "object",
           properties: {
@@ -43,7 +43,7 @@ export class EventsServer extends BaseAccessServer {
             beginning_date_relative: {
               type: "string",
               description:
-                "Start date using relative values (today, +1week, -1month, etc.)",
+                "Start date using relative values. Calculated in UTC by default, or use 'timezone' parameter for local calculations.",
               enum: [
                 "today",
                 "+1week",
@@ -59,7 +59,7 @@ export class EventsServer extends BaseAccessServer {
             end_date_relative: {
               type: "string",
               description:
-                "End date using relative values (today, +1week, -1month, etc.)",
+                "End date using relative values. Calculated in UTC by default, or use 'timezone' parameter for local calculations.",
               enum: [
                 "today",
                 "+1week",
@@ -76,12 +76,19 @@ export class EventsServer extends BaseAccessServer {
             beginning_date: {
               type: "string",
               description:
-                "Start date in YYYY-MM-DD or YYYY-MM-DD HH:MM:SS format",
+                "Start date in YYYY-MM-DD or YYYY-MM-DD HH:MM:SS format. Always interpreted as provided (no timezone conversion).",
             },
             end_date: {
               type: "string",
               description:
-                "End date in YYYY-MM-DD or YYYY-MM-DD HH:MM:SS format",
+                "End date in YYYY-MM-DD or YYYY-MM-DD HH:MM:SS format. Always interpreted as provided (no timezone conversion).",
+            },
+            // Timezone parameter for relative date calculations
+            timezone: {
+              type: "string",
+              description:
+                "Timezone for relative date calculations (default: UTC). Common values: UTC, America/New_York (Eastern), America/Chicago (Central), America/Denver (Mountain), America/Los_Angeles (Pacific), Europe/London (British), Europe/Berlin (CET). Only affects relative dates, not absolute dates. Invalid timezones default to UTC.",
+              default: "UTC",
             },
             // Faceted search filters
             event_type: {
@@ -116,7 +123,7 @@ export class EventsServer extends BaseAccessServer {
       },
       {
         name: "get_upcoming_events",
-        description: "Get upcoming ACCESS-CI events (today onward)",
+        description: "Get upcoming ACCESS-CI events (from today onward in UTC). Convenient shortcut for get_events with beginning_date_relative=today.",
         inputSchema: {
           type: "object",
           properties: {
@@ -128,7 +135,12 @@ export class EventsServer extends BaseAccessServer {
             },
             event_type: {
               type: "string",
-              description: "Filter by event type (workshop, webinar, etc.)",
+              description: "Filter by event type (workshop, webinar, Office Hours, Training, etc.)",
+            },
+            timezone: {
+              type: "string",
+              description: "Timezone for 'today' calculation (default: UTC). Use user's local timezone for better relevance.",
+              default: "UTC",
             },
           },
           required: [],
@@ -136,19 +148,24 @@ export class EventsServer extends BaseAccessServer {
       },
       {
         name: "search_events",
-        description: "Search events by keywords in title and description",
+        description: "Search events using API's native full-text search. Searches across titles, descriptions, speakers, tags, location, and event type. Much more powerful than tag filtering.",
         inputSchema: {
           type: "object",
           properties: {
             query: {
               type: "string",
-              description: "Search query for event titles and descriptions",
+              description: "Search query (case-insensitive). Use spaces for multiple words (e.g., 'machine learning', 'office hours'). Searches across all event content including descriptions.",
             },
             beginning_date_relative: {
               type: "string",
-              description: "Start date using relative values (default: today)",
+              description: "Start date using relative values (default: today). Use '-1month' or '-1year' to search past events, or omit for all-time search.",
               default: "today",
             },
+            timezone: {
+              type: "string",
+              description: "Timezone for relative date calculation (default: UTC)",
+              default: "UTC",
+            },
             limit: {
               type: "number",
               description: "Maximum number of events to return (default: 25)",
@@ -161,21 +178,26 @@ export class EventsServer extends BaseAccessServer {
       },
       {
         name: "get_events_by_tag",
-        description: "Get events filtered by specific tags",
+        description: "Get events filtered by specific tags. Useful for finding events on topics like 'python', 'ai', 'machine-learning', 'gpu', etc.",
         inputSchema: {
           type: "object",
           properties: {
             tag: {
               type: "string",
               description:
-                "Event tag to filter by (e.g., python, machine-learning, gpu)",
+                "Event tag to filter by. Common tags: python, ai, machine-learning, gpu, deep-learning, neural-networks, big-data, hpc, jetstream, neocortex",
             },
             time_range: {
               type: "string",
-              description: "Time range for events",
+              description: "Time range for events (upcoming=today onward, this_week=next 7 days, this_month=next 30 days, all=no date filter)",
               enum: ["upcoming", "this_week", "this_month", "all"],
               default: "upcoming",
             },
+            timezone: {
+              type: "string",
+              description: "Timezone for time_range calculations (default: UTC)",
+              default: "UTC",
+            },
             limit: {
               type: "number",
               description: "Maximum number of events to return (default: 25)",
@@ -301,7 +323,12 @@ export class EventsServer extends BaseAccessServer {
   }
 
   private buildEventsUrl(params: any): string {
-    const url = new URL("/api/2.0/events", this.baseURL);
+    const url = new URL("/api/2.1/events", this.baseURL);
+
+    // Add full-text search parameter (API native search)
+    if (params.search_api_fulltext) {
+      url.searchParams.set("search_api_fulltext", params.search_api_fulltext);
+    }
 
     // Add date filtering parameters
     if (params.beginning_date_relative) {
@@ -320,6 +347,11 @@ export class EventsServer extends BaseAccessServer {
       url.searchParams.set("end_date", params.end_date);
     }
 
+    // Add timezone parameter for relative date calculations
+    if (params.timezone) {
+      url.searchParams.set("timezone", params.timezone);
+    }
+
     // Add faceted search filters
     let filterIndex = 0;
     if (params.event_type) {
@@ -405,6 +437,11 @@ export class EventsServer extends BaseAccessServer {
       events_this_week: enhancedEvents.filter(
         (e: any) => e.starts_in_hours <= 168 && e.starts_in_hours >= 0,
       ).length,
+      api_info: {
+        endpoint_version: "2.1",
+        timezone_handling: "All timestamps in UTC (Z suffix). Relative dates calculated using timezone parameter (default: UTC).",
+        timezone_used: params.timezone || "UTC",
+      },
       event_types: [
         ...new Set(
           enhancedEvents.map((e: any) => e.event_type).filter(Boolean),
@@ -439,35 +476,34 @@ export class EventsServer extends BaseAccessServer {
       ...params,
       beginning_date_relative: "today",
       limit: params.limit || 50,
+      // Pass through timezone if provided
+      ...(params.timezone && { timezone: params.timezone }),
     };
 
     return this.getEvents(upcomingParams);
   }
 
   private async searchEvents(params: any) {
+    // Use API's native full-text search instead of client-side filtering
     const searchParams = {
+      search_api_fulltext: params.query,
       beginning_date_relative: params.beginning_date_relative || "today",
       limit: params.limit || 25,
+      // Pass through timezone if provided
+      ...(params.timezone && { timezone: params.timezone }),
     };
 
-    // Get events and filter by search query
+    // Use the API's native search capabilities
     const eventsResponse = await this.getEvents(searchParams);
     const eventsData = JSON.parse(eventsResponse.content[0].text);
 
-    const query = params.query.toLowerCase();
-    const filteredEvents = eventsData.events.filter(
-      (event: any) =>
-        event.title?.toLowerCase().includes(query) ||
-        event.description?.toLowerCase().includes(query) ||
-        event.speakers?.toLowerCase().includes(query) ||
-        event.tags?.some((tag: string) => tag.toLowerCase().includes(query)),
-    );
-
+    // API returns already filtered results, no need for client-side filtering
     const summary = {
       search_query: params.query,
-      total_matches: filteredEvents.length,
-      searched_in: eventsData.total_events,
-      events: filteredEvents,
+      total_matches: eventsData.total_events,
+      search_method: "API native full-text search",
+      search_scope: "titles, descriptions, speakers, tags, location, event type",
+      events: eventsData.events,
     };
 
     return {
@@ -481,7 +517,7 @@ export class EventsServer extends BaseAccessServer {
   }
 
   private async getEventsByTag(params: any) {
-    const { tag, time_range = "upcoming", limit = 25 } = params;
+    const { tag, time_range = "upcoming", limit = 25, timezone } = params;
 
     let dateParams: any = {};
     switch (time_range) {
@@ -505,6 +541,8 @@ export class EventsServer extends BaseAccessServer {
       ...dateParams,
       event_tags: tag,
       limit,
+      // Pass through timezone if provided
+      ...(timezone && { timezone }),
     };
 
     const eventsResponse = await this.getEvents(taggedParams);