Open Targets Platform

You can run and query the Open Targets Platform MCP server to access the GraphQL API, execute custom queries, and search across multiple entity types. Use the hosted MCP service for quick access or run a local MCP server to integrate with your own tools and workflows.

How to use

Connect to the hosted MCP service at https://mcp.platform.opentargets.org/mcp to start making GraphQL requests against the Open Targets Platform API. For local development or custom workflows, run a local MCP server via the provided CLI (uvx) using the inline command shown below. You can perform three main actions: fetch the full GraphQL schema, execute single or batch GraphQL queries, and search entities across targets, diseases, drugs, variants, and studies. If you enable jq filtering, the server will extract only the requested fields server-side to reduce token usage.

Typical usage patterns you can follow:
- Use the hosted MCP URL for quick experimentation and testing.
- Run a local MCP server with the UVX-based command to customize the environment and use with your own tooling.
- When querying, you can perform a single query or a batch of queries with different parameters.
- Optionally enable jq filtering to trim the response down to only the fields you need.

How to install

# Hosted service does not require local installation
# To run locally using the UVX-based quick start:
uvx --from git+https://github.com/opentargets/open-targets-platform-mcp otp-mcp

Configuration and usage notes

Configuration is driven by environment variables or CLI options. You can control the API endpoint, server name, transport, host, port, timeouts, and optional jq processing. The following settings are exposed and can be used to tailor your MCP server behavior.

# Example: enable jq filtering and run on stdio transport locally
export OTP_MCP_TRANSPORT=stdio
export OTP_MCP_JQ_ENABLED=true
otp-mcp

Server endpoints and local deployment

Two primary deployment approaches exist: a hosted MCP service for instant access and a local MCP server for full control.

Hosted MCP URL

• https://mcp.platform.opentargets.org/mcp
• Use this URL to interact with the Open Targets Platform MCP server without installing anything locally.

Available tools

get_open_targets_graphql_schema

Fetches the complete GraphQL schema for the Open Targets Platform API with detailed documentation for all types and fields.

query_open_targets_graphql

Executes GraphQL queries to retrieve data about targets, diseases, drugs, and their associations.

batch_query_open_targets_graphql

Executes the same GraphQL query multiple times with different variable sets for efficient batch processing.

search_entities

Searches for entities across multiple types (targets, diseases, drugs, variants, studies) and retrieves standardized IDs.