Open Targets Platform MCP

⚠️ DISCLAIMER: This project is currently experimental and under active development. Features, APIs, and documentation may change without notice ⚠️

Model Context Protocol (MCP) server for the

This package is the official Open Targets Platform MCP server implementation that enables AI assistants to interact with the Open Targets Platform GraphQL API, a comprehensive resource for target-disease associations and drug discovery data.

Quick Navigation

• Features

• Official MCP Server

• Local Deployment

• Advanced Deployment

• Available Commands

• Server Settings

• Available Tools

• Strategy

• Claude Desktop Setup

• Project Structure

• Testing

• Contributing

• License

Features

• 🔍 GraphQL Schema Access: Fetch and explore the complete Open Targets Platform GraphQL schema with detailed documentation

• 📊 Query Execution: Execute custom GraphQL queries against the Open Targets Platform API

• ⚡ Batch Query Processing: Execute the same query multiple times with different parameters efficiently

• 🔎 Entity Search: Search for entities across multiple types (targets, diseases, drugs, variants, studies)

• 🛠️ CLI Tools: Easy-to-use command-line interface for starting the server

• 🎯 jq Filtering (Optional): Server-side JSON processing using jq to reduce token consumption and improve performance. See jq Filtering for details.

Official MCP Server

The easiest way to use Open Targets Platform MCP is through the hosted service provided by Open Targets infrastructure at https://mcp.platform.opentargets.org/mcp

Local Deployment

Via uvx (Quick Start)

The fastest way to get started is using uvx, which will automatically download and run the package directly from GitHub.

Examples:

Docker Deployment

You can run the MCP server using the official Docker image:

Server Settings

For available CLI arguments and environment variables, see the Server Settings table.

Advanced Deployment

Both advanced deployment options require cloning the repository and setting up the virtual environment first:

FastMCP CLI

For advanced usage and to utilize all FastMCP options, you can use the FastMCP CLI directly with the server module:

Note: For all FastMCP CLI options, see the FastMCP documentation.
Note: Use environment variables (see Server Settings table) to configure the server when using FastMCP CLI.

Development Installation (Editable)

For development or to modify the codebase:

Available Commands

The package provides two command variants:

• otp-mcp: Shorter alias (recommended)

• open-targets-platform-mcp: Full command name

Both commands are functionally identical.

Server Settings

Configure the server using environment variables (all prefixed with OTP_MCP_). The following table shows all available configuration options:

Examples:

Using environment variables:

Using CLI options:

Note: CLI options take precedence over environment variables when both are provided.

Available Tools

The MCP server provides the following tools:

1. get_open_targets_graphql_schema: Fetch the complete GraphQL schema for the Open Targets Platform API, including detailed documentation for all types and fields

2. query_open_targets_graphql: Execute GraphQL queries to retrieve data about targets, diseases, drugs, and their associations

3. batch_query_open_targets_graphql: Execute the same GraphQL query multiple times with different variable sets for efficient batch processing

4. search_entities: Search for entities across multiple types (targets, diseases, drugs, variants, studies) and retrieve their standardized IDs

Strategy

The MCP server implements a 3-step workflow that guides the LLM to efficiently retrieve data from the Open Targets Platform:

Step 1: Learn Query Structure from Schema

The LLM calls get_open_targets_graphql_schema to understand the GraphQL API structure. The schema includes detailed documentation for all types and fields, enabling the LLM to construct valid queries.

Key entity types include:

• Targets/Genes: Use ENSEMBL IDs (e.g., ENSG00000139618 for BRCA2)

• Diseases: Use EFO/MONDO IDs (e.g., MONDO_0007254 for breast cancer)

• Drugs: Use ChEMBL IDs (e.g., CHEMBL1201583 for aspirin)

• Variants: Use "chr_pos_ref_alt" format or rsIDs

Step 2: Resolve Identifiers (if needed)

When a user query contains common names (gene symbols, disease names, drug names), the LLM uses search_entities to convert them to standardized IDs required by the API.

Step 3: Execute Query

The LLM constructs and executes GraphQL queries using:

• Standardized IDs from Step 2

• Query structure from the schema

• jq filters (optional, when enabled) to extract only requested fields, minimizing token consumption

Tool selection:

• query_open_targets_graphql for single queries

• batch_query_open_targets_graphql for multiple identical queries with different parameters (reduces latency and tokens)

jq Filtering (Optional)

The MCP server supports optional server-side JSON processing using jq expressions. This feature is disabled by default but can be enabled if you want to reduce token consumption.

Enable jq Filtering When:

• You want to reduce token consumption by extracting only specific fields from API responses

• Working with large API responses where only a subset of data is needed

• The calling LLM is proficient at tool calling and can reliably construct jq filters

Disable jq Filtering When:

• Simplicity is preferred over optimization

• Working with straightforward queries that don't benefit from filtering

• The LLM should receive complete API responses

How jq Filtering Works

When jq filtering is enabled, the query tools expose a jq_filter parameter. The jq filter is applied server-side before the response is returned, extracting only the relevant data and discarding unnecessary fields.

Example: To extract only the gene symbol and ID from a target query:

This significantly reduces token consumption by returning only the requested fields instead of the full API response.

Claude Desktop Setup

For detailed instructions on configuring the Open Targets Platform MCP server with Claude Desktop, including both remote hosted service and local installation configurations, see CLAUDE_DESKTOP.md.

Project Structure

Testing

Note: The test suite is currently AI-generated and will be reviewed and refined in the near future.

Contributing

Contributions are welcome! Please open an issue or submit a pull request on the GitHub repository.

License

This project is licensed under the terms of the license specified in LICENSE.