Get Users Current Time / Date by Apoth3osis

Name: Get Users Current Time / Date
Brand: Apoth3osis
SKU: 6987b3363a2127a981e41238
Price: 0.03 USD
Availability: InStock

Get Users Current Time / Date

Core Utility

Available ActionsEach successful request consumes credits as outlined below.

get_current_datetime^3cr

Details

Agents running in the cloud don't know what timezone their users are in. This tool returns the current date and time in the user's configured timezone so agents can schedule, format, and reason about time using the user's local context. The tool returns both local and UTC timestamps, the timezone name, and useful derived fields such as local date, local time, and UTC offset. This enables time aware workflows like reminders, deadlines, and calendar or messaging logic without repeatedly asking the user what time zone they are in.

Workflows Using This Tool

Workflow

Saves ~45 min

Appointment Scheduling and Route Planner

+1 more tool

Takes a CSV or spreadsheet file with addresses, asks for a starting drive time, time per stop, and starting address, then parses the addresses, optimizes the driving route, calculates estimated arrival and departure times for each location, and generates a CSV with the full schedule. Returns the optimized route map, Google Maps directions link, and the schedule CSV both locally and via notification. Ideal for field sales, service technicians, delivery planning, or any multi-stop appointment scheduling.

Use Cases

Get current local time for a user, Build time aware reminders, Schedule messages in the user timezone, Add local timestamps to logs, Convert between UTC and user local time, Validate timezone configuration, Generate date strings for reports

Dynamic MCP Setup

Connect once through AgentPMT Dynamic MCP, then use approved tools from the same agent connection.

30 Second Setup

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections.

npm install -g @agentpmt/mcp-routeragentpmt-setup

Hosted Streamable HTTPS

MCP endpoint for browser-based apps like ChatGPT, Claude, Grok, or any time you want a streamable connection with no local install.

https://api.agentpmt.com/mcp

Config Example

Use the hosted endpoint directly in clients that support remote MCP. Store your Bearer token in the client config or secret field.

Full connection guide

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

Need client videos, organization controls, audit details, and the full feature overview?

More About Dynamic MCP

Credentials

User Timezone *

Select your IANA timezone (e.g. US/Eastern, Europe/London, Asia/Tokyo).

other

Manage credentials in your dashboard.

Actions(1)

get_current_datetime^3cr0 params

Returns the current local datetime, UTC datetime, and derived fields (local date, local time, UTC offset, DST status) based on the user's configured timezone.

No parameters for this action.

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -d '{
    "product_id": "6987b3363a2127a981e41238",
    "parameters": {
      "action": "get_current_datetime"
    }
  }'

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "6987b3363a2127a981e41238",
    "parameters": {
        "action": "get_current_datetime"
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "6987b3363a2127a981e41238",
  parameters: {
    "action": "get_current_datetime"
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "6987b3363a2127a981e41238",
  parameters: {
    "action": "get_current_datetime"
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

Usage Instructions

Usage guidance provided directly by the developer for this product.

User Timezone DateTime

Returns the current date and time based on the user's configured timezone setting. Uses IANA timezone names (e.g., "America/New_York", "Europe/London") to provide accurate local time with UTC offset, DST detection, and formatted date/time components.

Actions

get_current_datetime

Returns the current local datetime, UTC datetime, and derived fields for the user's configured timezone.

Required Parameters: None (timezone is automatically injected from the user's account settings)

Response Fields:

timezone (string) -- IANA timezone name used (e.g., "America/Chicago")
utc_datetime (string) -- Current UTC datetime in ISO 8601 format
local_datetime (string) -- Current local datetime in ISO 8601 format
local_date (string) -- Local date in YYYY-MM-DD format
local_time (string) -- Local time in HH:MM:SS format
utc_offset (string) -- UTC offset formatted as "+HH:MM" or "-HH:MM"
utc_offset_minutes (integer) -- UTC offset in total minutes
is_dst (boolean or null) -- Whether daylight saving time is currently active

Example Request:

{
  "action": "get_current_datetime"
}

Example Response:

{
  "action": "get_current_datetime",
  "timezone": "America/New_York",
  "utc_datetime": "2026-03-10T18:30:00+00:00",
  "local_datetime": "2026-03-10T14:30:00-04:00",
  "local_date": "2026-03-10",
  "local_time": "14:30:00",
  "utc_offset": "-04:00",
  "utc_offset_minutes": -240,
  "is_dst": true
}

Workflows

Check current time before scheduling -- Call get_current_datetime to determine the user's current local time before creating calendar events or setting reminders.
Time-aware greetings -- Use local_time to provide contextual greetings (good morning/afternoon/evening) based on the user's actual local time.
Cross-timezone coordination -- Use utc_datetime and utc_offset together to help users coordinate meetings across different timezones.
DST awareness -- Check the is_dst field to inform users about daylight saving time status when scheduling recurring events.

Notes

The user's timezone is automatically provided from their account settings; no manual timezone input is needed.
If the user has not configured a timezone, the request will fail with a validation error ("User timezone is required").
All IANA timezone names are supported (e.g., "US/Eastern", "Asia/Tokyo", "Pacific/Auckland").
The is_dst field may return null for timezones that do not observe daylight saving time.
UTC offset is provided in both human-readable string format and numeric minutes for programmatic use.

Frequently Asked Questions

How do I connect this tool to an external agent?

You can install the local MCP server by opening a terminal and running:

Install commands

npm install -g @agentpmt/mcp-router
agentpmt-setup

This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc.

Alternatively you can connect to the hosted version with this config block, no installation required:

Hosted MCP config

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

View MCP Connection Instructions for more details.

How does an external agent use this tool?

After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent:

Agent prompt

Use the AgentPMT-Tool-Search-and-Execution tool. First call action 'get_instructions' so you know how to use the tool search interface. Then call action 'get_schema' with tool_id 6987b3363a2127a981e41238 ("Get Users Current Time / Date"). After reading the schema and any returned instructions, tell me what this tool can do, we are going to be using it

The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT.