EVE Online EST MCP Server

Instructions

Implementation Reference

• src/server.ts:107-124 (handler)

  The MCP tool handler (execute function) for 'getCurrentESTTime'. It calls the core helper function and returns the result as formatted JSON, with error handling.

  execute: async () => {
    try {
      const timeInfo = await getCurrentESTTime();
      return JSON.stringify(timeInfo, null, 2);
    } catch (error) {
      const errorMessage =
        error instanceof Error ? error.message : String(error);
      return JSON.stringify(
        {
          error: "Failed to get current time",
          message: errorMessage,
          timestamp: new Date().toISOString(),
        },
        null,
        2,
      );
    }
  },

• src/server.ts:126-126 (schema)

  Zod schema defining the tool's input parameters: an empty object (no parameters required).

  parameters: z.object({}),

• src/server.ts:99-127 (registration)

  FastMCP tool registration for 'getCurrentESTTime', including annotations, description, handler (execute), name, and parameters schema.

  server.addTool({
    annotations: {
      openWorldHint: true, // May use external API as fallback
      readOnlyHint: true, // This tool doesn't modify anything
      title: "Get Current EVE Server Time",
    },
    description:
      "Get current EVE Server Time (EST) which is identical to UTC, and calculate time until next server downtime. EVE Online servers go offline daily from 11:00 to 11:15 EST (UTC) for maintenance. Uses system time with WorldTimeAPI as fallback.",
    execute: async () => {
      try {
        const timeInfo = await getCurrentESTTime();
        return JSON.stringify(timeInfo, null, 2);
      } catch (error) {
        const errorMessage =
          error instanceof Error ? error.message : String(error);
        return JSON.stringify(
          {
            error: "Failed to get current time",
            message: errorMessage,
            timestamp: new Date().toISOString(),
          },
          null,
          2,
        );
      }
    },
    name: "getCurrentESTTime",
    parameters: z.object({}),
  });

• src/server.ts:32-75 (helper)

  Core helper function that implements the logic for getting current EVE Server Time (EST/UTC), calculating time until next downtime, checking if currently in downtime, with time source info.

  async function getCurrentESTTime() {
    const { source: timeSource, time: now } = await getCurrentTime();
  
    // EVE Server Time is UTC
    const estTime = now.toISOString().replace("T", " ").substring(0, 19) + " EST";
  
    // Calculate time until next downtime (11:00 UTC)
    const downtimeHour = 11;
    const downtimeMinute = 0;
  
    // Create downtime date for today
    const nextDowntime = new Date(now);
    nextDowntime.setUTCHours(downtimeHour, downtimeMinute, 0, 0);
  
    // If current time is past today's downtime, set to tomorrow's downtime
    if (now >= nextDowntime) {
      nextDowntime.setUTCDate(nextDowntime.getUTCDate() + 1);
    }
  
    // Calculate time difference
    const timeDiff = nextDowntime.getTime() - now.getTime();
    const hoursUntilDowntime = Math.floor(timeDiff / (1000 * 60 * 60));
    const minutesUntilDowntime = Math.floor(
      (timeDiff % (1000 * 60 * 60)) / (1000 * 60),
    );
  
    // Check if server is currently in downtime (11:00-11:15 UTC)
    const currentHour = now.getUTCHours();
    const currentMinute = now.getUTCMinutes();
    const isInDowntime = currentHour === 11 && currentMinute < 15;
  
    return {
      currentTime: estTime,
      downtimeWindow: "11:00 to 11:15 EST (UTC)",
      isInDowntime,
      nextDowntimeStart:
        nextDowntime.toISOString().replace("T", " ").substring(0, 19) + " EST",
      timeSource,
      timeUntilNextDowntime: isInDowntime
        ? "Server is currently in downtime"
        : `${hoursUntilDowntime}h ${minutesUntilDowntime}m`,
      utcTime: now.toISOString(),
    };
  }

• src/server.ts:80-97 (helper)

  Helper function to retrieve current time, preferring system clock but falling back to WorldTimeAPI if invalid.

  async function getCurrentTime(): Promise<{ source: string; time: Date }> {
    try {
      const now = new Date();
      // Check if system time is valid (not NaN and reasonable)
      if (isNaN(now.getTime()) || now.getFullYear() < 2020) {
        throw new Error("System time appears invalid");
      }
      return { source: "system", time: now };
    } catch (error) {
      const errorMessage = error instanceof Error ? error.message : String(error);
      console.warn(
        "System time unavailable, falling back to WorldTimeAPI:",
        errorMessage,
      );
      const apiTime = await fetchTimeFromAPI();
      return { source: "worldtimeapi", time: apiTime };
    }
  }