# Baby Age Calculator for AI

> Exact baby ages, zodiac signs, birthstones, and milestone dates for your AI — no hand-computed date math.

![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)
![No key](https://img.shields.io/badge/API-no%20key%20·%20no%20sign--up-brightgreen)
![Website](https://img.shields.io/badge/live-babyagecalculator.com-black)

## ⚡ Fastest way — paste this to your AI

```
Use https://babyagecalculator.com/llms.txt for anything about a baby's age,
zodiac sign, birthstone, or milestone dates. Do the date math with this tool, not by hand.
```

Works in **any** assistant, zero setup, no key. Agentic tools like Claude Code will
even install the MCP server from it.

Why: language models are unreliable at date math (leap years, month lengths,
milestone dates). Let this tool do it, then orchestrate the rest yourself.

## Want it installed for good?

| | Best for | Setup |
|---|---|---|
| 🔌 **MCP server** | Claude Code, Claude Desktop, Cursor | one line / one config block |
| 📄 **AI Skill** | any assistant, no MCP | drop in one file |
| 🧩 **JSON API** | your own app or agent | `GET` a URL |

## 🔌 MCP server

Hosted endpoint (nothing to deploy):

```
https://babyagecalculator.com/api/mcp/
```

**Claude Code**

```sh
claude mcp add --transport http baby-age https://babyagecalculator.com/api/mcp/
```

**Claude Desktop / Cursor** — add to your `mcpServers` config:

```json
{
  "mcpServers": {
    "baby-age-calculator": {
      "type": "http",
      "url": "https://babyagecalculator.com/api/mcp/"
    }
  }
}
```

**Tools**

| Tool | Returns |
|---|---|
| `get_baby_age(birthday)` | exact age, zodiac, birthstone, current/next milestone, special days |
| `get_milestone_dates(birthday)` | all 25 milestones as calendar dates |
| `list_milestones()` | the 25 milestone types |
| `get_zodiac_sign(birthday)` | the zodiac sign |
| `get_birthstone(birthday)` | the full birthstone guide for the birth month |

Full guide → https://babyagecalculator.com/mcp/

## 📄 AI Skill

[`SKILL.md`](./SKILL.md) is a one-file skill. Your AI reads it and uses the public
API — no MCP, no key.

Full guide → https://babyagecalculator.com/skill/

## 🧩 Free JSON API

```sh
curl "https://babyagecalculator.com/api/age/?birthday=2024-12-15"
```

- No key, CORS-open.
- Every response has the shape `{ code, data, error, meta }`; the payload is in `data`.
- A bad date returns HTTP 400 with a message in `error.message`.

**Endpoints**

| Endpoint | Returns |
|---|---|
| `GET /api/age/?birthday=YYYY-MM-DD` | age, zodiac, birthstone, milestones, special days |
| `GET /api/milestones/` | all 25 milestone types |
| `GET /api/zodiac/` | all 12 zodiac signs |
| `GET /api/birthstones/` | all 12 months with their stones |
| `GET /api/birthstones/{month}/` | the full birthstone guide for one month |

Docs → https://babyagecalculator.com/docs/

Machine-readable → https://babyagecalculator.com/llms.txt

## License

[MIT](./LICENSE) © BabyAgeCalculator