[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [ClinVar genetic change search](https://spiral.ai/integrations/opencode/clinvar-genetic-change-search)

# How to Use ClinVar genetic change search in opencode

Find ClinVar records by gene, condition, or clinical classification and compare their aggregate review status. Use it to build a research shortlist before examining individual submissions.

|  |  |
| --- | --- |
| Model | ClinVar genetic change search |
| Available through | Alexandria |
| Category | Health |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with ClinVar genetic change search in opencode

- Use ClinVar genetic change search to find BRCA1 records with conflicting classifications. Write a research review table in the project with record identifiers, classifications, and review status.
- Use ClinVar genetic change search to find CFTR records reviewed by an expert panel. Create a reference table for the project's genetics examples.
- Use ClinVar genetic change search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from ClinVar genetic change search and tell me what changed since last week.
- Check ClinVar genetic change search and summarize what you find in three bullet points.

## How to set up ClinVar genetic change search in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run ClinVar genetic change search**: One request; the result comes back by polling or a webhook.

```bash
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": "clinvar-ncbi-nlm-nih-gov/variants/search",
    "input": {
      "gene": "<gene>"
    }
  }'
```

Then paste one of the prompts above: opencode finds ClinVar genetic change search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/opencode

## ClinVar genetic change search tools and prices

- [ClinVar · Search](https://spiral.ai/tools/alexandria/clinvar-ncbi-nlm-nih-gov/variants/search) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| gene |  | — | HGNC gene symbol, e.g. `BRCA1`. A symbol ClinVar does not know gives an empty page. |
| limit | 1 to 50 | 10 | Results per page. |
| query |  | — | A variant reference (`BRCA1 c.181T>G`, `NM_007294.4:c.181T>G`, `rs28897672`, `NC_000017.11:43106486:A:C`, `VCV000017661`, `RCV000019229`, `CA001182`) or free text with Entrez ClinVar fields and AND, OR, NOT (`BRCA2[gene] AND founder`). An HGVS name must match ClinVar's transcript version. |
| offset | 0 to 50000 | 0 | Zero-based index of the first result; pass `next_offset` for the next page. |
| condition |  | — | Disease or phenotype name (`hereditary breast ovarian cancer`), or an ID: MedGen CUI (`C2676676`), OMIM (`OMIM:604370`), MONDO (`MONDO:0011450`), Orphanet (`ORPHA:145`) or HPO (`HP:0003002`). |
| min_stars | 0 to 4 | — | Only variants whose aggregate review status earns at least this many stars (2 = multiple submitters without conflicts or better). |

## What can you do with ClinVar genetic change search in opencode?

Add ClinVar classifications and supporting submissions to a research annotation table in your project. Use the evidence to check public examples, compare interpretations, and identify records that need closer review.

### Prepare a BRCA1 evidence review

Find BRCA1 records with conflicting classifications, then examine the submitter interpretations and supporting evidence for selected records. Produce a research review queue with the disagreements spelled out.

### Build a CFTR reference set

Find CFTR records reviewed by an expert panel, then inspect their classifications and submissions. Assemble examples for a genetics training session with links to the supporting records.

### Monitor an LDLR research shortlist

Repeat the same LDLR search each week and compare the returned classifications with the previous run. Inspect the submissions behind changed records before adding them to a research digest.

### Organize condition-specific evidence

Find records reported for hypertrophic cardiomyopathy, then inspect selected genetic changes and their reported conditions. Keep the overall classification separate from evidence tied to a particular condition.

### Create an HBB evidence reading list

Find HBB records of interest and inspect the citations supplied with their classifications. Turn those references into a reading list organized by genetic change and submitter interpretation.

### Check public examples in genetics documentation

Find the ClinVar records used in BRCA1 and CFTR teaching examples, then inspect their classifications and supporting submissions. Flag documentation that no longer agrees with the retrieved records.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All opencode guides](https://spiral.ai/integrations/opencode)

## ClinVar genetic change search in other agents

- [Amp](https://spiral.ai/integrations/amp/clinvar-genetic-change-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/clinvar-genetic-change-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/clinvar-genetic-change-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/clinvar-genetic-change-search)
- [Cline](https://spiral.ai/integrations/cline/clinvar-genetic-change-search)
- [Codex](https://spiral.ai/integrations/codex/clinvar-genetic-change-search)
- [Cursor](https://spiral.ai/integrations/cursor/clinvar-genetic-change-search)
- [Devin](https://spiral.ai/integrations/devin/clinvar-genetic-change-search)
- [dots](https://spiral.ai/integrations/dots/clinvar-genetic-change-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/clinvar-genetic-change-search)
- [Gemini](https://spiral.ai/integrations/gemini/clinvar-genetic-change-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/clinvar-genetic-change-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/clinvar-genetic-change-search)
- [goose](https://spiral.ai/integrations/goose/clinvar-genetic-change-search)
- [Grok](https://spiral.ai/integrations/grok/clinvar-genetic-change-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/clinvar-genetic-change-search)
- [Hermes](https://spiral.ai/integrations/hermes/clinvar-genetic-change-search)
- [Instinct](https://spiral.ai/integrations/instinct/clinvar-genetic-change-search)
- [Manus](https://spiral.ai/integrations/manus/clinvar-genetic-change-search)
- [Muse](https://spiral.ai/integrations/muse/clinvar-genetic-change-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/clinvar-genetic-change-search)
- [n8n](https://spiral.ai/integrations/n8n/clinvar-genetic-change-search)
- [Notion](https://spiral.ai/integrations/notion/clinvar-genetic-change-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/clinvar-genetic-change-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/clinvar-genetic-change-search)
- [Raycast](https://spiral.ai/integrations/raycast/clinvar-genetic-change-search)
- [VS Code](https://spiral.ai/integrations/vscode/clinvar-genetic-change-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/clinvar-genetic-change-search)
- [Zapier](https://spiral.ai/integrations/zapier/clinvar-genetic-change-search)

## More opencode guides

- [ClinVar genetic change details](https://spiral.ai/integrations/opencode/clinvar-genetic-change-details)
- [ClinicalTrials.gov field statistics](https://spiral.ai/integrations/opencode/clinicaltrials-gov-field-statistics)
- [ChEMBL target search](https://spiral.ai/integrations/opencode/chembl-target-search)
- [ClinicalTrials.gov search suggestions](https://spiral.ai/integrations/opencode/clinicaltrials-gov-search-suggestions)
- [ChEMBL target details](https://spiral.ai/integrations/opencode/chembl-target-details)
- [ClinicalTrials.gov study dates](https://spiral.ai/integrations/opencode/clinicaltrials-gov-study-dates)

## Questions about ClinVar genetic change search in opencode

**Can opencode use ClinVar genetic change search?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run ClinVar genetic change search like any built-in tool.

**How much does ClinVar genetic change search cost in opencode?**

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

**Do I need an Alexandria account to use ClinVar genetic change search in opencode?**

No. Spiral runs ClinVar genetic change search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up ClinVar genetic change search in opencode?**

About two minutes: add the server, then sign in, then check it.

**Does opencode wait while ClinVar genetic change search runs?**

ClinVar genetic change search runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**Does ClinVar contain every clinically relevant genetic change?**

No. ClinVar depends on voluntary submissions, so its coverage is incomplete even within its scope of human inherited diseases, cancer, and drug responses.

**How often does ClinVar update?**

ClinVar updates weekly on Mondays. That schedule does not mean every classification is reevaluated weekly: individual updates remain at the submitter's discretion.

**Does NIH independently verify each classification?**

No. NIH explicitly says it does not independently verify submitted information, so a ClinVar classification represents submitted evidence and interpretation rather than an independent NIH finding.

**Why can one genetic change have several condition records?**

ClinVar separates the overall genetic change record, identified by VCV, from change-and-condition records, identified by RCV. Different reported conditions can therefore produce several RCV records for one change.

**Can I download every past weekly release?**

ClinVar's XML downloads update weekly, but only the release on the first Thursday of each month is archived. The historical download archive therefore does not preserve every weekly snapshot.

