gnomancer

com.gnomancerPublished by gnomancer.comv0.5.1Updated Nov 7, 2026

Local raw DNA analysis: haplogroups, traits, ClinVar, pharmacogenomics. Nothing is uploaded.

VerifiedSTDIODesktop only

Overview

gnomancer's local MCP server, published by gnomancer.com; no sign-in required; STDIO; 10 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Publisher
gnomancer.com

Installation

In SourceWeft

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

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[gnomancer: your DNA, decoded on your own machine]

gnomancer.com · get your raw data · install · PyPI · MCP Registry · Discord

[PyPI] [CI] [MIT]

Take the raw file you already downloaded from AncestryDNA, 23andMe, MyHeritage, FamilyTreeDNA or LivingDNA (or a VCF) and turn it into one readable report. Everything runs on your computer. Nothing is uploaded.

Quick start

bash
pipx install gnomancer      # Python 3.10+; Java 17+ for the mtDNA haplogroup and PharmCAT stepsgnomancer ~/Downloads/AncestryDNA.zip   # first run fetches the open-source tools and references once (~250 MB)

Open AncestryDNA_analysis/REPORT.html. No Python? curl -fsSL https://gnomancer.com/install.sh | bash sets everything up (macOS and Linux; Windows via WSL).

[demo report]

What you get

  • Plain language first. An at-a-glance digest, then a narrative your own AI assistant can write from a prompt the run gives you.
  • Lineages. Y haplogroup (yhaplo, plus Yleaf on current YFull/FTDNA/ISOGG trees) and mtDNA haplogroup (Haplogrep3), each with population context.
  • Traits and ancestry markers. About 110 well-replicated sites: pigmentation, lactose, caffeine, bitter taste, blood group and more.
  • Health, carefully. Carrier sites, common risk variants, a ClinVar scan of every typed site with plausibility scoring, and PharmCAT pharmacogenomics. All collapsed by default so nobody sees a result they didn't ask for.
  • Family mode. gnomancer family dad.zip mom.zip me.zip shows shared DNA and the likely relationship for each pair, which lines you share, and which parent each of your alleles came from.
  • Stays current. gnomancer watch re-checks ClinVar each month and tells you only what was reclassified at sites you carry.
  • Honest limits. Every section says what the chip can and cannot tell you.

Use it from your AI assistant

gnomancer is also an MCP server. Connect it and ask "what does my report say about caffeine?"

bash
claude mcp add gnomancer -- uvx gnomancer serve          # Claude Code; Claude Desktop/Cursor: command "uvx", args ["gnomancer","serve"]

Only derived results reach the assistant, never the raw file, and the health tables are separate tools fetched only on request. The repo also works as a Claude plugin (skills/gnomancer/SKILL.md).

Privacy

Your genotype file never leaves your machine. The only network traffic is the one-time download of public tools and references. The optional --ai flag sends the structured results (not the file) to the Anthropic API to write the narrative, and only when you ask.

Not medical advice

A genotyping array reads about 0.02% of the genome at pre-chosen sites, and its calls at rare sites are wrong often enough that a clinical lab found 40% did not confirm. gnomancer tells you what the chip says and how far to trust it. Confirm anything that matters with a clinical-grade test and a clinician or genetic counselor.

More

Discord community · CLI options · vendors and quirks · the marker panel · tools under the hood · development · MCP registry · contributing

MIT licensed. The tools it downloads keep their own licenses; see NOTICE.md for credits.

mcp-name: com.gnomancer/gnomancer

Source: README.md at commit 0d17940

Tools

10

analyze

Run gnomancer on a raw DNA file (AncestryDNA, 23andMe, MyHeritage, FamilyTreeDNA, LivingDNA, VCF; .zip OK). Takes one to three minutes; the very first run also downloads ~250 MB of open-source tools and references (a few minutes), automatically. fast=True skips Yleaf, ClinVar and PharmCAT. Returns the output directory, report paths and the at-a-glance digest. The file never leaves this machine.

Parametersfastpathrequiredout_dirancestry

summary

Headline results of the current (or given) report: quality, lineages, ancestry estimate, multi-site readings and the at-a-glance digest. No health tables; use clinvar_findings / pharmacogenomics for those.

Parametersreport_dir

section

Return one section of REPORT.md by (partial, case-insensitive) heading, e.g. 'Paternal', 'Marker panel', 'PharmCAT'. With no name, lists the available section headings.

Parametersnamereport_dir

lookup

Genotype and reading for one rsID. Uses the curated panel when the site is in it; otherwise reads the single site from the user's raw file (nothing else is read or returned). Says so if the chip did not type the site.

Parametersrsidrequiredreport_dir

clinvar_findings

ClinVar scan results (pathogenic / likely-pathogenic alleles carried, with plausibility confidence and flags). Health-sensitive: call only when the user asks about disease risk or carrier status.

Parametersreport_dir

pharmacogenomics

PharmCAT star-allele diplotypes and phenotypes per gene, with coverage. Provisional: untyped positions are assumed reference. Call when the user asks about medications or drug metabolism.

Parametersreport_dir

clinvar_watch

Re-check ClinVar for this report: downloads a new ClinVar release if NCBI published one, rescans the user's sites and reports only classification changes (newly pathogenic, downgraded, review-status changes). The first run writes a baseline. Health-sensitive: run when the user asks.

Parametersforcereport_dir

family

Compare two or more relatives' raw DNA files: shared DNA per pair with a relationship estimate, shared maternal/ paternal lines, side-by-side panel genotypes and, for parent-parent-child sets, which parent each allele came from plus a Mendelian-consistency check. Runs locally. Returns the pair table and report paths.

Parametersnamespathsrequiredout_dirhaplogroups

narrative_prompt

The prompt for writing the plain-language narrative that goes at the top of the report. Follow it exactly, then pass your text to set_narrative.

Parametersreport_dir

set_narrative

Embed a narrative summary (yours, written from narrative_prompt) at the top of the report. Saves summary.md and regenerates REPORT.html / REPORT.md with the same options as the original run.

Parameterstextrequiredreport_dir

Version history

1
  1. v0.5.1LatestNov 3, 2026

Score

90% 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 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts