TheYtree

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

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

Add to your agent

Copy this into your MCP client config:

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

Measured tools (9)

• list_haplogroups

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

  Parameters:

  • 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保留全部

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_haplogroup

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

  Parameters:

  • name (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_haplogroup_mutations

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

  Parameters:

  • name (required) — 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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Parameters:

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• children_haplogroups

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

  Parameters:

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• resolve_snp

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

  Parameters:

  • snpname (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• resolve_snps

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

  Parameters:

  • snpnames (required) — array — Array of SNP names, e.g. ["M269","M122","F15365"] / SNP 名数组

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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。

  Parameters:

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_api_info

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.