TheYtree

Working · 2.8 s

com.theytree/theytreev1.0.1 Domain verified

Public read-only MCP for the Y-chromosome haplogroup tree & Y-SNP resolution. 父系单倍群树查询与Y-SNP解析。

Health & Science

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

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

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

children_haplogroups

Get the direct children of a haplogroup (for level-by-level traversal). Use limit for the N largest subclades only. 获取直接子节点（逐层遍历）；可用 limit 只看最大的 N 个分支。

namestring, required

Haplogroup name or hid / 单倍群名称或 hid

limitinteger

Return only the N largest children by size (default: all). / 只返回规模最大的 N 个直接子节点，默认全部

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (9)

children_haplogroups

Get the direct children of a haplogroup (for level-by-level traversal). Use limit for the N largest subclades only. 获取直接子节点（逐层遍历）；可用 limit 只看最大的 N 个分支。

Argument	Type	Description
name*	string	Haplogroup name or hid / 单倍群名称或 hid
limit	integer	Return only the N largest children by size (default: all). / 只返回规模最大的 N 个直接子节点，默认全部

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name"
  ],
  "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 个直接子节点，默认全部"
    }
  }
}

get_api_info

Get service meta: summary, auth, dataset size (haplogroups / mutation records), and the tool list. 获取本服务元信息：简介、鉴权、数据集规模、工具清单。

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

get_haplogroup

Get a single haplogroup by name / hid / SNP. 按名称/hid/SNP 获取单个单倍群详情。

Argument	Type	Description
name*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string"
    }
  }
}

get_haplogroup_lineage

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 即该节点与其直接父级）。

Argument	Type	Description
name*	string	Haplogroup name or hid / 单倍群名称或 hid
limit	integer	Return only the most recent N levels (default: all). / 只返回最近 N 级，默认全部

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Haplogroup name or hid / 单倍群名称或 hid"
    },
    "limit": {
      "type": "integer",
      "description": "Return only the most recent N levels (default: all). / 只返回最近 N 级，默认全部"
    }
  }
}

get_haplogroup_mutations

List a haplogroup defining (equivalent) mutations (paternal / Y tree only). 获取某单倍群的等价突变（defining SNPs）列表（仅父系 Y 树）。

Argument	Type	Description
name*	string
page	integer
fields	string	Custom fields (comma-separated), e.g. "snpname,location" / 自定义返回字段
compact	integer	1=compact fields only (snpid,snpname,haplogroup), much smaller / 1=仅返回精简字段，显著缩小体积
per_page	integer
include_under_observation	integer

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "page": {
      "type": "integer",
      "default": 1
    },
    "fields": {
      "type": "string",
      "description": "Custom fields (comma-separated), e.g. \"snpname,location\" / 自定义返回字段"
    },
    "compact": {
      "type": "integer",
      "default": 0,
      "description": "1=compact fields only (snpid,snpname,haplogroup), much smaller / 1=仅返回精简字段，显著缩小体积"
    },
    "per_page": {
      "type": "integer",
      "default": 200,
      "maximum": 500
    },
    "include_under_observation": {
      "type": "integer",
      "default": 0
    }
  }
}

list_haplogroups

Search or list paternal haplogroups by fuzzy name and/or parent, with stable ordering for full pagination (order=name recommended). 搜索/列出父系单倍群：按名称模糊匹配、按父节点筛选，稳定排序可完整枚举。

Argument	Type	Description
name	string	Fuzzy name match, e.g. O-F15365 / 名称模糊匹配
page	integer
level	integer
order	string
parent	string	Parent node (name/hid); returns only its direct children / 父节点（名称/hid），只返回直接子节点
per_page	integer
order_dir	string
exclude_mf	integer	1=exclude MagicCube (MF) names (matches the site); default 0 keeps all / 1=排除魔方(MF)名，默认0保留全部

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Fuzzy name match, e.g. O-F15365 / 名称模糊匹配"
    },
    "page": {
      "type": "integer",
      "default": 1
    },
    "level": {
      "type": "integer"
    },
    "order": {
      "enum": [
        "name",
        "endcounts",
        "level",
        "ages",
        "view_count",
        "snpcount"
      ],
      "type": "string",
      "default": "endcounts"
    },
    "parent": {
      "type": "string",
      "description": "Parent node (name/hid); returns only its direct children / 父节点（名称/hid），只返回直接子节点"
    },
    "per_page": {
      "type": "integer",
      "default": 50,
      "maximum": 200
    },
    "order_dir": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc"
    },
    "exclude_mf": {
      "type": "integer",
      "default": 0,
      "description": "1=exclude MagicCube (MF) names (matches the site); default 0 keeps all / 1=排除魔方(MF)名，默认0保留全部"
    }
  }
}

resolve_snp

Resolve a SNP name to its haplogroup and return equivalent names (merged-name variants supported). 将 SNP 名解析到所属单倍群并返回等价名。

Argument	Type	Description
snpname*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "snpname"
  ],
  "properties": {
    "snpname": {
      "type": "string"
    }
  }
}

resolve_snps

Batch-resolve up to 200 SNP names to their haplogroups (for reading a whole Y-SNP panel). 批量解析多个 SNP 名到所属单倍群（≤200/次）。

Argument	Type	Description
snpnames*	array	Array of SNP names, e.g. ["M269","M122","F15365"] / SNP 名数组

Input schema (JSON)

{
  "type": "object",
  "required": [
    "snpnames"
  ],
  "properties": {
    "snpnames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of SNP names, e.g. [\"M269\",\"M122\",\"F15365\"] / SNP 名数组"
    }
  }
}

subtree_haplogroups

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。

Argument	Type	Description
name*	string	Subtree root name/hid / 子树根节点名称/hid
max_depth	integer	Max levels relative to root (optional). Default 6; unlimited if root endcounts<=600 / 相对根最大层数（可选），默认6

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name"
  ],
  "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"
    }
  }
}