# Age Calculate — REST API endpoint `age-calculate`

Calculate age from a date of birth — years, months, days, plus totals in days, weeks, and months. Accepts ISO 8601 or anything Date.parse handles.

- Category: datetime
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, no API keys, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/age-calculate/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/api/age-calculate/
- Same tool on the other surface: https://findutils.com/mcp/age-calculate/

## Call the endpoint (verified example)

```bash
curl -X POST https://api.findutils.com/api/tools/age-calculate/execute \
  -H "Content-Type: application/json" \
  -d '{
    "date_of_birth": "1990-06-15",
    "reference_date": "2026-04-18"
  }'

# Parameter schema
curl https://api.findutils.com/api/tools/age-calculate
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `date_of_birth` | string | yes | Date of birth (ISO 8601 preferred, e.g. 1990-04-18). |
| `reference_date` | string | no | Date to measure age against. Default: today (UTC). |

Example arguments (verified):

```json
{
  "date_of_birth": "1990-06-15",
  "reference_date": "2026-04-18"
}
```

OpenAPI 3.1 spec: https://findutils.com/api/openapi.json · Interactive docs: https://findutils.com/api/docs/

## Also an MCP tool

```bash
claude mcp add findutils --transport http https://mcp.findutils.com/
```

Then ask the client to call `findutils:age_calculate`. Full MCP reference: https://findutils.com/mcp/age-calculate/

---
Full catalog: GET https://api.findutils.com/api/tools · https://findutils.com/api/ · https://findutils.com/llms.txt