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

# How to Use ClinVar genetic change details in opencode

Fetch the clinical classification for one genetic change, with submitter interpretations, review status, criteria, and citations. Use it to inspect the evidence behind a known ClinVar record.

|  |  |
| --- | --- |
| Model | ClinVar genetic change details |
| 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 details in opencode

- Use ClinVar genetic change details for NM_007294.4:c.181T>G. Add a project note that separates the aggregate classification from each returned submitter's interpretation and citations.
- Use ClinVar genetic change details for NM_000492.4:c.1521_1523del. Compare the returned classification and evidence with the CFTR example in the project's documentation.
- Use ClinVar genetic change details for NM_000518.5:c.20A>T. Save the returned submitter interpretations and citations as a research fixture, keeping them separate from the aggregate classification.
- Use ClinVar genetic change details 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 details and tell me what changed since last week.

## How to set up ClinVar genetic change details 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 details**: 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/get",
    "input": {
      "variant": "<variant>"
    }
  }'
```

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

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

## ClinVar genetic change details tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| submissions_limit | 0 to 200 | 25 | Submissions to list; `submissions_total` counts all. |

## What can you do with ClinVar genetic change details 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 details in other agents

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

## More opencode guides

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

## Questions about ClinVar genetic change details in opencode

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

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

**How much does ClinVar genetic change details 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 details in opencode?**

No. Spiral runs ClinVar genetic change details 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 details in opencode?**

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

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

ClinVar genetic change details 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.

