get_current_time

Get the current date and time in a given IANA timezone (e.g. 'Europe/Madrid', 'America/New_York', 'Asia/Tokyo'). Defaults to UTC. Use this whenever you need to know 'now' — you cannot know it otherwise.

Parameters1

timezone

string

optional

IANA timezone name. Defaults to 'UTC'.

Raw schema

{
  "type": "object",
  "properties": {
    "timezone": {
      "type": "string",
      "description": "IANA timezone name. Defaults to 'UTC'."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

convert_time

Convert a wall-clock date/time from one timezone to another. Give the time as it reads on the clock in `from_timezone`; get the equivalent instant in `to_timezone`. Handles DST automatically.

Parameters3

datetime	string	required	Wall-clock time, e.g. "2026-07-09 15:30" or "2026-07-09T15:30:00".
from_timezone	string	required	Source IANA timezone.
to_timezone	string	required	Target IANA timezone.

Raw schema

{
  "type": "object",
  "properties": {
    "datetime": {
      "type": "string",
      "description": "Wall-clock time, e.g. \"2026-07-09 15:30\" or \"2026-07-09T15:30:00\"."
    },
    "from_timezone": {
      "type": "string",
      "description": "Source IANA timezone."
    },
    "to_timezone": {
      "type": "string",
      "description": "Target IANA timezone."
    }
  },
  "required": [
    "datetime",
    "from_timezone",
    "to_timezone"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_time_difference

Get the current UTC-offset difference between two timezones, in hours (positive means timezone2 is ahead of timezone1).

Parameters2

timezone1	string	required	First IANA timezone.
timezone2	string	required	Second IANA timezone.

Raw schema

{
  "type": "object",
  "properties": {
    "timezone1": {
      "type": "string",
      "description": "First IANA timezone."
    },
    "timezone2": {
      "type": "string",
      "description": "Second IANA timezone."
    }
  },
  "required": [
    "timezone1",
    "timezone2"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_timezones

List or search valid IANA timezone names. Pass a query like 'paris' or 'america' to filter. Useful for finding the exact name to use elsewhere.

Parameters1

query

string

optional

Case-insensitive substring filter, e.g. 'tokyo'.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Case-insensitive substring filter, e.g. 'tokyo'."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

business_days_between

Count business days (Monday–Friday) between two dates, inclusive of both endpoints. Weekends are excluded; public holidays are not (calendar-only).

Parameters2

start_date	string	required	Start date "YYYY-MM-DD".
end_date	string	required	End date "YYYY-MM-DD".

Raw schema

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "description": "Start date \"YYYY-MM-DD\"."
    },
    "end_date": {
      "type": "string",
      "description": "End date \"YYYY-MM-DD\"."
    }
  },
  "required": [
    "start_date",
    "end_date"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Time MCP

get_current_time

convert_time

get_time_difference

list_timezones

business_days_between

Install

Remote endpoint