# Hora del servidor

> Devuelve la marca de tiempo actual del servidor (ISO-8601 UTC, epoch Unix) y la zona horaria solicitada.



{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}

|                     |                                                                    |
| ------------------- | ------------------------------------------------------------------ |
| **Tool ID**         | `core.timestamp.now`                                               |
| **Nombre MCP**      | `core__timestamp__now`                                             |
| **Conector**        | `core`                                                             |
| **Plano**           | `action`                                                           |
| **Scope (permiso)** | `core:read`                                                        |
| **Auth**            | `none`                                                             |
| **Versión**         | `1`                                                                |
| **Sensible**        | no                                                                 |
| **Deprecado**       | no                                                                 |
| **Comportamiento**  | readOnly=true, destructive=false, idempotent=true, openWorld=false |

## Qué hace [#qué-hace]

Prueba el camino E2E; no requiere credenciales.

## Entrada [#entrada]

| Campo      | Tipo   | Requerido            | Descripción                     |
| ---------- | ------ | -------------------- | ------------------------------- |
| `timezone` | string | no · default `"UTC"` | IANA tz, p.ej. America/Santiago |

<details>
  <summary>
    JSON Schema de entrada
  </summary>

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "timezone": {
        "default": "UTC",
        "description": "IANA tz, p.ej. America/Santiago",
        "type": "string"
      }
    }
  }
  ```
</details>

## Ejemplo [#ejemplo]

```bash title="curl"
curl -X POST https://connect.emisso.ai/api/v1/tools/core.timestamp.now/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "Content-Type: application/json" \
  -d '{"input":{"timezone":"America/Santiago"}}'
```

```ts title="SDK TypeScript"
const data = await connect.tools.core.timestamp.now({ timezone: "America/Santiago" });
```

```json title="MCP · meta-tool execute"
{
  "tool": "core.timestamp.now",
  "params": {
    "timezone": "America/Santiago"
  }
}
```

**Salida esperada (200):**

```json
{
  "data": {
    "iso": "2026-08-07T14:32:11.412Z",
    "unix": 1786113131,
    "timezone": "America/Santiago"
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "core.timestamp.now",
    "plane": "action",
    "latency_ms": 24,
    "audit_status": "recorded"
  }
}
```

> El iso siempre viene en UTC; timezone solo confirma la zona pedida.

## Salida [#salida]

| Campo      | Tipo   | Requerido | Descripción                                                                               |
| ---------- | ------ | --------- | ----------------------------------------------------------------------------------------- |
| `iso`      | string | sí        | La hora del servidor en ISO 8601, SIEMPRE en UTC. No se convierte a la zona que pediste.  |
| `unix`     | entero | sí        | La misma hora como epoch Unix, en segundos.                                               |
| `timezone` | string | sí        | Eco de la zona horaria que pediste. Confirma qué se recibió; no cambia el valor de 'iso'. |

<details>
  <summary>
    JSON Schema de salida
  </summary>

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "iso": {
        "type": "string",
        "description": "La hora del servidor en ISO 8601, SIEMPRE en UTC. No se convierte a la zona que pediste."
      },
      "unix": {
        "type": "integer",
        "minimum": -9007199254740991,
        "maximum": 9007199254740991,
        "description": "La misma hora como epoch Unix, en segundos."
      },
      "timezone": {
        "type": "string",
        "description": "Eco de la zona horaria que pediste. Confirma qué se recibió; no cambia el valor de 'iso'."
      }
    },
    "required": [
      "iso",
      "unix",
      "timezone"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Errores de esta tool [#errores-de-esta-tool]

Toda llamada puede devolver además los códigos transversales (`validation_error`, `unauthorized`, `scope_not_granted`, `rate_limited`, entre otros): el detalle vive en el [catálogo de errores](../errores).