bc_get_open_targets_query_examples
Retrieve example GraphQL queries for the Open Targets API to explore common use cases for target, drug, and disease data.
Instructions
Retrieve example GraphQL queries for the Open Targets API. Examples demonstrate common use cases.
Returns: dict: Example queries mapped by category (informationForTarget, drugsForTarget, associatedDiseases, etc.) with GraphQL query strings.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- Handler function decorated with @core_mcp.tool() that returns the EXAMPLE_QUERIES dict containing 7 example GraphQL query strings for the Open Targets API.
@core_mcp.tool() def get_open_targets_query_examples() -> dict: """Retrieve example GraphQL queries for the Open Targets API. Examples demonstrate common use cases. Returns: dict: Example queries mapped by category (informationForTarget, drugsForTarget, associatedDiseases, etc.) with GraphQL query strings. """ return EXAMPLE_QUERIES - Tool registration via @core_mcp.tool() decorator on the handler function, using the core_mcp FastMCP server instance from biocontext_kb.core._server.
from biocontext_kb.core._server import core_mcp EXAMPLE_QUERIES = { "informationForTargetByEnsemblId": """ - EXAMPLE_QUERIES dict containing 7 pre-defined example GraphQL queries covering targets, diseases, drugs, and associations.
EXAMPLE_QUERIES = { "informationForTargetByEnsemblId": """ query informationForTargetByEnsemblId { target(ensemblId: "ENSG00000169083") { id approvedSymbol tractability { modality label value } safetyLiabilities { event eventId biosamples { cellFormat cellLabel tissueLabel tissueId } effects { dosing direction } studies { name type description } datasource literature } } } """, "drugsForTargetByEnsemblId": """ query geneAssociatedDrugs { target(ensemblId: "ENSG00000159640") { id pharmacogenomics { isDirectTarget target { approvedName } drugs { drug { id name mechanismsOfAction { rows { targets { approvedName } } uniqueTargetTypes uniqueActionTypes } isApproved } } } } } """, "associatedDiseasesForTargetByEnsemblId": """ query associatedDiseasesForTargetByEnsemblId { target(ensemblId: "ENSG00000127318") { id approvedSymbol associatedDiseases { count rows { disease { id name } datasourceScores { id score } } } } } """, "informationForDiseaseByEFOId": """ query informationForDiseaseByEFOId { disease(efoId: "EFO_0000222") { id name phenotypes { rows { phenotypeHPO { id name description namespace } phenotypeEFO { id name } evidence { aspect bioCuration diseaseFromSourceId diseaseFromSource evidenceType frequency frequencyHPO { name id } qualifierNot onset { name id } modifiers { name id } references sex resource } } } } } """, "knownDrugsForDiseaseByEFOId": """ query knownDrugsForDiseaseByEFOId { disease(efoId: "EFO_0004705") { id name knownDrugs { count uniqueTargets uniqueDrugs rows { drugId drugType prefName targetId targetClass approvedSymbol mechanismOfAction phase status diseaseId drug { id name maximumClinicalTrialPhase description synonyms } target { id approvedSymbol approvedName } } } } } """, "associatedTargetsForDiseaseByEFOId": """ query associatedTargets { disease(efoId: "EFO_0000349") { id name associatedTargets { count rows { target { id approvedSymbol } score } } } } """, "informationForDrugByChemblId": """ query informationForDrugByChemblId { drug(chemblId: "CHEMBL25") { name id yearOfFirstApproval tradeNames isApproved hasBeenWithdrawn blackBoxWarning drugType approvedIndications mechanismsOfAction { uniqueTargetTypes uniqueActionTypes } linkedTargets { rows { id approvedName pathways { pathwayId pathway topLevelTerm } } } } } """, } - Function signature defines return type as dict - no input parameters and returns a dictionary of example query strings.
def get_open_targets_query_examples() -> dict: """Retrieve example GraphQL queries for the Open Targets API. Examples demonstrate common use cases. Returns: dict: Example queries mapped by category (informationForTarget, drugsForTarget, associatedDiseases, etc.) with GraphQL query strings. """