# gnomancer

> gnomancer is an open-source MCP server for health and science. Decode a raw DNA export into a local report, with an AI you choose. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Linux, CLI, self-hosted
- **Website:** https://gnomancer.com
- **Repository:** https://github.com/codebase/gnomancer
- **MCP Registry name:** com.gnomancer/gnomancer
- **Categories:** health and science
- **Listing updated:** 2026-11-14

## About

gnomancer reads the raw data file from AncestryDNA, 23andMe, MyHeritage, FamilyTreeDNA or LivingDNA (or a VCF), detects the vendor and genome build, and builds one HTML report plus Markdown, TSV and JSON. It installs with a one-line script or pipx and runs on macOS or Linux, with Windows through WSL.

The report combines established tools: Y haplogroup from yhaplo checked by Yleaf, mitochondrial haplogroup from Haplogrep3, a curated panel of about 110 trait sites, a ClinVar scan with plausibility scoring because arrays are unreliable at rare sites, and PharmCAT star-allele calls with CPIC phenotypes. Health sites are collapsed by default.

The genotype file is never uploaded and there is no account or telemetry. As an MCP server it lets Claude, Codex, Cursor or a local model answer questions about the report; the results the assistant reads go to its provider, so a local model keeps them on your machine.

## Features

- **Local analysis:** The raw file stays on your computer.
- **Haplogroups:** Y and mitochondrial lineages with population context.
- **ClinVar scan:** Each typed site checked and scored for plausibility.
- **Pharmacogenomics:** PharmCAT diplotypes and CPIC phenotypes for covered genes.
- **Several formats:** HTML, Markdown, TSV and JSON output.
- **Ask an assistant:** Question the report from an MCP client.

## Good for

- Explore your lineages from a downloaded DNA file
- Check drug-metabolism genes before a doctor visit
- Ask an assistant what the report says about caffeine
- Convert older genome builds to GRCh37

## Install

### Claude Code (Terminal)

```sh
claude mcp add gnomancer -- uvx gnomancer
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "gnomancer": {
      "command": "uvx",
      "args": [
        "gnomancer"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gnomancer": {
      "command": "uvx",
      "args": [
        "gnomancer"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gnomancer": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "gnomancer"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gnomancer": {
      "command": "uvx",
      "args": [
        "gnomancer"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gnomancer": {
      "command": "uvx",
      "args": [
        "gnomancer"
      ]
    }
  }
}
```

## FAQ

### Is my DNA file uploaded?

No. The site says it never uploads the genotype file.

### What network traffic occurs?

A one-time download of public tools and reference data; --ai summary optionally sends result tables to the Anthropic API.

### Is it open source?

Yes, per the site.

### Is gnomancer free?

Yes. gnomancer is open source, so you can use and self-host it for free.

### How do I add gnomancer to Claude Code?

Run this command in your terminal: claude mcp add gnomancer -- uvx gnomancer

### What are the best alternatives to gnomancer?

The closest alternatives to gnomancer are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).

## Alternatives

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.
- [Splyt](https://ai-powered.com/mcp/splyt): Splyt is a free MCP server for health and science.
- [Health Agent](https://ai-powered.com/mcp/health-agent): Health Agent is an MCP server for health and science.
- [Pausila](https://ai-powered.com/mcp/pausila): Pausila is a free MCP server for local services.

---
Source: https://ai-powered.com/mcp/gnomancer
