{"uid":"cap_lIcJ7jXR7Ewa5WoX3Fbu9","slug":"natural-date-parse-cfc2b99a","name":"Natural Date Parse","description":"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.","url":"https://natural-date-parse.x402supply.com/mcp?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ApZ58cLMWW9Qijj5aja_Z","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Scheduling assistant parsing meeting invites","prompt":"I just got an email that says 'Let's sync the last Friday of next month from 2pm to 4pm EST and follow up in three business days' — can you extract all the dates and resolve them to exact ISO 8601 timestamps so I can add them to my calendar?"},{"title":"Contract clause temporal extraction","prompt":"Parse this contract clause for every date or deadline: 'Payment is due within 30 days of invoice, with a 15-day grace period expiring on December 31st' — resolve each to an absolute date relative to today in UTC."},{"title":"Journalist article date normalization","prompt":"I have a news article full of relative dates like 'yesterday', 'last Tuesday', and 'three months ago' written on June 5, 2025 — can you find every temporal expression and give me the exact resolved date with confidence scores and any ambiguity flags?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:34:42.203Z","isFirstParty":false,"canonicalSlug":"natural-date-parse-0c224320"}