# TheYtree

> Public, read-only API / MCP service for the paternal (Y-chromosome) haplogroup tree and its equivalent mutations, for AI agents and developers. Dataset: 50,786 haplogroups, 380,000+ equivalent-mutation records.

## MCP / API

- [MCP setup guide](https://www.theytree.com/mcp): copy-paste configs for Cursor / VS Code / Claude Desktop / Claude Code / Windsurf / Cline
- [MCP endpoint](https://www.theytree.com/api/v1/agent/mcp): Streamable HTTP, JSON-RPC 2.0, 9 read-only tools
- [MCP Server Card](https://www.theytree.com/.well-known/mcp.json): machine-readable service description
- [REST API meta](https://www.theytree.com/api/v1/agent/meta): endpoint list and dataset size
- [OpenAPI spec](https://www.theytree.com/api/v1/agent/openapi.json)
- [Health check](https://www.theytree.com/api/v1/agent/health)

## Capabilities

- Haplogroup lookup: list/search, details, defining (equivalent) mutations, lineage up to ROOT
- Tree traversal: direct children (level by level), whole subtree in one call (depth-bounded)
- SNP resolution: resolve a single or batch Y-SNP panel to its haplogroup (all parallel matches included)

## Notes

- Read-only, no auth (rate-limited 10 r/s per client IP)
- REST base: https://www.theytree.com/api/v1/agent
- Contact: TheYtree / YSNP

## 中文

> 父系(Y染色体)单倍群树与等价突变的公开、只读 API / MCP 服务，面向 AI Agent 与开发者。数据规模：单倍群 50,786 个、等价突变记录 38 万+。

- [MCP 接入文档](https://www.theytree.com/mcp)：Cursor / VS Code / Claude Desktop / Claude Code / Windsurf / Cline 复制即用配置
- [MCP 端点](https://www.theytree.com/api/v1/agent/mcp)：Streamable HTTP，JSON-RPC 2.0，9 个只读工具
- [MCP Server Card](https://www.theytree.com/.well-known/mcp.json)：机器可读的服务描述
- [REST API 元信息](https://www.theytree.com/api/v1/agent/meta)：端点清单与数据集规模
- [OpenAPI 规范](https://www.theytree.com/api/v1/agent/openapi.json) · [健康检查](https://www.theytree.com/api/v1/agent/health)

**能力**：单倍群查询（列表/搜索、详情、定义突变、上溯谱系）；树遍历（直接子节点、子树）；SNP 解析（单个/批量，含平行突变全部命中）。

**说明**：只读、免鉴权（按客户端 IP 限流 10 r/s）；REST 基址 https://www.theytree.com/api/v1/agent ；联系 TheYtree / YSNP。