Spiral gives your agent every tool with one account. Browse the tools →

ChatGPT · Health

How to Use gnomAD gene constraint in ChatGPT

Returns gnomAD observed and expected variant counts, observed/expected ratios, LOEUF, pLI, and missense and synonymous Z-scores. Use it to compare genes' tolerance to variation and prioritize research candidates.

Prompts to try with gnomAD gene constraint in ChatGPT

Copy an example into ChatGPT, or ask in your own words.

Use gnomAD gene constraint to compare SCN1A, SCN2A, and KCNQ2 on the GRCh38 reference genome. Show LOEUF, pLI, and observed and expected loss-of-function counts.

gnomAD gene constraintChatGPT
Try asking
  • Use gnomAD gene constraint to compare CHD7 and CHD8. Show the transcript behind each result and explain their loss-of-function observed/expected ratios.

  • Use gnomAD gene constraint to show PTEN's available transcript scores. Explain how the transcript choice affects the comparison.

  • Use gnomAD gene constraint to compare missense and synonymous Z-scores for CFTR, HBB, and PAH. Include the observed and expected counts for each category.

  • Use gnomAD gene constraint to compare SCN1A results on GRCh37 and GRCh38. Explain the differences in observed/expected ratios and Z-scores.

How to set up gnomAD gene constraint in ChatGPT

Pick the way that suits you. Each takes about two minutes.

Use the ChatGPT connector

  1. Add a custom MCP server

    In ChatGPT open Plugins, then Add › Add custom MCP server. Name it Spiral, paste this URL and keep Authentication on OAuth. Tick I understand and want to continue, then click Create.

    https://api.spiral.ai/mcp
  2. Click Connect

    ChatGPT asks to connect Spiral. Connect takes you to Spiral in your browser.

  3. Sign in to Spiral and approve

    Sign in, pick the organization ChatGPT should use and click Authorize. Spiral gives the connection its own API key; ChatGPT never sees it, and you can remove the connection under Settings › Connected apps.

Use the Spiral skill

  1. Send ChatGPT this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run gnomAD gene constraint

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "alexandria",
        "model": "gnomad-broadinstitute-org/genes/constraint",
        "input": {
          "gene": "<gene>"
        }
      }'

Then paste one of the prompts above: ChatGPT finds gnomAD gene constraint on Spiral, shows the price and runs it.

gnomAD gene constraint providers and prices

Spiral runs gnomAD gene constraint through Alexandria. Open a card for today's price, with every fee included.

AlexandriaHealth

Settings you can ask for

Ask ChatGPT for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Reference genomeGRCh38 or GRCh37

GRCh38 for gnomAD v4.1.2 constraint (the default) or GRCh37 for v2.1.1. A pasted URL's dataset picks it when this is absent.

Every API field of Population allele frequencies and gene constraint (Broad Institute) · Constraint is on its tool page: open its card above.

What can you do with gnomAD gene constraint in ChatGPT?

Build a readable comparison of constraint evidence for research genes such as SCN1A and CHD7. A chat app can explain the observed and expected counts alongside LOEUF, pLI, and missense Z-scores.

Prioritize research genes by loss-of-function constraint

Compare LOEUF, pLI, and observed versus expected loss-of-function counts for a candidate gene list. Produce a ranked table with the transcript used for each comparison.

Compare missense and loss-of-function depletion

Place missense Z-scores beside LOEUF and pLI for genes such as SCN1A, SCN2A, and KCNQ2. Identify which type of variation drives each gene's constraint evidence.

Check transcript-dependent results

Compare available transcript scores for a gene before selecting a single row for a research report. Keep MANE Select and canonical transcript choices explicit.

Revisit an analysis built on older constraint data

Compare v2.1.1 and current constraint results for the same research genes. Show observed/expected ratios alongside Z-scores to expose changes influenced by sample size.

Annotate a research gene table

Add constraint counts, ratios, LOEUF, pLI, and Z-scores to a project's gene table. Preserve transcript identifiers so later comparisons use the same biological unit.

Audit changes after a constraint release

Compare stored constraint results with a new retrieval. Report changes to numeric scores separately from rank and bin changes, following the distinction in the v4.1.2 correction.

Questions about gnomAD gene constraint in ChatGPT

Can ChatGPT use gnomAD gene constraint?

Yes. Add Spiral to ChatGPT as an MCP server, and ChatGPT can find and run gnomAD gene constraint like any built-in tool.

How much does gnomAD gene constraint cost in ChatGPT?

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your ChatGPT plan is separate.

Do I need an Alexandria account to use gnomAD gene constraint in ChatGPT?

No. Spiral runs gnomAD gene constraint on its own Alexandria account. You sign in to Spiral once and never paste a key.

How long does it take to set up gnomAD gene constraint in ChatGPT?

About two minutes: add a custom MCP server, then click Connect, then sign in to Spiral and approve.

Does ChatGPT wait while gnomAD gene constraint runs?

gnomAD gene constraint runs in the background. ChatGPT starts the run, checks on it and gives you the json when it's ready.

What does gnomAD gene constraint measure?

It compares observed variation with the amount expected under a mutation model. The data include missense and synonymous Z-scores, plus LOEUF and pLI for loss-of-function constraint.

Does the loss-of-function count include frameshift variants?

No. Constraint counts use single nucleotide variants below 0.1% alternate allele frequency that pass quality control; the loss-of-function model excludes frameshift-producing insertions and deletions.

Which transcript represents a gene?

The gene display uses MANE Select for v4 on GRCh38 and canonical transcripts for v2 on GRCh37. Calculations also exist for other transcripts, so a gene symbol alone does not establish which transcript's score you are comparing.

What changed in the v4.1.2 constraint update?

v4.1.2 fixes ranks and bins that previously included transcripts with missing constraint values in their ranking denominator. LOEUF and the other constraint values remain unchanged from v4.1.1.

What LOEUF cutoff does gnomAD recommend?

For v4.1.1 constraint interpretation, gnomAD recommends LOEUF below 0.45 when a cutoff is necessary. v4.1.2 leaves those metric values unchanged.

Get started

Start using gnomAD gene constraint in ChatGPT

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into ChatGPT:

Set up ChatGPT

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options