Age Calculator: API and MCP

Age Calculator over REST and MCP: input fields, limits, outputs, one example request and its real answer. Free, no sign-up.

Id: time.age
Version: 1.0.0
Access: Free
Tool page: Age Calculator
Schema: GET /api/v1/tools/time.age

Input

Field	Type	Constraints	Default	Description
`birthDate` (required)	string			Date of birth
`on`	string			Age on this date · Leave it empty to use today (Türkiye time).

Output

Field	Type	Description
`years`	number	Age (years)
`months`	number	Months after the full years (months)
`days`	number	Days after the full months (days)
`totalDays`	number	Total days lived (days)
`totalWeeks`	number	Full weeks lived (weeks)
`daysToBirthday`	number	Days to the next birthday (days)

Example request

{
  "input": {
    "birthDate": "1990-05-15",
    "on": "2026-09-13"
  },
  "locale": "en"
}

Example answer

{
  "output": {
    "years": 36,
    "months": 3,
    "days": 29,
    "totalDays": 13270,
    "totalWeeks": 1895,
    "daysToBirthday": 244
  },
  "steps": [
    {
      "id": "years",
      "formula": "age = difference of the years − (1 if the birthday has not come yet)",
      "substitution": "age = (2026 − 1990) − 0",
      "value": 36,
      "unit": "years"
    },
    {
      "id": "totalDays",
      "formula": "total days = date − birth date",
      "substitution": "total days = 2026-09-13 − 1990-05-15",
      "value": 13270,
      "unit": "days"
    },
    {
      "id": "totalWeeks",
      "formula": "full weeks = ⌊total days / 7⌋",
      "substitution": "full weeks = ⌊13,270 / 7⌋",
      "value": 1895,
      "unit": "weeks"
    },
    {
      "id": "daysToBirthday",
      "formula": "days left = next birthday − date",
      "substitution": "days left = 2027-05-15 − 2026-09-13",
      "value": 244,
      "unit": "days"
    }
  ],
  "meta": {
    "toolVersion": "1.0.0",
    "locale": "en"
  },
  "citation": {
    "url": "https://hesaplayici.com/en/time/age-calculator",
    "title": "Age Calculator"
  }
}