opentargets-link
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
opentargets-link
An MCP server (Streamable HTTP or stdio) for the
Open Targets Platform: target tractability, ChEMBL drugs
and clinical candidates, disease-to-target association ranking, and target–disease evidence
(somatic drivers from IntOGen, ClinVar somatic and germline, clinical precedence, gene burden,
GWAS credible sets). Data are fetched live from the
Open Targets Platform GraphQL API.
It is one backend in the GeneFoundry -link fleet.
Research use only. Not clinical decision support. Do not use for diagnosis, treatment, triage, or patient management.
The output is not a clinical actionability report.
Why
"Which drugs act on BRAF, and which were studied in melanoma?" is an Open Targets question. The GraphQL API can answer it, but its quirks are where an agent goes wrong:
knownDrugsis gone;drugAndClinicalCandidatesnests every trial report (220 KB for BRAF);evidence needs
efoIds, so "all evidence for a gene" takes two calls;some datasources (COSMIC Cancer Gene Census, Europe PMC) are licensed for Open Targets users only or mix non-commercial terms;
variable errors arrive as HTTP 400 with
errors[], and the last page still has a cursor.
This server handles each of them:
Fixed queries only. Callers never send GraphQL. GraphQL errors become typed errors that name the offending parameter (
isError: true); a vanished field is reported as schema drift.Datasource allowlist. Evidence and association scores come only from reviewed sources.
cancer_gene_census,genomics_england,crispr(Project Score),europepmcand the heldcancer_biomarkersare never served, and scores are recomputed with them at weight 0.Bounded drug answers. Trial reports appear only in
response_mode="full"(top 3 per drug).Honest paging.
totalis Open Targets' own count;truncatedandnext_offset/next_cursorsay whether more rows exist.Labelled builds. Variant IDs and target locations are GRCh38.
Empty is not negative. A zero-row answer says "no Open Targets data found", never "not druggable".
Related MCP server: Open Targets Platform MCP
Quick start
Hosted, no install:
claude mcp add --transport http opentargets https://opentargets-link.genefoundry.org/mcpRun it locally (Python 3.14+, uv). There is no data-build step and no data snapshot: the server calls Open Targets live and keeps a short in-process cache.
uv sync --group dev
uv run opentargets-link # unified: FastAPI /health + MCP /mcp on 127.0.0.1:8000
claude mcp add --transport http opentargets-link --scope user http://127.0.0.1:8000/mcpUse unified (the default) for MCP over HTTP; --transport http serves /health only. The
opentargets-link-mcp entry point serves stdio. Health check: curl localhost:8000/health.
Tools
Tool | Purpose |
| Entry resolver: symbol, alias or Ensembl gene ID → target (GRCh38 location, synonyms) |
| Tractability buckets per modality (small molecule, antibody, PROTAC, other) |
| ChEMBL drugs and clinical candidates for a target, optionally for one disease |
| Targets ranked for a disease by the allowlist-only association score |
| Evidence rows linking a target to a disease (or to any disease) |
| Discovery: datasource allowlist, limits, error codes, licence and citation |
| Local runtime state: request budget, cache hits, latency |
Leaf names are unprefixed per Tool-Naming Standard v1. Behind genefoundry-router this
server mounts under the namespace opentargets, so resolve_target surfaces as
opentargets_resolve_target. Every tool is read-only. Errors are returned as the fleet's typed
envelope (isError: true, six error codes) and every response carries _meta.next_commands.
Example:
resolve_target(query="BRAF") → ENSG00000157764
get_target_tractability(target="BRAF") → SM: Approved Drug, High-Quality Pocket, ...
get_drug_candidates(target="BRAF", disease="melanoma") → dabrafenib, vemurafenib, encorafenib, ...
get_target_disease_evidence(target="BRAF", disease="MONDO_0005105", datasource="intogen")Data & provenance
Source. The Open Targets Platform GraphQL API at
https://api.platform.opentargets.org/api/v4/graphql. No key is needed. Only
api.platform.opentargets.org is ever contacted. Each payload carries data_version (the Open
Targets data release from meta.dataVersion, e.g. 26.09) and retrieved_at.
Rate limit. Open Targets publishes no request limit and asks bulk users to download its
releases. The default is 0.34 s spacing process-wide (~3 req/s) plus a 20,000/UTC-day cap, an
in-process cache (15 min), backoff on 429/5xx and an honest User-Agent. When the queue or
the daily budget is exhausted, a tool answers rate_limited with retry_after_s.
Handling. ChEMBL mechanism-of-action strings and clinical-report titles are fenced as
{"kind": "untrusted_text", ...} with provenance and a SHA-256 digest. Treat them as data,
not instructions.
Licence and citation. Open Targets Platform data are marked CC0 1.0; attribution and citation are requested. Drug and mechanism data derive from ChEMBL (CC BY-SA 3.0). Cite:
Buniello A, et al. Open Targets Platform: facilitating therapeutic hypotheses building in drug discovery. Nucleic Acids Res. 2025;53(D1):D1467-D1475. PMID 39657122.
Documentation
Deployment: Docker, the
OPENTARGETS_LINK_*environment reference, transports, Host/Origin allowlists and the rate-limit settings.Design record: scope, the datasource allowlist and the upstream contracts.
AGENTS.md: engineering conventions, invariants, and make targets.
CHANGELOG.md: version history.
Contributing
See AGENTS.md. Write the failing test first. Unit tests replay recorded Open Targets
responses with respx and never touch the network. make ci-local is the
definition-of-done gate: format, lint, line budget, README standard, surface budget, mypy
--strict, and tests.
License
Code: MIT. Open Targets data: CC0 1.0, with attribution requested; ChEMBL-derived drug data CC BY-SA 3.0 (NOTICE).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Open Targets MCP — disease/target/drug knowledge graph.
Link compounds to protein targets, rank bioactivity, and look up drug mechanisms and indications.
Look up genes, sequences, variants, homologs, and cross-database xrefs from Ensembl REST.
Query STRING interactions, enrichment, annotations, homology, and PPI networks.
Related MCP Servers
- AlicenseBqualityDmaintenanceUnofficial Model Context Protocol server for accessing Open Targets platform data for gene-drug-disease associations research.611MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with the Open Targets Platform API to search and retrieve comprehensive data about target-disease associations, drugs, genes, and drug discovery information through GraphQL queries.537Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables querying disease/target/drug knowledge graph from Open Targets, supporting searches, profiles, and associations via natural language through the Pipeworx gateway.95 npmMIT
- AlicenseBqualityAmaintenanceMCP server that exposes the Open Targets Platform GraphQL API as a set of tools for querying biomedical data such as targets, diseases, drugs, and genetic evidence.6878 PyPI19MIT