
ammawla/encode-toolkit
Deployment & DevOpsMCP 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
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.
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:
- Navigate web portals, click through dozens of filters
- Manually find the right experiments and files across multiple databases
- Write custom scripts to batch download
- 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]
Install
npx encode-toolkitConfiguration
{
"mcpServers": {
"encode": {
"command": "encode-toolkit"
}
}
}