# AgentTools Natural Date Parser

> AgentTools Natural Date Parser is a paid API for AI agents from agentstoolshub.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-12).

Converts natural-language date and time expressions into exact ISO 8601 timestamps using deterministic, rule-based parsing with a configurable reference moment.

## Facts

- Endpoint: GET https://agentstoolshub.com/api/v1/dev/natural-date?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenttools-natural-date-parser-a64e5347
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AOt8AElnf9ZW9J1dEpgDW

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agenttools-natural-date-parser-a64e5347
```

Example prompt: Parse 'next friday at 3pm' into an exact ISO 8601 date for me, using today as the reference point.

## When to prefer this

Use this endpoint when you need deterministic, rule-based parsing of natural-language date expressions without relying on an LLM's probabilistic interpretation. It is ideal for scheduling agents, form processors, or any workflow where consistent, reproducible datetime resolution is required. Prefer it over asking a general-purpose LLM to interpret dates, since LLMs may guess inconsistently across calls.

## Known failure modes

- Ambiguous or unrecognizable expression returns a parsing error or null result
- Missing required 'text' query parameter returns a 400 bad request
- Extremely locale-specific or highly informal expressions may not parse correctly
- Network timeout or service unavailability returns a 5xx error

## How this service works

Parse natural-language date and time expressions — "in two weeks", "next friday at 3pm", "dec 25th" — into exact ISO 8601 dates. Deterministic parsing (no LLM guessing); relative expressions resolve against a reference moment you control. Use this when an agent needs to "next friday 3pm" → exact ISO dates.

## Output

Returns an exact ISO 8601 datetime string resolved from the given natural-language expression. The relative reference point defaults to the current moment unless a custom reference datetime is supplied, ensuring deterministic and reproducible results.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "text"
     ],
     "properties": {
      "ref": {
       "type": "string",
       "description": "Defaults to now"
      },
      "text": {
       "type": "string",
       "description": "Expression"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agenttools-natural-date-parser-a64e5347/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentstoolshub.com](https://www.zero.xyz/host/agentstoolshub.com/llms.txt)