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);
python
import requests response = requests.post(  "https://modelgates.ai/api/v1/chat/completions",  headers={    "Authorization": f"Bearer {{API_KEY_REF}}",    "Content-Type": "application/json",  },  json={    "model": "{{MODEL}}",    "messages": [      {        "role": "user",        "content": "What day of the week is it today?"      }    ],    "tools": [      {"type": "modelgates:datetime"}    ]  }) data = response.json()print(data["choices"][0]["message"]["content"])
bash
curl https://modelgates.ai/api/v1/chat/completions \  -H "Authorization: Bearer {}" \  -H "Content-Type: application/json" \  -d '{    "model": "{{MODEL}}",    "messages": [      {        "role": "user",        "content": "What day of the week is it today?"      }    ],    "tools": [      {"type": "modelgates:datetime"}    ]  }'

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