Add time to a date

$0.003 per call · failed calls are never charged · no account or API key needed

Add (or subtract, with negative numbers) years, months, weeks, days, hours and minutes to a date, or add business days (skipping Saturdays and Sundays). Month ends are clamped (31 Jan + 1 month = 28/29 Feb). Use to compute due dates and expiries.

Run it free (25 free calls) Buy credits by card (from $5) Example result (JSON)

Inputs

NameTypeDescription
date (required)stringStart date or ISO timestamp
monthsintegerMonths to add
daysintegerDays to add
businessDaysintegerWeekdays to add (skips weekends)

Request

Over HTTP, with a card key from /credits:

curl -H "Authorization: Bearer adt_…" "https://agent-data-tools.revmesh2074.workers.dev/date/add?date=2026-01-31"

Or one of your 25 free calls, no key:

curl "https://agent-data-tools.revmesh2074.workers.dev/date/add?date=2026-01-31&trial=1"

Without a key, the same URL answers 402 Payment Required with x402 and MPP terms, so an agent with a wallet pays per call in USDC (Base, Polygon, Arbitrum, Monad, World Chain or Tempo) and retries.

Example result

{
  "result": "2026-02-28T00:00:00.000Z",
  "date": "2026-02-28",
  "weekday": "Saturday"
}

From an AI agent (MCP)

Add the MCP server to Claude, Cursor or any MCP client. This tool is date_add, and the first 25 successful calls are free:

https://agent-data-tools.revmesh2074.workers.dev/mcp

Related tools