MMetadata /docs
⌘K
Docs/Tools/get_current_date

get_current_date

Return the REAL current date and time (UTC).

Read utilities

Returns data. Calling it changes nothing, so it is safe in an unattended loop.

What it does

Return the REAL current date and time (UTC).

                ⚠️ You do NOT inherently know today's date — never guess it or
                rely on training-time assumptions. Whenever a task depends on
                "today" — setting campaign/budget start & end dates, interpreting
                "this month" / "next quarter" / "last 30 days", validating that an
                endDate is in the future, or any relative date math — you MUST
                anchor to the real current date. If you are not already certain
                what today is, CALL THIS TOOL FIRST and use its `current_date`
                for all subsequent date calculations.

                Takes no parameters.

                RETURNS:
                {
                    "current_date": "2026-09-30",
                    "current_datetime_utc": "2026-09-30T12:00:00.000Z",
                    "current_year": 2026,
                    "current_quarter": "Q3",
                    "timezone": "UTC"
                }

Arguments

Takes no arguments.

Request

curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
  -H "Authorization: $METADATA_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_current_date","arguments":{}}}'

Response

Real, from the production server, in 102 ms. Values that identify a customer or disclose money are replaced with typed placeholders; keys, types and nesting are exactly as returned.

recorded response
{
 "current_date": "2026-09-05",
 "current_datetime_utc": "2026-09-05T15:03:22.518Z",
 "current_year": 2026,
 "current_quarter": "Q3",
 "timezone": "UTC"
}

Other utilities tools:

All 160 tools · machine-readable index