Time Tools MCP Server

Instructions

Implementation Reference

• src/index.ts:78-89 (handler)

  Handler function that takes a datetime string and optional timezone, parses it with dayjs, applies the timezone, and returns the Unix timestamp in milliseconds using valueOf().

      async ({ time, timezone }) => {
          const unixtime = dayjs(time).tz(getTZ(timezone)).valueOf();
          return {
              content: [
                  {
                      type: "text",
                      text: String(unixtime),
                  },
              ],
          };
      },
  );

• src/index.ts:74-77 (schema)

  Zod input schema defining 'time' as required string and 'timezone' as optional string.

  {
      time: z.string(),
      timezone: z.string().optional(),
  },

• src/index.ts:71-89 (registration)

  Registration of the 'convert_datetime_to_unix' tool using server.tool(), including name, description, schema, and inline handler.

  server.tool(
      "convert_datetime_to_unix",
      "Convert datetime time to unixtime (e.g. 2025-01-01 01:01:01 to 1746627290)",
      {
          time: z.string(),
          timezone: z.string().optional(),
      },
      async ({ time, timezone }) => {
          const unixtime = dayjs(time).tz(getTZ(timezone)).valueOf();
          return {
              content: [
                  {
                      type: "text",
                      text: String(unixtime),
                  },
              ],
          };
      },
  );

• src/index.ts:13-15 (helper)

  Helper function 'getTZ' that returns the provided timezone or guesses the local timezone using dayjs.tz.guess().

  const getTZ = (timezon?: string) => {
      return timezon || dayjs.tz.guess();
  };