# AgentTools Natural Date Parser

> AgentTools Natural Date Parser is a paid API for AI agents from agenttools-hub.vercel.app, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-02).

Parses natural-language date and time expressions into exact ISO 8601 dates using deterministic (non-LLM) logic, resolved against a configurable reference moment.

## Facts

- Endpoint: GET https://agenttools-hub.vercel.app/api/v1/dev/natural-date?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenttools-natural-date-parser-395eef07
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BVdoi4kfDD8XRM4J5Izud

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-395eef07
```

Example prompt: What exact ISO date and time does 'next friday at 3pm' resolve to? Use right now as the reference point.

## When to prefer this

Use this endpoint when an agent needs to deterministically resolve relative or ambiguous natural language date expressions (e.g. 'next friday', 'in two weeks') into exact ISO 8601 datetimes without relying on an LLM's potentially inconsistent date reasoning. Prefer this over prompting an LLM for date math, especially when precision and reproducibility matter for scheduling, reminders, or deadline parsing.

## Known failure modes

- Ambiguous or unrecognizable expression returns a parse error
- Missing required 'text' query parameter returns a 400-level error
- Malformed 'ref' timestamp may cause unexpected reference resolution
- Payment not sent or insufficient funds returns a 402 Payment Required response
- Expressions with no time component may default to midnight or start of day

## 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 representing the resolved date and time for the given natural language expression, calculated deterministically relative to the provided (or defaulted-to-now) reference timestamp.

## 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-395eef07/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agenttools-hub.vercel.app](https://www.zero.xyz/host/agenttools-hub.vercel.app/llms.txt)