Agent skill

medical-research-toolkit

Query 14+ biomedical databases for drug repurposing, target discovery, clinical trials, and literature research. Access ChEMBL, PubMed, ClinicalTrials.gov, OpenTargets, OpenFDA, OMIM, Reactome, KEGG, UniProt, and more through a unified MCP endpoint. Use when researching disease targets, finding approved/investigational drugs, searching clinical evidence, discovering genetic associations, or analyzing compound bioactivity data.

Stars 2,009
Forks 275

Install this agent skill to your Project

npx add-skill https://github.com/FreedomIntelligence/OpenClaw-Medical-Skills/tree/main/skills/medical-research-toolkit

SKILL.md

Medical Research Toolkit

Query 14+ biomedical databases for drug repurposing, target discovery, clinical evidence, and literature research — all via a unified MCP endpoint.

⚡ 30-Second Start

bash
# Find drugs for myasthenia gravis
curl -X POST https://mcp.cloud.curiloo.com/tools/unified/mcp \
  -H "Content-Type: application/json" -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"chembl_find_drugs_by_indication","arguments":{"indication":"myasthenia gravis","max_results":10}},"id":1}'

That's it! You now have approved and investigational drugs for the disease.


Quick Recipes

Find Drugs for a Disease

bash
curl -X POST https://mcp.cloud.curiloo.com/tools/unified/mcp \
  -H "Content-Type: application/json" -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"chembl_find_drugs_by_indication","arguments":{"indication":"myasthenia gravis","max_results":20}},"id":1}'

Returns: Approved + investigational drugs with max phase reached

Find Disease Targets

bash
# First: Find disease ID
curl -X POST https://mcp.cloud.curiloo.com/tools/unified/mcp \
  -H "Content-Type: application/json" -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"opentargets_search","arguments":{"query":"myasthenia gravis","entity_type":"disease"}},"id":1}'

# Returns: disease ID (e.g., EFO_0004991)
# Then: Get targets
curl -X POST https://mcp.cloud.curiloo.com/tools/unified/mcp \
  -H "Content-Type: application/json" -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"opentargets_get_associations","arguments":{"disease_id":"EFO_0004991","size":20}},"id":2}'

Returns: Top disease targets ranked by evidence strength (0-1 score)

Search Literature

bash
curl -X POST https://mcp.cloud.curiloo.com/tools/unified/mcp \
  -H "Content-Type: application/json" -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"pubmed_search_articles","arguments":{"diseases":["myasthenia gravis"],"keywords":["immunotherapy"],"max_results":20}},"id":1}'

Returns: PubMed articles on myasthenia gravis immunotherapy

Find Active Clinical Trials

bash
curl -X POST https://mcp.cloud.curiloo.com/tools/unified/mcp \
  -H "Content-Type: application/json" -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"ctg_search_studies","arguments":{"condition":"myasthenia gravis","recruitment_status":"RECRUITING","max_results":20}},"id":1}'

Returns: Actively recruiting trials for the disease

Check Drug Safety

bash
curl -X POST https://mcp.cloud.curiloo.com/tools/unified/mcp \
  -H "Content-Type: application/json" -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"openfda_search_adverse_events","arguments":{"drug_name":"eculizumab","limit":50}},"id":1}'

Returns: FDA adverse event reports—check for serious outcomes, death, hospitalization


What You Get

14+ Integrated Databases

Database What's Inside Use For
ChEMBL 2M drugs, bioactivity data Finding approved/investigational drugs
OpenTargets Disease-target links + evidence Identifying therapeutic targets
PubMed 35M+ articles + preprints Literature review & validation
ClinicalTrials.gov 400K+ active trials Finding ongoing studies
OpenFDA Adverse events, drug labels Safety assessment
OMIM Genetic diseases, genes → phenotypes Understanding disease genetics
Reactome Pathways, protein interactions Mechanism understanding
UniProt Protein sequences, annotations Protein properties
KEGG Metabolic & disease pathways Systems-level view
GWAS Catalog Genetic associations Variant discovery
Pathway Commons Integrated pathway data Network analysis
MyGene.info Gene annotations ID mapping
MyVariant.info Variant effects Variant interpretation
+ more

Use Cases

🧬 Drug Repurposing

Find non-standard-care drugs for rare/complex diseases:

  1. Find disease targets (OpenTargets)
  2. Search for drugs targeting those genes (ChEMBL)
  3. Check ongoing trials (ClinicalTrials)
  4. Verify safety (OpenFDA, PubMed)

🔬 Target Discovery

Identify novel therapeutic targets:

  1. Find disease associations (OpenTargets, GWAS)
  2. Get pathway context (Reactome, KEGG)
  3. Review literature (PubMed)
  4. Check protein properties (UniProt)

📋 Clinical Evidence Review

Compile evidence for a hypothesis:

  1. Search trials (ClinicalTrials.gov)
  2. Find literature (PubMed)
  3. Check FDA data (OpenFDA)

📊 Literature Mining

Systematically search biomedical research:

  1. PubMed: 35M+ articles searchable by gene, disease, drug, chemical
  2. Preprints: bioRxiv, medRxiv
  3. Filter by keywords, date, study type

API Endpoint

Production (No setup needed):

https://mcp.cloud.curiloo.com/tools/unified/mcp

All 14+ databases unified into one endpoint.

Running Locally:

bash
pip install medical-mcps
medical-mcps
# Available at: http://localhost:8000/tools/unified/mcp

Complete References

See detailed guides for each database:

  • PubMed Guide — Literature search (genes, diseases, keywords)
  • ClinicalTrials Guide — Find active trials
  • ChEMBL Guide — Drug-target data & bioactivity
  • OpenTargets Guide — Disease-target associations
  • OpenFDA Guide — Drug safety & adverse events
  • OMIM Guide — Genetic diseases (requires API key)
  • Other APIs — Reactome, UniProt, KEGG, GWAS, etc.

Workflow Example

Complete Drug Repurposing Pipeline:

See drug-repurposing-workflow.md for step-by-step example with all 8 steps + curl commands.


API Keys

Most APIs are free, no key required. Optional keys for higher rate limits:

Database Key? Why Get Key
ChEMBL No Public data (not needed)
OpenTargets No Public data (not needed)
PubMed No Public data (not needed)
ClinicalTrials No Public data (not needed)
OMIM Yes Proprietary data https://omim.org/api
OpenFDA Optional Higher rate limits https://open.fda.gov
NCI Clinical Trials Optional Higher rate limits https://clinicaltrialsapi.cancer.gov

Rate Limits & Caching

  • No authentication for production endpoint (public)
  • Rate limits: Generous (~1000+ requests/day per database)
  • Caching: Automatic 30-day HTTP caching (RFC 9111)
  • Cost: $0 (all databases public or researcher-accessible)

Common Patterns

Batch Query Loop

bash
# Search multiple targets
for gene in CHRNE RAPSN LRP4; do
  curl -X POST https://mcp.cloud.curiloo.com/tools/unified/mcp \
    -H "Content-Type: application/json" -H "Accept: application/json" \
    -d "{\"jsonrpc\":\"2.0\",\"method\":\"tools/call\",\"params\":{\"name\":\"chembl_find_drugs_by_target\",\"arguments\":{\"target_name\":\"$gene\",\"max_results\":10}},\"id\":1}"
  sleep 1  # Be nice to the API
done

ID Conversion

Need to convert IDs between databases?

bash
curl -X POST https://mcp.cloud.curiloo.com/tools/unified/mcp \
  -H "Content-Type: application/json" -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"nodenorm_get_normalized_nodes","arguments":{"curie":"HGNC:11998"}},"id":1}'

Returns: Equivalent IDs in NCBI Gene, Uniprot, Ensembl, MyGene, etc.


Troubleshooting

No results?

  • Try alternative terms (gene symbol vs protein name)
  • Check spelling
  • Use standardized IDs (gene symbols, disease names)
  • Some APIs use specific ID formats (EFO vs MONDO, etc.)

Too many results?

  • Add filters (max_results, phase, recruitment status)
  • Use limit or size parameters
  • Combine with other databases to narrow focus

API key errors?

  • OMIM requires API key — get from https://omim.org/api
  • Other databases optional — request key if hitting rate limits

Next Steps

  1. Pick a use case (drug repurposing, target discovery, etc.)
  2. Read the relevant database guide from References section
  3. Copy a quick recipe from above
  4. Customize parameters for your disease/gene/drug
  5. Scale up — build your full research workflow

Resources


Getting Help

  • Database not working? → Check Troubleshooting
  • Want detailed guide? → See Complete References
  • Need a workflow example? → See drug-repurposing-workflow.md
  • Question about OpenClaw? → See OPENCLAW-USAGE.md

Expand your agent's capabilities with these related and highly-rated skills.

FreedomIntelligence/OpenClaw-Medical-Skills

vcf-annotator

Annotate VCF variants with VEP, ClinVar, gnomAD frequencies, and ancestry-aware context. Generates prioritised variant reports.

2,009 275
Explore
FreedomIntelligence/OpenClaw-Medical-Skills

chemist-analyst

Analyzes events through chemistry lens using molecular structure, reaction mechanisms, thermodynamics, kinetics, and analytical techniques (spectroscopy, chromatography, mass spectrometry). Provides insights on chemical processes, material properties, reaction pathways, synthesis, and analytical methods. Use when: Chemical reactions, material analysis, synthesis planning, process optimization, environmental chemistry. Evaluates: Molecular structure, reaction mechanisms, yield, selectivity, safety, environmental impact.

2,009 275
Explore
FreedomIntelligence/OpenClaw-Medical-Skills

bio-alignment-io

Read, write, and convert multiple sequence alignment files using Biopython Bio.AlignIO. Supports Clustal, PHYLIP, Stockholm, FASTA, Nexus, and other alignment formats for phylogenetics and conservation analysis. Use when reading, writing, or converting alignment file formats.

2,009 275
Explore
FreedomIntelligence/OpenClaw-Medical-Skills

sleep-analyzer

分析睡眠数据、识别睡眠模式、评估睡眠质量,并提供个性化睡眠改善建议。支持与其他健康数据的关联分析。

2,009 275
Explore
FreedomIntelligence/OpenClaw-Medical-Skills

metabolomics-workbench-database

Access NIH Metabolomics Workbench via REST API (4,200+ studies). Query metabolites, RefMet nomenclature, MS/NMR data, m/z searches, study metadata, for metabolomics and biomarker discovery.

2,009 275
Explore
FreedomIntelligence/OpenClaw-Medical-Skills

bio-hi-c-analysis-matrix-operations

Balance, normalize, and transform Hi-C contact matrices using cooler and cooltools. Apply iterative correction (ICE), compute expected values, and generate observed/expected matrices. Use when normalizing or transforming Hi-C matrices.

2,009 275
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results