# io.github.sanjaysgk/can-immune

> Query CAN-IMMUNE: cancer neoantigen mutations, peptides, cell lines, MHC-I binding. Read-only.

- name: io.github.sanjaysgk/can-immune
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 94/100
- quality: 79/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.sanjaysgk%2Fcan-immune
- tools: https://api.protogrid.dev/v1/servers/io.github.sanjaysgk%2Fcan-immune/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "can-immune": {
      "type": "http",
      "url": "https://canelib.erc.monash.edu/mcp"
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 100
- freshness: 85
- provenance: 90
- drivers: +repository +namespace-matches-repo +website +reachable +uptime-100% ~updated-71d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 79/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 71 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: database_overview (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); search_genes (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_gene (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 2,083 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: no tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 12, about 2,083 tokens to load them all
- tool set hash: f82ff9f643bbb512396d7dac16ec788f
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.sanjaysgk/can-immune.svg)](https://protogrid.dev/servers/io.github.sanjaysgk/can-immune)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://canelib.erc.monash.edu/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (12)

- `database_overview`: Get the headline size of the CAN-IMMUNE database in one call.

    Returns total counts of mutations, genes, and unique mutant peptides, plus how
    many cell lines, tissues, and cancer types are covered, and the data sources
    (COSMIC, DepMap/CCLE, PubMed). Use this first to size the resource or to answer
    "how big is the database / how many X are there" questions. No parameters.
- `fetch`: Fetch the full record for an id returned by `search` (ChatGPT connector interface).

    Takes an id like 'gene:TP53' or 'cell_line:MDA-MB-231' and returns
    {id, title, text, url, metadata} where `text` is the full JSON profile (same data
    as get_gene / get_cell_line). Always call `search` first to obtain a valid id.
- `get_cell_line`: Get the full profile for one cancer cell line by exact name.

    Returns tissue of origin, cancer type, total mutations, unique mutant peptides and
    genes, data sources, Cellosaurus and DepMap model IDs, gender, category / cell
    type, and the top ~15 most-mutated genes in that line, plus a link to its page.
    Use after `search_cell_lines`, or when the exact name is known, for a deep dive on
    one line. Returns an error field if the name is not found.
- `get_gene`: Get the full profile for one gene by exact symbol.

    Returns total mutations and how they split between cell lines vs tissues, unique
    mutant peptides, sample and transcript counts, UniProt accession / name / reviewed
    status, the top ~15 recurrent mutations in that gene, and a link to the gene page.
    Use this after `search_genes` (or when you already know the symbol) to answer
    detailed questions about a single gene. Returns an error field if the symbol is
    not found.
- `get_gene_mutations`: List individual mutations in a gene (a bounded sample of rows).

    Each row gives the CAN-IMMUNE mutation ID (CANLIB...), the amino-acid change, the
    CDS change, mutation type (missense / complex substitution), data source, the
    sample it came from, its primary site, and the mutant peptide. Ordered by mutation
    ID. Capped at `limit` rows (max 100) for speed - for the complete table of a
    heavily-mutated gene, link the user to the gene page on the website.
- `get_mhc_binding`: Look up a CACHED MHC-I binding prediction for a peptide + HLA allele.

    Returns the NetMHCpan result (best binding core, %Rank_EL, binder level
    SB/WB/NB, and neoepitope %Rank_Neo when computed) for predictions already stored
    in the cache. This tool does NOT run new predictions - it only reads cached ones;
    if nothing is cached it returns cached=false with a note. To generate a new
    prediction, use the interactive button on the mutation page of the website.
- `list_cancer_types`: List cancer types (histology) ranked by mutation burden.

    Returns each cancer type / histology with its total mutations, unique samples, and
    unique genes, most-mutated first. Use to see which cancer types dominate the
    database or to pick one for further drill-down on the website.
- `list_tissues`: List primary tissues ranked by mutation burden.

    Returns each tissue (COSMIC primary-tissue samples only, kept separate from cell
    lines) with its total mutations, unique samples, and unique genes, most-mutated
    first. Use for tissue-level questions; for cell lines use `search_cell_lines`.
- `search`: Search CAN-IMMUNE for genes and cell lines (ChatGPT connector interface).

    Returns {results: [{id, title, url}]} combining matching genes and cell lines,
    each with a stable `id` (like 'gene:TP53' or 'cell_line:MDA-MB-231'). Pass that
    `id` to `fetch` to retrieve the full record. This is the generic search endpoint
    ChatGPT expects; MCP-native clients can also use the more specific `search_genes`
    / `search_cell_lines` tools.
- `search_cell_lines`: Find cancer cell lines by name, ranked by mutation burden.

    Returns each matching cell line with its tissue of origin, cancer type, total
    mutations, unique mutant peptides, data sources (COSMIC / DepMap-CCLE / PubMed),
    and Cellosaurus ID. Covers only cell-line models (kept separate from primary
    tissue samples). Use before `get_cell_line` or `top_genes_in_cell_line`. Ordered
    by mutation count (most mutated first).
- `search_genes`: Find genes by symbol or full name, ranked by how mutated they are.

    Matches the gene symbol OR the full gene name (partial, case-insensitive) and
    returns each hit with its total mutation count, unique mutant-peptide count,
    sample count, and UniProt accession. Use it to locate a gene before calling
    `get_gene`, or to rank a set of genes by mutation burden. Results are ordered by
    mutation count (most mutated first).
- `top_genes_in_cell_line`: Rank the most-mutated genes within one specific cell line.

    Answers "what is the top mutated gene in <cell line>" / "which genes are most
    altered in <cell line>". Returns genes with their mutation counts for that line,
    highest first, from precomputed per-cell-line stats (fast). For the whole profile
    of the line use `get_cell_line` instead.
