Heuris-BioMCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NCBI_API_KEY | No | NCBI API key (increases rate limit to 10/s from default 3/s) | |
| BIOGRID_API_KEY | No | BioGRID key for curated interaction queries | |
| BIOMCP_API_KEYS | No | Comma-separated API keys in key_id:secret form | |
| BIOMCP_HTTP_PORT | No | HTTP port for hosted SSE deployments | 8080 |
| BIOMCP_LOG_LEVEL | No | Log level: DEBUG/INFO/WARNING/ERROR | INFO |
| BIOMCP_TRANSPORT | No | Transport mode: stdio or http | stdio |
| NVIDIA_NIM_API_KEY | No | Shared fallback key for both NVIDIA model integrations | |
| BIOMCP_AUTH_ENABLED | No | Require auth for hosted MCP requests | |
| NVIDIA_EVO2_API_KEY | No | NVIDIA API key for Evo2-40B DNA generation | |
| BIOMCP_CACHE_WARMING | No | Enable background cache warming in HTTP mode | auto |
| BIOMCP_OAUTH_ENABLED | No | Enable OAuth 2.1 PKCE endpoints when auth is enabled | 1 |
| NVIDIA_BOLTZ2_API_KEY | No | NVIDIA API key for Boltz-2 structure prediction | |
| BIOMCP_SESSION_STORE_DIR | No | Durable directory for saved sessions | .biomcp_sessions |
| BIOMCP_CORS_ALLOW_ORIGINS | No | Comma-separated browser origins allowed for CORS | |
| BIOMCP_OAUTH_AUTO_APPROVE | No | Auto-approve the consent screen for single-user deployments | 0 |
| BIOMCP_OAUTH_DEFAULT_SUBJECT | No | Subject bound to approved OAuth tokens | heuris-biomcp-user |
| BIOMCP_HTTP_RATE_LIMIT_ENABLED | No | Enable per-client HTTP rate limiting | 1 |
| BIOMCP_HTTP_RATE_LIMIT_REQUESTS | No | Requests allowed per rate-limit window | 120 |
| BIOMCP_API_KEY_RATE_LIMIT_REQUESTS | No | Per-key request budget per window | 600 |
| BIOMCP_HTTP_AUTH_RATE_LIMIT_REQUESTS | No | Requests allowed per authenticated window | 600 |
| BIOMCP_HTTP_RATE_LIMIT_WINDOW_SECONDS | No | Rate-limit window length in seconds | 60 |
| BIOMCP_API_KEY_RATE_LIMIT_WINDOW_SECONDS | No | Per-key rate-limit window in seconds | 60 |
| BIOMCP_HTTP_AUTH_RATE_LIMIT_WINDOW_SECONDS | No | Authenticated rate-limit window length in seconds | 60 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_pubmedA | Search PubMed for scientific literature. Supports full NCBI query syntax (MeSH terms, Boolean operators, field tags, date ranges). Returns articles with title, authors, abstract, DOI, PMID, journal, year, and MeSH terms. Results auto-indexed into session knowledge graph. |
| get_gene_infoA | Retrieve gene information from NCBI Gene — symbol, full name, chromosomal location, aliases, RefSeq IDs, and functional summary. Auto-indexes gene entity into session knowledge graph. |
| run_blastA | Run NCBI BLAST sequence alignment (blastp/blastn/blastx/tblastn). Async polling — waits up to 120s for results. |
| get_protein_infoA | Full UniProt Swiss-Prot entry: function, domains, PTMs, GO terms, disease links, sequence. Prefer reviewed accessions (P/Q/O prefix). Auto-indexes protein + disease edges into session knowledge graph. |
| find_proteinA | Unified protein discovery across UniProt and PDB. Use accession for a direct record lookup or query to search reviewed proteins and experimental structures. |
| get_alphafold_structureA | AlphaFold DB predicted structure: per-residue pLDDT confidence stats, PDB/mmCIF download URLs. pLDDT ≥90=very high, 70–90=confident, <50=disordered. |
| pathway_analysisB | Merged pathway workflow. Search KEGG, retrieve genes for a pathway, or assemble Reactome plus KEGG context for a gene. |
| get_drug_targetsA | ChEMBL drug-target activities: IC50, Ki, Kd values, assay types, approval status. Auto-indexes drug→gene edges into knowledge graph. |
| get_gene_disease_associationsA | Open Targets gene-disease evidence across 6 datatypes: genetic_association, somatic_mutation, known_drug, animal_model, affected_pathway, literature. Auto-indexes gene→disease edges into knowledge graph. |
| search_clinical_trialsA | ClinicalTrials.gov v2: trial status, phase, interventions, enrollment, eligibility. Auto-indexes drug→disease treatment edges from trials. |
| multi_omics_gene_reportA | FLAGSHIP: 7-database parallel integration — NCBI Gene, PubMed, Reactome, ChEMBL, Open Targets, GEO, ClinicalTrials.gov. One call, complete overview. |
| predict_structure_boltz2B | Boltz-2 structure workflow. Use mode='structure' for direct multimolecular structure prediction or mode='protein_ligand' for the integrated UniProt-to-docking workflow. |
| generate_dna_evo2A | Evo2 DNA workflow. Use mode='generate' for sequence generation or mode='score' for wildtype-versus-variant scoring. |
| crispr_analysisC | Merged CRISPR workflow covering guide design, guide scoring, off-target review, base editing, and repair outcome estimation. |
| drug_safetyA | Merged FDA drug-safety workflow for adverse-event search, signal detection, label review, and head-to-head comparison. |
| variant_analysisA | Merged variant-interpretation workflow for ACMG classification, population frequency, ClinVar review, splice review, and full integrated reporting. |
| find_repurposing_candidatesA | Drug repurposing engine: surface approved drugs with activity against a target/disease. |
| verify_biological_claimC | Verify a biological claim with structured claim decomposition and relation-specific database evidence. |
| search_cbio_mutationsB | cBioPortal cancer mutation frequencies across TCGA cohorts. |
| search_gwas_catalogB | NHGRI-EBI GWAS Catalog: genome-wide significant associations for a gene. |
| bulk_gene_analysisA | Analyze one or two gene panels in parallel and return a cross-gene comparison matrix. In differential mode it ranks pathways and diseases enriched in panel A versus panel B using panel-level hit fractions and fold-change-style scoring. |
| sessionC | Merged research-session workflow for entity resolution, live graph inspection, persisted graph save/restore via MCP resources, provenance export, and automated planning. |
| drug_interaction_checkerB | Check FDA label interaction context between a primary drug and a list of co-medications. |
| protein_binding_pocketA | Summarize candidate binding sites from UniProt functional-site annotations plus AlphaFold confidence context. |
| biomarker_panel_designA | Draft a disease-focused biomarker panel using Open Targets evidence with a literature fallback. |
| pharmacogenomics_reportB | Summarize CPIC-style pharmacogenomic genes and supporting PGx evidence for a drug. |
| protein_family_analysisA | Summarize protein family and domain context from curated UniProt annotations with direct Pfam and InterPro links. |
| network_enrichmentA | Summarize recurrent Reactome pathways and STRING network hubs across a gene set. |
| rnaseq_deconvolutionA | Marker-based heuristic deconvolution of a bulk RNA-seq profile into likely cell-type fractions. |
| structural_similarityA | PubChem-backed structural similarity search from a compound name or SMILES string. |
| rare_disease_diagnosisA | Normalize phenotype terms and rank OMIM differentials for a candidate gene. |
| genome_browser_snapshotA | Generate genome-browser links and locus context for a gene or explicit genomic interval. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| server-capabilities | Transport, health, capability, and deployment-facing metadata. |
| tool-catalog | Public tool inventory with required arguments and example payloads. |
| server-status | Deployment status, HTTP policy, persistence configuration, and capability health. |
| entity-resources | How to access gene, disease, and watch resources via biomcp:// URIs. |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/SachinGawande2003/Heuris-BioMCP'
If you have feedback or need assistance with the MCP directory API, please join our Discord server