Born Then
Officialby bornthen
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).
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues