Skip to main content
Glama
README.md
# Born Then MCP server and agent skill

[Born Then](https://bornthen.life) is a free historical life simulator from 1 CE to 2025 weighted by real human births across centuries, regions and modern countries. Every demographic figure is labelled by source confidence (`statistic`, `estimate`, `model` or `forecast`). This repository holds the connection details for its remote MCP server and an [Agent Skill](skills/bornthen/SKILL.md). The service is hosted; there is nothing to install or run locally.

- **MCP endpoint:** `https://bornthen.life/mcp` (Streamable HTTP)
- **Auth:** none. Free, public read-only—no API key or account needed.
- **Registry name:** `life.bornthen/bornthen` in the [official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=life.bornthen/bornthen)
- **Docs:** [bornthen.life/docs/mcp](https://bornthen.life/docs/mcp) · [Methodology](https://bornthen.life/about) · [llms.txt](https://bornthen.life/llms.txt)

## Connect

**Claude Code**

```bash
claude mcp add --transport http bornthen https://bornthen.life/mcp
```

**Cursor** (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "bornthen": { "url": "https://bornthen.life/mcp" }
  }
}
```

**Codex** (`~/.codex/config.toml`)

```toml
[mcp_servers.bornthen]
url = "https://bornthen.life/mcp"
```

In Claude Desktop or ChatGPT, add `https://bornthen.life/mcp` as a custom connector.

## Tools

| Tool | What it does |
| --- | --- |
| `roll_random_birth` | Draw a random human birth between 1 CE and 2025 weighted by real historical births (or within an optional `year` and deterministic `seed`), returning birthplace, birth odds, life expectancy, lifetime historical events and a playable `playUrl` for those five lives |
| `query_era_facts` | Look up century/decade population, life expectancy, under-five mortality, literacy and urbanisation (with confidence labels) plus sourced historical events (wars, plagues, famines, depressions) by `year`, `period_slug`, `place` or `event_query` |

## Markdown & LLMs endpoints

Era pages, historical events and methodology can also be read directly without MCP:

- `https://bornthen.life/llms.txt`
- Append `.md` to public pages (for example `https://bornthen.life/life-in-the-1920s.md` or `https://bornthen.life/about.md`)

## Agent skill

[`skills/bornthen/SKILL.md`](skills/bornthen/SKILL.md) follows the [Agent Skills](https://agentskills.io) format. Install it with

```bash
npx skills add bornthen/bornthen-mcp
```

or copy the folder into your agent's skills directory (for Claude Code, `~/.claude/skills/bornthen/`).

### One-line prompt for any AI agent

Paste into Claude Code, Cursor, Codex, or Gemini CLI:

```text
Read https://raw.githubusercontent.com/bornthen/bornthen-mcp/main/skills/bornthen/SKILL.md and roll a random human birth in history with real demographic odds.
```

## Support

support@bornthen.life

## License

The files in this repository are MIT licensed. Historical content and simulations on bornthen.life are covered by [bornthen.life/terms](https://bornthen.life/terms).