{
  "name": "time.add",
  "group": "time",
  "summary": "Add or subtract a duration from a date, calendar-aware.",
  "description": "Adds years, months, weeks, days, hours, minutes and seconds to an instant. Calendar units (years, months, weeks, days) move wall-clock time and clamp overflow — Jan 31 plus one month is Feb 28 or 29, never Mar 3. Clock units (hours, minutes, seconds) add exact elapsed time and therefore cross DST boundaries.",
  "keywords": [
    "date math",
    "add days",
    "subtract months",
    "deadline",
    "due date",
    "date arithmetic"
  ],
  "endpoint": "https://fluentedi.com/v1/time/add",
  "mcp_name": "time_add",
  "makes_network_request": false,
  "parameters": {
    "type": "object",
    "properties": {
      "time": {
        "description": "Starting instant: ISO 8601, unix timestamp, or \"now\".",
        "type": "string",
        "default": "now"
      },
      "timezone": {
        "description": "IANA timezone identifier, e.g. \"UTC\", \"America/New_York\", \"Asia/Kolkata\", \"Europe/London\".",
        "type": "string",
        "default": "UTC",
        "examples": [
          "America/New_York"
        ]
      },
      "years": {
        "description": "Years to add (negative subtracts).",
        "type": "integer",
        "default": 0
      },
      "months": {
        "description": "Months to add (negative subtracts). Day-of-month is clamped.",
        "type": "integer",
        "default": 0
      },
      "weeks": {
        "description": "Weeks to add (negative subtracts).",
        "type": "integer",
        "default": 0
      },
      "days": {
        "description": "Calendar days to add (negative subtracts).",
        "type": "integer",
        "default": 0
      },
      "hours": {
        "description": "Exact hours to add (negative subtracts).",
        "type": "number",
        "default": 0
      },
      "minutes": {
        "description": "Exact minutes to add (negative subtracts).",
        "type": "number",
        "default": 0
      },
      "seconds": {
        "description": "Exact seconds to add (negative subtracts).",
        "type": "number",
        "default": 0
      },
      "business_days": {
        "description": "Weekdays to add, skipping Saturday and Sunday.",
        "type": "integer",
        "default": 0
      }
    },
    "required": [],
    "additionalProperties": false
  },
  "examples": [
    {
      "description": "90 days from now",
      "url": "https://fluentedi.com/v1/time/add?days=90",
      "args": {
        "days": 90
      }
    },
    {
      "description": "Net-30 invoice due date",
      "url": "https://fluentedi.com/v1/time/add?time=2026-08-22&days=30&timezone=America%2FNew_York",
      "args": {
        "time": "2026-08-22",
        "days": 30,
        "timezone": "America/New_York"
      }
    },
    {
      "description": "Five business days out",
      "url": "https://fluentedi.com/v1/time/add?business_days=5",
      "args": {
        "business_days": 5
      }
    },
    {
      "description": "One month before a launch",
      "url": "https://fluentedi.com/v1/time/add?time=2026-03-31&months=-1",
      "args": {
        "time": "2026-03-31",
        "months": -1
      }
    }
  ],
  "suggestion": null
}