TheYtree

com.theytreePublished by theytree.comOfficial publisherv1.0.1Updated Oct 27, 2026

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

VerifiedStreamable HTTPWeb executableKnowledge & Memory

Overview

AI-generated overview

Public read-only MCP server for the Y-chromosome haplogroup tree, letting an assistant look up haplogroups, lineages, subclades and Y-SNP placements.

What you can do
  • Search and list paternal haplogroups by fuzzy name or parent, with stable ordering for pagination
  • Fetch a single haplogroup by name, hid or SNP, plus its defining equivalent mutations
  • Walk the tree: lineage chain up to ROOT, direct children, and subtrees with depth limits
  • Resolve one SNP name or batch-resolve up to 200 SNP names to their haplogroups
  • Read service metadata such as summary, auth, dataset size and the tool list
When to use it
Useful when you need to place a Y-SNP or haplogroup name in the paternal tree, trace a lineage upward, or enumerate subclades while researching genetic genealogy. It is a lookup service only, not an analysis or matching tool.
Requirements
Remote streamable HTTP endpoint at theytree.com; no package, environment variable or header is declared. No authentication is declared, so no account or key appears to be needed.
Before you install
The service is described as public and read-only, so it should not modify data. Queries about specific haplogroups or SNPs are sent to a third-party site; avoid including personal or identifying genetic details beyond the public nomenclature you are looking up.

Installation

In SourceWeft

  1. Open TheYtree in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.theytree%2Ftheytree/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

Tools

9

list_haplogroups

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

Parametersnamepagelevelorderparentper_pageorder_direxclude_mf

get_haplogroup

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

Parametersnamerequired

get_haplogroup_mutations

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

Parametersnamerequiredpagefieldscompactper_pageinclude_under_observation

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

Parametersnamerequiredlimit

children_haplogroups

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

Parametersnamerequiredlimit

resolve_snp

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

Parameterssnpnamerequired

resolve_snps

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

Parameterssnpnamesrequired

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。

Parametersnamerequiredmax_depth

get_api_info

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

Takes no parameters.

Version history

2
  1. v1.0.1LatestSep 17, 2026
  2. v1.0.0Sep 17, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.