Timeapi Io

liveReferenceDeveloper

TimeAPI.io — current time by timezone, coordinates, or IP; timezone conversion, zone info, and ISO date parsing.

9tools
0msauth
free tier50 calls/day

Tools

current_time

Return the current date and time for a given IANA timezone (e.g. America/New_York): year, month, day, hour, minute, second, millisecond, dayOfWeek, dstActive.

No parameters required.

▶Try it
current_time_coordinate

Current time at lat/lon.

No parameters required.

▶Try it
current_time_ip

Current time at IP.

No parameters required.

▶Try it
current_iso_zoned_date_time

Return the current date/time for a given IANA timezone as a full ISO 8601 zoned datetime string (e.g. 2026-06-24T10:30:00+02:00).

No parameters required.

▶Try it
current_zone_info

Return timezone metadata for an IANA zone name: UTC offset, DST offset, current offset, DST start/end, and whether DST is currently active.

No parameters required.

▶Try it
convert_time_zone

Convert datetime between zones.

No parameters required.

▶Try it
day_of_the_week

Day of week for a date.

No parameters required.

▶Try it
list_zones

Return all IANA timezone names supported by TimeAPI.io. Use as a directory to find valid timeZone strings for other calls.

No parameters required.

▶Try it
translate_to_iso

Parse custom-format date to ISO.

No parameters required.

▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/timeapi-io/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/timeapi-io/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"current_time","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("current_time", {});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("timeapi");