encode-toolkit

ENCODE Toolkit — Genomics Research Infrastructure for Claude

Search ENCODE, cross-reference 14 databases, run 7 analysis pipelines, and generate publication-ready methods — all from natural language in Claude Code.

Start from ENCODE but go everywhere: discover histone peaks, cross-reference with GWAS variants, check ClinVar pathogenicity, pull GTEx expression, analyze TF binding motifs from JASPAR, run pipelines, and generate publication-ready methods with full provenance — in one conversation.

Citation Notes

If you use ENCODE-Toolkit, please cite:

Alex M. Mawla. (2026). ENCODE-Toolkit: an MCP server, Claude plugin, and skills suite for ENCODE genomic data access and analysis. Zenodo. https://doi.org/10.5281/zenodo.18917511

BibTeX

@software{mawla_2026_encode_toolkit,
  author  = {Mawla, Alex M.},
  title   = {ENCODE-Toolkit: an MCP server, Claude plugin, and skills suite for ENCODE genomic data access and analysis},
  year    = {2026},
  publisher = {Zenodo},
  doi     = {10.5281/zenodo.18917511},
  url     = {https://doi.org/10.5281/zenodo.18917511}
}

Quick Start

Claude Code Plugin (recommended)

Start a new Claude Code session and enter:

/plugin marketplace add ammawla/encode-toolkit

/plugin install encode-toolkit

That's it. All 20 tools, 47 skills, and the MCP connector are now available.

MCP-only install (tools only, no skills)

If you only need the 20 MCP tools without the 47 workflow skills:

claude mcp add encode -- uvx encode-toolkit

Other editors and platforms

npx (Node.js)

npx encode-toolkit

Or in MCP client config: { "command": "npx", "args": ["encode-toolkit"] }

pip install

pip install encode-toolkit

Then use encode-toolkit as the command in any MCP client configuration:

{
  "mcpServers": {
    "encode": {
      "command": "encode-toolkit"
    }
  }
}

Claude Desktop (MCP only)

Add to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "encode": {
      "command": "uvx",
      "args": ["encode-toolkit"]
    }
  }
}

No installation needed when using uvx. Just add the config and restart Claude.

VS Code / Copilot

Add to .vscode/mcp.json in your workspace:

{
  "mcp": {
    "servers": {
      "encode": {
        "command": "uvx",
        "args": ["encode-toolkit"]
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "encode": {
      "command": "uvx",
      "args": ["encode-toolkit"]
    }
  }
}

Windsurf

Add to .windsurf/mcp.json:

{
  "mcpServers": {
    "encode": {
      "command": "uvx",
      "args": ["encode-toolkit"]
    }
  }
}

Connected Databases

ENCODE Toolkit integrates 14 databases through live API tools and guided skills.

What You Can Ask Claude

Search and explore

• "Find all histone ChIP-seq experiments for human pancreas tissue"
• "What ATAC-seq data is available for mouse brain?"
• "Search for RNA-seq on GM12878 cell line"
• "What histone marks have ChIP-seq data for pancreas?"

Download and track

• "Download all BED files from ENCSR133RZO to ~/data/encode"
• "Track experiment ENCSR133RZO with its publications"
• "Export citations for my tracked experiments as BibTeX"

Cross-reference databases

• "What GWAS variants overlap islet enhancers?"
• "Check ClinVar pathogenicity for rs7903146"
• "Pull GTEx expression for TCF7L2 across tissues"
• "Find JASPAR motifs for HNF4A binding sites"

Run pipelines

• "Set up a ChIP-seq pipeline for my H3K27ac experiments"
• "Run ATAC-seq analysis with ENCODE-standard QC thresholds"

Generate methods and provenance

• "Log that I created filtered_peaks.bed from ENCSR133RZO using bedtools"
• "Generate a methods section for my analysis with citations"

More example prompts

Experiment details

• "Show me the full details for experiment ENCSR133RZO"
• "What files are available for ENCSR133RZO?"
• "List only the BED files from ENCSR133RZO"

Bulk downloads

• "Download all FASTQs from human pancreas ChIP-seq to /data/fastqs"
• "Get the IDR thresholded peaks from these experiments"
• "Download the bigWig signal tracks for H3K27me3 in GRCh38"

Compatibility analysis

• "Are experiments ENCSR133RZO and ENCSR000AKS compatible for combined analysis?"
• "Compare these two ChIP-seq experiments"

Provenance chains

• "Show me the provenance chain for my derived files"
• "What files have I derived from ENCSR133RZO?"

The Problem

Using genomics databases today means:

1. Navigate web portals, click through dozens of filters
2. Manually find the right experiments and files across multiple databases
3. Write custom scripts to batch download
4. Lose track of which files came from where

With ENCODE Toolkit, just tell Claude what you need:

"Find all histone ChIP-seq data for human pancreas tissue"

Claude searches ENCODE, returns a structured table of 66 experiments with targets, replicates, and file counts. Downloads are organized by experiment with MD5 verification and full provenance tracking.

Available Tools (20)

Five core tools are shown below. The remaining 15 are collapsed for readability.

encode_search_experiments

Search ENCODE experiments with 20+ filters.

encode_get_experiment

Get full details for a single experiment including all files, quality metrics, and audit info.

encode_download_files

Download specific files by accession to a local directory.

encode_batch_download

Search + download in one step. Runs in preview mode by default.

encode_track_experiment

Track an experiment locally with its publications, methods, and pipeline info.

Search and discovery tools (4)

encode_list_files

List files for a specific experiment with format/type filters.