DocsAPI ReferenceSDKsCookbookChangelog

For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://modelgates.ai/docs/_mcp/server.

Datetime

Server tools are currently in beta. The API and behavior may change.

The modelgates:datetime server tool gives any model access to the current date and time. This is useful for prompts that require temporal awareness — scheduling, time-sensitive questions, or any task where the model needs to know "right now."

Quick Start

typescript
const response = await fetch('https://modelgates.ai/api/v1/chat/completions', {  method: 'POST',  headers: {    Authorization: 'Bearer {{API_KEY_REF}}',    'Content-Type': 'application/json',  },  body: JSON.stringify({    model: '{{MODEL}}',    messages: [      {        role: 'user',        content: 'What day of the week is it today?'      }    ],    tools: [      { type: 'modelgates:datetime' }    ]  }),}); const data = await response.json();console.log(data.choices[0].message.content);

Configuration

The datetime tool accepts an optional timezone parameter:

json
{  "type": "modelgates:datetime",  "parameters": {    "timezone": "America/New_York"  }}
ParameterTypeDefaultDescription
timezonestringUTCIANA timezone name (e.g. "America/New_York", "Europe/London", "Asia/Tokyo")

Response

When the model calls the datetime tool, it receives a response like:

json
{  "datetime": "2025-07-15T14:30:00.000-04:00",  "timezone": "America/New_York"}

Pricing

The datetime tool has no additional cost beyond standard token usage.

Next Steps