# CAN-IMMUNE MCP Server

Remote, read-only [Model Context Protocol](https://modelcontextprotocol.io) server for
**[CAN-IMMUNE](https://canelib.erc.monash.edu)** — a cancer neoantigen platform. Lets any
AI agent (Claude, ChatGPT, Cursor, ...) query the database in plain language.

- **Registry:** `io.github.sanjaysgk/can-immune`
- **Endpoint:** `https://canelib.erc.monash.edu/mcp` (Streamable HTTP)
- **Docs / how to connect:** https://canelib.erc.monash.edu/connector

## Connect

Add the endpoint as a custom connector, or:

```
claude mcp add --transport http canelib https://canelib.erc.monash.edu/mcp
```

## Tools (read-only)

`database_overview`, `search` / `fetch`, `search_genes`, `get_gene`, `search_cell_lines`,
`get_cell_line`, `top_genes_in_cell_line`, `get_gene_mutations`, `list_tissues`,
`list_cancer_types`, `get_mhc_binding`.

## Auth & rate limits

Works anonymously at a light rate. Optional Google sign-in (OAuth 2.1) raises the limit —
academic emails (`.edu`, `.edu.au`, `.ac.*`) get the highest tier. Every query is
parameterised, row-capped and time-bounded. Data: COSMIC, DepMap/CCLE, PubMed.

## Source

`canelib_mcp.py` — the tools + server. `oauth.py` — the OAuth 2.1 / tiering layer.
Secrets live outside the repo (see `.gitignore`).