# Natural Date Parse

> Natural Date Parse is a paid API for AI agents from natural-date-parse.x402supply.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-31).

Parses natural language text to extract and resolve all date, time, range, and period expressions into ISO 8601 values with UTC offsets, IANA timezone spans, and confidence scores.

## Facts

- Endpoint: POST https://natural-date-parse.x402supply.com/mcp?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/natural-date-parse-cfc2b99a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lIcJ7jXR7Ewa5WoX3Fbu9

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 natural-date-parse-cfc2b99a -d '<json body>'
```

Example prompt: Can you pull out every date and time from this email — 'The kickoff is scheduled for next Monday, Q3 review runs from July 1 to September 30, and the retrospective is in two weeks' — and give me each one as an ISO 8601 timestamp with timezone, relative to today in America/New_York?

## When to prefer this

Choose this endpoint when you need to extract multiple, heterogeneous temporal expressions from free-form text in a single pass, especially when ISO 8601 normalization, IANA timezone awareness, and per-match confidence scores are required. Prefer it over regex or simple date parsing libraries when the text contains mixed formats, relative references, date ranges, and named periods simultaneously.

## Known failure modes

- Ambiguous expressions (e.g. '04/05') flagged but not fully resolved — caller must handle ambiguity flag
- No temporal expressions found returns empty result list
- Unrecognized or highly informal date slang may yield low confidence scores
- Missing reference instant causes relative dates (e.g. 'tomorrow') to be unresolvable
- Invalid IANA timezone identifier results in error or fallback to UTC

## How this service works

Finds every date, time, range and period in text and resolves each to an ISO 8601 value with UTC offset plus a start/end span in an IANA timezone, relative to a reference instant. Reports matched text, index, ambiguity flags and confidence.

## Output

Returns a list of all detected temporal expressions in the input text, each with: the matched text snippet, its character index/span, the resolved ISO 8601 datetime value, UTC offset, start and end bounds in the specified IANA timezone, an ambiguity flag indicating whether the expression was underspecified, and a confidence score for the resolution.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "toolName",
    "inputSchema"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "mcp"
    },
    "toolName": {
     "type": "string"
    },
    "transport": {
     "enum": [
      "streamable-http"
     ],
     "type": "string"
    },
    "description": {
     "type": "string"
    },
    "inputSchema": {
     "type": "object"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

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