`region`

Pack: gnomad · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/region for the schema, then POST the same URL with its arguments for the data.

Variants in a genomic region (≤25kb recommended). You MUST say which genome build your start/stop are in via assembly — there is no default, because a position is valid in both builds and a wrong guess returns real variants from the wrong locus rather than an error. Variants are paged (default 500, max 2,000 per call); variants_page gives the exact total and next_offset.

Parameters

Name	Type	Required	Description
`chrom`	string	yes	e.g. “1”, “X”, “MT”
`start`	number	yes
`stop`	number	yes
`assembly`	string	yes
`dataset`	string	no	Default ${DEFAULT_DATASET} (GRCh38). gnomad_r2_1* and exac are GRCh37.

Example call

Arguments

{
  "chrom": "1",
  "start": 55000000,
  "stop": 55025000,
  "assembly": "GRCh38"
}

curl

curl -X POST https://gateway.pipeworx.io/gnomad/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"region","arguments":{"chrom":"1","start":55000000,"stop":55025000,"assembly":"GRCh38"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('region', {
  "chrom": "1",
  "start": 55000000,
  "stop": 55025000,
  "assembly": "GRCh38"
});

More examples

{
  "chrom": "1",
  "start": 11856300,
  "stop": 11856500,
  "assembly": "GRCh37",
  "dataset": "gnomad_r2_1"
}

Response shape

Field	Type	Description
`region`	object
`truncated`	boolean	True when this response holds fewer variants than gnomAD has (see variants_page)
`variants_page`	object	How the variant list was paged. gnomAD returns every variant with no limit of its own, so the pack pages it; total is exact.

Full JSON Schema

{
  "type": "object",
  "properties": {
    "region": {
      "type": "object",
      "properties": {
        "variants": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "variant_id": {
                "type": "string",
                "description": "Variant identifier"
              },
              "rsids": {
                "type": [
                  "array",
                  "null"
                ],
                "description": "rsID identifiers"
              },
              "consequence": {
                "type": "string",
                "description": "VEP consequence"
              },
              "exome": {
                "type": [
                  "object",
                  "null"
                ],
                "properties": {
                  "ac": {
                    "type": "number",
                    "description": "Allele count"
                  },
                  "an": {
                    "type": "number",
                    "description": "Allele number"
                  },
                  "af": {
                    "type": "number",
                    "description": "Allele frequency"
                  }
                }
              },
              "genome": {
                "type": "object",
                "properties": {
                  "ac": {
                    "type": "number",
                    "description": "Allele count"
                  },
                  "an": {
                    "type": "number",
                    "description": "Allele number"
                  },
                  "af": {
                    "type": "number",
                    "description": "Allele frequency"
                  }
                }
              }
            }
          }
        }
      }
    },
    "truncated": {
      "type": "boolean",
      "description": "True when this response holds fewer variants than gnomAD has (see variants_page)"
    },
    "variants_page": {
      "type": "object",
      "description": "How the variant list was paged. gnomAD returns every variant with no limit of its own, so the pack pages it; total is exact.",
      "properties": {
        "total": {
          "type": "number",
          "description": "Variants gnomAD holds for this query"
        },
        "returned": {
          "type": "number",
          "description": "Variants in this response"
        },
        "offset": {
          "type": "number",
          "description": "Variants skipped before this page"
        },
        "limit": {
          "type": "number",
          "description": "Page size applied"
        },
        "next_offset": {
          "type": [
            "number",
            "null"
          ],
          "description": "Offset for the next page, null on the last page"
        },
        "upstream_bytes": {
          "type": "number",
          "description": "Size of the full upstream response, in bytes"
        },
        "note": {
          "type": "string",
          "description": "Plain-language statement of what is and is not in this page"
        }
      }
    }
  }
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

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

Connect to just the gnomad pack

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

See Getting Started for client-specific install steps.

region