TheYtree · Haplogroup MCP Server & Public Read-Only API

Public data for the paternal (Y-chromosome) haplogroup tree and equivalent mutations, for AI agents and developers. No auth; rate-limited per client IP.

父系(Y 染色体)单倍群树与等价突变的公开数据，供 AI Agent 与开发者查询。无需鉴权，按客户端 IP 限流。

read-only no auth 50,786 haplogroups 380k+ mutations

MCP Endpoint / MCP 端点

https://www.theytree.com/api/v1/agent/mcp

Transport: Streamable HTTP (JSON-RPC 2.0). Pick a client and copy the config.　传输方式：Streamable HTTP（JSON-RPC 2.0）。挑一个客户端复制即用。

Cursor

// ~/.cursor/mcp.json   (or project .cursor/mcp.json)
{
  "mcpServers": {
    "theytree": { "url": "https://www.theytree.com/api/v1/agent/mcp" }
  }
}

VS Code

// .vscode/mcp.json   (note the root key is "servers")
{
  "servers": {
    "theytree": { "type": "http", "url": "https://www.theytree.com/api/v1/agent/mcp" }
  }
}

Claude Code

claude mcp add --transport http theytree \
  https://www.theytree.com/api/v1/agent/mcp

Claude Desktop

// claude_desktop_config.json
{
  "mcpServers": {
    "theytree": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.theytree.com/api/v1/agent/mcp"]
    }
  }
}

Windsurf

// ~/.codeium/windsurf/mcp_config.json   (note: serverUrl)
{
  "mcpServers": {
    "theytree": { "serverUrl": "https://www.theytree.com/api/v1/agent/mcp" }
  }
}

Cline / Continue

{
  "mcpServers": {
    "theytree": { "type": "streamable-http", "url": "https://www.theytree.com/api/v1/agent/mcp" }
  }
}

MCP Tools (9, all read-only) / MCP 工具（9 个，全部只读）

Tool / 工具	Purpose / 用途
`resolve_snp` / `resolve_snps`	Resolve a single / batch (≤200) Y-SNP name(s) to their haplogroup (all parallel matches included). 单个 / 批量(≤200)把 Y-SNP 名解析到所属单倍群（含平行突变的全部命中）。
`list_haplogroups`	List/search by name, parent, or level; stable pagination (order=name / endcounts). 按名称模糊 / 父节点 / 层级列出，可按 name、endcounts 等稳定排序翻页。
`get_haplogroup`	Haplogroup details (incl. zh/en/ar custom names, prominent surname). 单倍群详情（含中/英/阿自定义名、显著姓氏）。
`get_haplogroup_mutations`	Defining (equivalent) mutations; supports compact / fields. 定义(等价)突变列表，支持 compact/fields 精简。
`get_haplogroup_lineage`	Lineage up to ROOT. 上溯到 ROOT 的谱系链。
`children_haplogroups`	Direct children (for level-by-level traversal). 直接子节点（逐层遍历用）。
`subtree_haplogroups`	Whole subtree in one call (default depth 6; max_depth configurable). 一次取某节点子树（默认展开 6 层，可指定 max_depth）。
`get_api_info`	Service meta: dataset size, tool list. 服务元信息：数据规模、可用工具清单。

REST API (same data, read-only) / REST API（同一数据，只读）

Base: https://www.theytree.com/api/v1/agent
Meta: /api/v1/agent/meta
OpenAPI: /api/v1/agent/openapi.json

GET  /haplogroups?name=&parent=&level=&order=&page=&per_page=
GET  /haplogroups/{name}
GET  /haplogroups/{name}/mutations
GET  /haplogroups/{name}/lineage
GET  /haplogroups/{name}/children
GET  /haplogroups/tree?root=&depth=
GET  /snps/{snpname}
GET  /snps?names=A,B,C          (batch, ≤200)

Notes / 说明

Read-only, public, no key; rate-limited by real client IP at 10 r/s (burst 20); over-limit returns 429.
数据只读、公开、无需密钥；按客户端真实 IP 限流 10 次/秒（突发 20），超限返回 429。
Source: TheYtree / YSNP paternal haplogroup tree; zh/en/ar custom names are partially populated.
数据来源为 TheYtree / YSNP 父系单倍群树，中文/英文/阿拉伯文自定义名部分有值。
Discovery: /.well-known/mcp.json · /llms.txt

TheYtree / YSNP · paternal haplogroup tree / 父系单倍群树 · www.theytree.com