{"uid":"cap_AOt8AElnf9ZW9J1dEpgDW","slug":"agenttools-natural-date-parser-a64e5347","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://agentstoolshub.com/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.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Dd1o_YCS2gzFLsJd9fUvS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts natural-language date and time expressions into exact ISO 8601 timestamps using deterministic, rule-based parsing with a configurable reference moment.","exampleAgentPrompt":"Parse 'next friday at 3pm' into an exact ISO 8601 date for me, using today as the reference point.","exampleUseCases":[{"title":"Scheduling a meeting from voice input","prompt":"The user said they want to meet 'in two weeks on Thursday afternoon' — can you turn that into an exact ISO 8601 datetime so I can create the calendar invite?"},{"title":"Booking deadline from relative expression","prompt":"Someone submitted a form saying the project is due 'end of next month' — parse that into a concrete ISO date so we can set the deadline in our system."},{"title":"Reminder parsing for a chatbot","prompt":"A user told our assistant 'remind me dec 25th at 8am' — convert that natural language expression to an exact ISO 8601 timestamp so we can schedule the notification."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:49:59.310Z","isFirstParty":false,"canonicalSlug":"agenttools-natural-date-parser-a64e5347"}