`convert_time`

Pack: timezone · Endpoint: https://gateway.pipeworx.io/timezone/mcp

Convert a datetime from one timezone to another. If no time is provided the current time is used.

Parameters

Name	Type	Required	Description
`from_timezone`	string	yes	Source IANA timezone, e.g. “America/New_York”
`to_timezone`	string	yes	Target IANA timezone, e.g. “Europe/Paris”
`time`	string	no	ISO 8601 datetime to convert (optional — defaults to now). E.g. “2024-06-15T14:30:00”

Example call

Arguments

{
  "from_timezone": "America/New_York",
  "to_timezone": "Europe/London"
}

curl

curl -X POST https://gateway.pipeworx.io/timezone/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"convert_time","arguments":{"from_timezone":"America/New_York","to_timezone":"Europe/London"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('convert_time', {
  "from_timezone": "America/New_York",
  "to_timezone": "Europe/London"
});

More examples

{
  "from_timezone": "America/Los_Angeles",
  "to_timezone": "Asia/Singapore",
  "time": "2024-06-15T14:30:00"
}

Response shape

Always returns: from_timezone, from_datetime, from_utc_offset, to_timezone, to_datetime, to_utc_offset, offset_difference

Field	Type	Description
`from_timezone`	string	Source timezone
`from_datetime`	string	Source datetime in ISO 8601 format
`from_utc_offset`	string	UTC offset of source timezone in ±HH:MM format
`to_timezone`	string	Target timezone
`to_datetime`	string	Converted datetime in ISO 8601 format
`to_utc_offset`	string	UTC offset of target timezone in ±HH:MM format
`offset_difference`	string	Difference in UTC offsets in ±HH:MM format

Full JSON Schema

{
  "type": "object",
  "properties": {
    "from_timezone": {
      "type": "string",
      "description": "Source timezone"
    },
    "from_datetime": {
      "type": "string",
      "description": "Source datetime in ISO 8601 format"
    },
    "from_utc_offset": {
      "type": "string",
      "description": "UTC offset of source timezone in ±HH:MM format"
    },
    "to_timezone": {
      "type": "string",
      "description": "Target timezone"
    },
    "to_datetime": {
      "type": "string",
      "description": "Converted datetime in ISO 8601 format"
    },
    "to_utc_offset": {
      "type": "string",
      "description": "UTC offset of target timezone in ±HH:MM format"
    },
    "offset_difference": {
      "type": "string",
      "description": "Difference in UTC offsets in ±HH:MM format"
    }
  },
  "required": [
    "from_timezone",
    "from_datetime",
    "from_utc_offset",
    "to_timezone",
    "to_datetime",
    "to_utc_offset",
    "offset_difference"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "timezone": {
      "url": "https://gateway.pipeworx.io/timezone/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

convert_time