# Gdc

> Gdc is a freemium MCP server for health and science. Keyless search of NCI cancer genomics projects, cases and data files via MCP. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/gdc
- **Repository:** https://github.com/pipeworx-io/mcp-gdc
- **MCP Registry name:** io.github.pipeworx-io/gdc
- **Categories:** [health and science](https://ai-powered.com/categories/health-and-science)
- **Listing updated:** 2026-11-18

## About

The README describes this as a Pipeworx pack that wraps the NCI Genomic Data Commons, giving AI clients read access to cancer-genomics metadata from programs such as TCGA, TARGET and CPTAC. Four tools cover listing projects ranked by case count, looking up a single project by ID with summary counts, searching cases by primary site or project, and searching genomic data files by project or data category.

The server runs on the Pipeworx gateway over streamable HTTP, and can also be launched locally through an npm stdio bridge. Calls are anonymous by default and capped daily; an optional free API key raises the limit. The README notes that the hosted endpoint also lists shared gateway meta-tools such as ask_pipeworx alongside the pack's own tools.

The project is aimed at researchers and developers who want to query open-access GDC metadata from an assistant or script without writing their own API client. It is an unofficial integration and is not affiliated with the NCI.

## Features

- **Project listing and lookup:** Lists cancer-genomics projects ranked by case count and fetches a single project's details with case and file counts.
- **Case search:** Finds cancer cases by primary site and/or project, returning case and submitter IDs with disease type.
- **Genomic file search:** Searches data files by project or data category, returning file names, formats, access level and size.
- **Keyless open-access queries:** The listed tools need no API key and only use open-access metadata.
- **Multiple connection options:** Available as a hosted streamable-HTTP endpoint or as a local npm stdio bridge.

## Good for

- Finding which TCGA or TARGET projects cover a given primary cancer site
- Counting cases and files in a GDC project before planning a download
- Listing available RNA-seq or methylation data files for a cohort
- Letting an AI assistant answer questions about GDC metadata in plain English

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http gdc https://gateway.pipeworx.io/gdc/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/gdc/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gdc": {
      "url": "https://gateway.pipeworx.io/gdc/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gdc": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/gdc/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gdc": {
      "serverUrl": "https://gateway.pipeworx.io/gdc/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gdc": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/gdc/mcp"
    }
  }
}
```

## Tools

- `list_projects`: List NCI GDC cancer-genomics projects ranked by case count.
- `get_project`: Look up a single GDC project by project_id with case and file counts.
- `search_cases`: Search GDC cancer cases by primary site and/or project.
- `search_files`: Search GDC genomic data files by project and/or data category.

## FAQ

### Does it need an API key?

The four listed tools are keyless and open-access. The README says an optional free Pipeworx key raises the daily call cap from 50 to 200.

### Which projects does it cover?

The README names TCGA, TARGET and CPTAC as examples of the cancer-genomics projects the list tool returns.

### Can it run locally?

Yes. The @pipeworx/mcp-gdc npm package runs as a local stdio bridge, but it still forwards calls to the hosted gateway and needs network access.

### Is Gdc free?

Gdc has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Gdc to Claude Code?

Run this command in your terminal: claude mcp add --transport http gdc https://gateway.pipeworx.io/gdc/mcp

### What are the best alternatives to Gdc?

The closest alternatives to Gdc are Healthdata, Npi Registry, Idigbio, Medical Codes and Nih Supplements.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Healthdata](https://ai-powered.com/mcp/healthdata): Healthdata is a freemium MCP server for health and science.
- [Npi Registry](https://ai-powered.com/mcp/npi-registry): Npi Registry is a freemium MCP server for health and science.
- [Idigbio](https://ai-powered.com/mcp/idigbio): Idigbio is a freemium MCP server for health and science.
- [Medical Codes](https://ai-powered.com/mcp/medical-codes): Medical Codes is a freemium MCP server for health and science.
- [Nih Supplements](https://ai-powered.com/mcp/nih-supplements): Nih Supplements is a freemium MCP server for health and science.
- [Ensembl](https://ai-powered.com/mcp/ensembl): Ensembl is a freemium MCP server for health and science.
- [Health Feeds](https://ai-powered.com/mcp/health-feeds): Health Feeds is a freemium MCP server for health and science.
- [NCBI PubMed MCP by usefulapi](https://ai-powered.com/mcp/ncbi-pubmed-mcp-by-usefulapi): NCBI PubMed MCP by usefulapi is a freemium MCP server for health and science.

---
Source: https://ai-powered.com/mcp/gdc
