TheYtree
Public read-only MCP for the Y-chromosome haplogroup tree & Y-SNP resolution. 父系单倍群树查询与Y-SNP解析。
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"theytree": {
"url": "https://www.theytree.com/api/v1/agent/mcp"
}
}
}Remote endpoints
https://www.theytree.com/api/v1/agent/mcpstreamable-httpWhat it can do
Tool inventory
Tools (9)
🟢list_haplogroups(name, parent, level, order, order_dir, ...)
Search or list paternal haplogroups by fuzzy name and/or parent, with stable ordering for full pagination (order=name recommended). 搜索/列出父系单倍群：按名称模糊匹配、按父节点筛选，稳定排序可完整枚举。
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Fuzzy name match, e.g. O-F15365 / 名称模糊匹配"
},
"parent": {
"type": "string",
"description": "Parent node (name/hid); returns only its direct children / 父节点（名称/hid），只返回直接子节点"
},
"level": {
"type": "integer"
},
"order": {
"type": "string",
"enum": [
"name",
"endcounts",
"level",
"ages",
"view_count",
"snpcount"
],
"default": "endcounts"
},
"order_dir": {
"type": "string",
"enum": [
"asc",
"desc"
],
"default": "desc"
},
"exclude_mf": {
"type": "integer",
"default": 0,
"description": "1=exclude MagicCube (MF) names (matches the site); default 0 keeps all / 1=排除魔方(MF)名，默认0保留全部"
},
"page": {
"type": "integer",
"default": 1
},
"per_page": {
"type": "integer",
"default": 50,
"maximum": 200
}
}
}🟢get_haplogroup(name)
Get a single haplogroup by name / hid / SNP. 按名称/hid/SNP 获取单个单倍群详情。
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string"
}
},
"required": [
"name"
]
}🟢get_haplogroup_mutations(name, include_under_observation, compact, fields, page, ...)
List a haplogroup defining (equivalent) mutations (paternal / Y tree only). 获取某单倍群的等价突变（defining SNPs）列表（仅父系 Y 树）。
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"include_under_observation": {
"type": "integer",
"default": 0
},
"compact": {
"type": "integer",
"default": 0,
"description": "1=compact fields only (snpid,snpname,haplogroup), much smaller / 1=仅返回精简字段，显著缩小体积"
},
"fields": {
"type": "string",
"description": "Custom fields (comma-separated), e.g. \"snpname,location\" / 自定义返回字段"
},
"page": {
"type": "integer",
"default": 1
},
"per_page": {
"type": "integer",
"default": 200,
"maximum": 500
}
},
"required": [
"name"
]
}🟢get_haplogroup_lineage(name, limit)
Get the lineage chain from a haplogroup up to ROOT. Use limit to fetch only the most recent N levels (e.g. limit=2 for the node + its parent). 获取某单倍群上溯到 ROOT 的谱系链；可用 limit 只取最近 N 级（如 limit=2 即该节点与其直接父级）。
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Haplogroup name or hid / 单倍群名称或 hid"
},
"limit": {
"type": "integer",
"description": "Return only the most recent N levels (default: all). / 只返回最近 N 级，默认全部"
}
},
"required": [
"name"
]
}🟢children_haplogroups(name, limit)
Get the direct children of a haplogroup (for level-by-level traversal). Use limit for the N largest subclades only. 获取直接子节点（逐层遍历）；可用 limit 只看最大的 N 个分支。
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Haplogroup name or hid / 单倍群名称或 hid"
},
"limit": {
"type": "integer",
"description": "Return only the N largest children by size (default: all). / 只返回规模最大的 N 个直接子节点，默认全部"
}
},
"required": [
"name"
]
}⚪resolve_snp(snpname)
Resolve a SNP name to its haplogroup and return equivalent names (merged-name variants supported). 将 SNP 名解析到所属单倍群并返回等价名。
Input Schema
{
"type": "object",
"properties": {
"snpname": {
"type": "string"
}
},
"required": [
"snpname"
]
}⚪resolve_snps(snpnames)
Batch-resolve up to 200 SNP names to their haplogroups (for reading a whole Y-SNP panel). 批量解析多个 SNP 名到所属单倍群（≤200/次）。
Input Schema
{
"type": "object",
"properties": {
"snpnames": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of SNP names, e.g. [\"M269\",\"M122\",\"F15365\"] / SNP 名数组"
}
},
"required": [
"snpnames"
]
}🟢subtree_haplogroups(name, max_depth)
Get a haplogroup subtree. Defaults to 6 levels (matches the site); small branches (root endcounts<=600) fully expand; max_depth overrides. Truncated boundary nodes carry has_children. 取子树：默认 6 层，小支(endcounts<=600)全展开，可传 max_depth；截断边界带 has_children。
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Subtree root name/hid / 子树根节点名称/hid"
},
"max_depth": {
"type": "integer",
"description": "Max levels relative to root (optional). Default 6; unlimited if root endcounts<=600 / 相对根最大层数（可选），默认6"
}
},
"required": [
"name"
]
}🟢get_api_info
Get service meta: summary, auth, dataset size (haplogroups / mutation records), and the tool list. 获取本服务元信息：简介、鉴权、数据集规模、工具清单。
Input Schema
{
"type": "object",
"properties": {}
}Community
Evidence