{"uid":"cap_BVdoi4kfDD8XRM4J5Izud","slug":"agenttools-natural-date-parser-395eef07","name":"AgentTools Natural Date Parser","description":"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.","url":"https://agenttools-hub.vercel.app/api/v1/dev/natural-date?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ktGn3l77VsThlISPDutmd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Parses natural-language date and time expressions into exact ISO 8601 dates using deterministic (non-LLM) logic, resolved against a configurable reference moment.","exampleAgentPrompt":"What exact ISO date and time does 'next friday at 3pm' resolve to? Use right now as the reference point.","exampleUseCases":[{"title":"Scheduling assistant date resolution","prompt":"The user said they want a meeting 'in two weeks at noon' — can you convert that to an exact ISO 8601 datetime so I can create the calendar invite?"},{"title":"Reminder app natural language input","prompt":"Parse 'dec 25th' into an exact ISO date for me so I can set up a Christmas day reminder — use today as the reference."},{"title":"Deadline parser for project management","prompt":"A task description says it's due 'next Monday end of day' — what's the exact ISO 8601 timestamp for that, treating right now as the reference moment?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T12:42:45.870Z","isFirstParty":false,"canonicalSlug":"agenttools-natural-date-parser-395eef07"}