AE

ammawla/encode-toolkit

Deployment & DevOps
22 stars 5 forks Quality 81 Trend 18AGPL-3.0

MCP server and Claude Code plugin for the ENCODE Project: search, download and analyze ChIP-seq, ATAC-seq, RNA-seq, WGBS, Hi-C and CUT&RUN data with 20 tools, 47 skills and 7 Nextflow pipelines

Overview

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. 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 Start a new Claude Code session and enter: 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: Or in MCP client config: { "command": "npx", "args": ["encode-toolkit"] }

README

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

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.


Connected Databases

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

Database Access Method Use Case
ENCODE 20 MCP tools (live API) ChIP-seq, ATAC-seq, RNA-seq, Hi-C, WGBS, CUT&RUN data
GTEx REST API (skill) Tissue-specific gene expression across 54 tissues
ClinVar E-utilities (skill) Variant clinical significance and pathogenicity
GWAS Catalog REST API (skill) Trait-variant associations from genome-wide studies
JASPAR REST API (skill) Transcription factor binding motif profiles
CellxGene Census API (skill) Single-cell expression atlas across tissues
gnomAD GraphQL (skill) Population allele frequencies and gene constraint
Ensembl REST API (skill) VEP annotation, Regulatory Build, coordinate liftover
UCSC Genome Browser REST API (skill) cCRE tracks, TF clusters, sequence retrieval
GEO E-utilities (skill) Complementary expression/epigenomic datasets
PubMed MCP server Literature search and citation
bioRxiv MCP server Preprint discovery
ClinicalTrials.gov MCP server Clinical trial cross-reference
Open Targets MCP server Drug target identification

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”

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.

Parameter Type Description
assay_title string Assay type: “Histone ChIP-seq”, “ATAC-seq”, “total RNA-seq”, “Hi-C”, etc.
organism string Species (default: “Homo sapiens”)
organ string Organ: “pancreas”, “brain”, “liver”, “heart”, “kidney”, etc.
biosample_type string “tissue”, “cell line”, “primary cell”, “organoid”
target string ChIP target: “H3K27me3”, “H3K4me3”, “CTCF”, etc.
biosample_term_name string Specific biosample: “GM12878”, “HepG2”, etc.
limit int Max results (default: 25)

encode_get_experiment

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

Parameter Type Description
accession string Experiment ID (e.g., “ENCSR133RZO”)

encode_download_files

Download specific files by accession to a local directory.

Parameter Type Description
file_accessions list[str] File IDs to download (e.g., [“ENCFF635JIA”])
download_dir string Local path to save files
organize_by string “flat”, “experiment”, “format”, “experiment_format”
verify_md5 bool Verify file integrity (default: true)

encode_batch_download

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

Parameter Type Description
download_dir string Local path to save files
file_format string File format to download
assay_title string Assay type filter
organ string Organ filter
dry_run bool Preview only (default: true). Set false to download.

encode_track_experiment

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

Parameter Type Description
accession string Experiment ID to track
fetch_publications bool Fetch associated publications (default: true)
fetch_pipelines bool Fetch pipeline/analysis info (default: true)
notes string Optional notes to attach

Authentication

Most ENCODE data is public and requires no authentication. Just install and use.

For restricted/unreleased data, ask Claude: “Store my ENCODE credentials”

Credentials are encrypted using your OS keyring (macOS Keychain, Linux Secret Service, Windows Credential Locker) and never stored in plaintext. Get your access keys from your ENCODE profile.


Plugin Skills (47)

When installed as a Claude Code plugin, ENCODE Toolkit includes 47 literature-backed workflow skills that guide Claude through complex genomics tasks. Each analysis skill includes evidence-based quality thresholds, assay-specific metrics, and citations to primary literature.

Core Skills

Skill Description
setup Install and configure the ENCODE Toolkit server
search-encode Search and explore ENCODE experiments and files
download-encode Download files with organization and verification
track-experiments Track experiments, citations, and provenance locally
cross-reference Connect ENCODE data to PubMed, bioRxiv, ClinicalTrials.gov

Why ENCODE Toolkit

Most genomics tools give you one thing. ENCODE Toolkit gives you the full research loop:

Capability ENCODE Toolkit Typical MCP servers
Live database access 20 tools across 14 databases Single database, read-only
Executable pipelines 7 Nextflow DSL2 pipelines with Docker and cloud configs None
Provenance tracking Full audit trail from source data to derived files None
Publication output BibTeX/RIS citations, auto-generated methods sections None
Literature backing 100+ primary references with assay-specific QC thresholds None
Workflow skills 47 guided skills covering search to publication Static documentation

Supported Assay Types


Security and Privacy

  • 100% local execution — no telemetry, no analytics, no tracking
  • Credentials encrypted at rest via OS keyring with Fernet fallback
  • Certificate verification enforced — no verify=False
  • Rate limited to respect ENCODE’s 10 req/sec policy
  • MD5 verification on all downloads by default
  • No data leaves your machine except queries to public APIs over HTTPS

Vignettes

Step-by-step walkthroughs showing real Claude sessions, including actual API output and scientific interpretation.

Vignette Skills Demonstrated
01 — Discovery & Search Facets, search, metadata, quality-aware selection
02 — Download & Track File listing, download, tracking, citations, provenance
03 — Epigenomics Workflow Histone marks, ATAC-seq, aggregation skills
04 — Variant & Disease Research GWAS catalog, ClinVar, GTEx, JASPAR, gnomAD
05 — Expression & Single-Cell RNA-seq, scRNA-seq, GTEx, CellxGene, meta-analysis
06 — Motif & Regulatory Analysis TF ChIP-seq, chromatin states, HOMER/MEME
07 — 3D Genome & Methylation Hi-C loops, WGBS methylation, integrative analysis
08 — Pipeline Execution ChIP-seq/ATAC-seq/RNA-seq pipelines, Nextflow
09 — Cross-Reference & Integration GEO, PubMed, Ensembl, UCSC, multi-omics

Development

git clone https://github.com/ammawla/encode-toolkit.git
cd encode-toolkit
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

Run the server locally:

encode-toolkit

Run tests:

pytest

Troubleshooting


Author

Dr. Alex M. Mawla, PhD

License

AGPL-3.0. See LICENSE for full terms.

For commercial licensing inquiries: [email protected]

View the full README on GitHub

Install

npx encode-toolkit
New to MCP? Start with the mcpskill.org guide →

Configuration

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