CIViC MCP Server

What is CIViC MCP Server?

This Cloudflare Workers-based MCP server provides tools for querying the CIViC (Clinical Interpretation of Variants in Cancer) API. It converts GraphQL responses into queryable SQLite tables using Durable Objects, enabling AI assistants to analyze cancer genomics information through natural language.

How to use CIViC MCP Server?

Deploy the server to Cloudflare Workers (npm install && npm run deploy), then configure Claude Desktop with mcp-remote pointing to the deployed URL. Once configured, Claude can use three tools: civic_graphql_query, civic_query_sql, and civic_execute. Three MCP prompts (get-variant-evidence, get-variant-assertions, get-variant-data) guide the model with correct GraphQL syntax.

Key features of CIViC MCP Server

• GraphQL to SQL conversion into structured SQLite tables
• Efficient data storage via Cloudflare Durable Objects with SQLite
• Smart response handling: bypasses staging for small, error, empty, or schema introspection responses
• Tool pipeline: GraphQL query, SQL analysis, and Code Mode (JavaScript execution)
• MCP 2025-06-18 compliance with Streamable HTTP transport
• Three MCP prompts for guided, fallback-aware GraphQL queries

Use cases of CIViC MCP Server

• Query the latest evidence items for specific mutations (e.g., BRAF V600E)
• Retrieve therapeutic interpretations for lung cancer variants
• Find genes with the most evidence items in the CIViC database
• Analyze staged data using custom SQL queries
• Use Code Mode to run JavaScript against the CIViC GraphQL API in a V8 isolate