`immunology_search`

Pack: catnap · Endpoint: https://gateway.pipeworx.io/catnap/mcp

Search the LANL HIV Molecular Immunology Database for T-cell epitopes (CTL/CD8+ or T-helper/CD4+) or antibody binding sites — a different question from catnap_search_neutralization: this is about WHERE on the virus an immune response targets and WHICH HLA restricts it, not how potently an antibody neutralizes. Answers “what CTL epitopes are in HIV Gag”, “which antibodies bind the CD4 binding site”, “what HLA restricts this epitope”, “find epitopes at position 296-331 of Env”. Queried LIVE against LANL’s own keyless JSON API (no ingest — always current). table selects which of the three response types you get: ctl (CD8+ T-cell), helper (CD4+ T-cell), or ab (antibody binding sites). At least one of mab_name, epitope, protein_name is required. Returns citation, keywords, HXB2 coordinates and (for ab) binding region/neutralizing classification for each match.

Parameters

Name	Type	Required	Description
`table`	string	yes	”ctl” = CD8+ T-cell epitopes, “helper” = CD4+ T-cell epitopes, “ab” = antibody binding sites.
`mab_name`	string	no	Antibody name or alias. “ab” table only.
`epitope`	string	no	Epitope amino acid sequence, e.g. “GGKKKYKLK”. Matches if this sequence is contained in the epitope.
`protein_name`	string	no	HIV protein name, e.g. “Gag”, “Env”, “Nef”.
`limit`	number	no	Maximum records to return (default 20, max 100) — applied client-side after the upstream call.

Example call

Arguments

{
  "table": "ctl",
  "epitope": "GGKKKYKLK"
}

curl

curl -X POST https://gateway.pipeworx.io/catnap/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"immunology_search","arguments":{"table":"ctl","epitope":"GGKKKYKLK"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('immunology_search', {
  "table": "ctl",
  "epitope": "GGKKKYKLK"
});

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "catnap": {
      "url": "https://gateway.pipeworx.io/catnap/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

immunology_search