[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Orphanet rare disease genes](https://spiral.ai/integrations/opencode/orphanet-rare-disease-genes)

# How to Use Orphanet rare disease genes in opencode

Returns genes associated with a rare disease, their association types, and identifiers for databases such as HGNC, Ensembl, and UniProt. Use it to connect a disease research brief to gene and protein records.

|  |  |
| --- | --- |
| Model | Orphanet rare disease genes |
| 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 Orphanet rare disease genes in opencode

- Use Orphanet rare disease genes for Marfan syndrome and add a gene association view to this project with association types and the returned genetic database identifiers.
- Use Orphanet rare disease genes to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Orphanet rare disease genes and tell me what changed since last week.
- Check Orphanet rare disease genes and summarize what you find in three bullet points.
- Pull the newest data from Orphanet rare disease genes and give me the result as a table.

## How to set up Orphanet rare disease genes 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 Orphanet rare disease genes**: 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": "orphadata-com/rare-diseases/genes",
    "input": {
      "disease": "<disease>"
    }
  }'
```

Then paste one of the prompts above: opencode finds Orphanet rare disease genes on Spiral, shows the price and runs it.

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

## Orphanet rare disease genes tools and prices

- [Orphanet (Orphadata): rare disease prevalence, codes and genes · Genes](https://spiral.ai/tools/alexandria/orphadata-com/rare-diseases/genes) (Alexandria): $0.00873 per call.

## What can you do with Orphanet rare disease genes in opencode?

Build a rare disease reference feature that connects Orphanet identities, epidemiology records, and gene associations. Use the returned terminology and genetic database identifiers to connect those records to the project's existing research tables.

### Prepare a disease research brief

Build a Pompe disease brief with the preferred name and codes, published frequency estimates, and associated genes. Give reviewers a terminology table, an epidemiology table, and links through the returned gene identifiers.

### Compare research indications

Compare Fabry disease, Pompe disease, and Gaucher disease using their resolved disease identities, available prevalence records, and gene associations. Keep different population estimates and association types visible in the comparison.

### Enrich a research knowledge base

Add Orphanet identities, terminology references, epidemiology records, and gene links to a rare disease knowledge base. Use the disease codes to connect the sections of each research entry.

### Draft grant background tables

Prepare background tables for a rare disease research proposal: accepted terminology, published disease frequency, and associated genes. Include the returned epidemiology references so the proposal writer can inspect the underlying publications.

### Review a disease education page

Check a public education page about cystic fibrosis against Orphanet's disease name, definition, terminology mappings, frequency records, and gene associations. Produce an editorial checklist of statements that need revision or source review.

### Review changes after a data release

Compare newly retrieved disease identities, epidemiology records, and gene associations with a previous research snapshot. Prepare a review queue for changed terminology, frequency estimates, and gene links after the July and December releases.

## Overview

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

## Orphanet rare disease genes in other agents

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

## More opencode guides

- [Orphanet rare disease epidemiology](https://spiral.ai/integrations/opencode/orphanet-rare-disease-epidemiology)
- [Orphanet rare disease search](https://spiral.ai/integrations/opencode/orphanet-rare-disease-search)
- [Open Targets target-disease evidence](https://spiral.ai/integrations/opencode/open-targets-target-disease-evidence)
- [PMC article full text](https://spiral.ai/integrations/opencode/pmc-article-full-text)
- [Open Targets target-disease associations](https://spiral.ai/integrations/opencode/open-targets-target-disease-associations)
- [PubChem compound bioassays](https://spiral.ai/integrations/opencode/pubchem-compound-bioassays)

## Questions about Orphanet rare disease genes in opencode

**Can opencode use Orphanet rare disease genes?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Orphanet rare disease genes like any built-in tool.

**How much does Orphanet rare disease genes 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 Orphanet rare disease genes in opencode?**

No. Spiral runs Orphanet rare disease genes on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Orphanet rare disease genes in opencode?**

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

**Does opencode wait while Orphanet rare disease genes runs?**

Orphanet rare disease genes runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**What counts as a rare disease in Orphanet?**

Orphanet's nomenclature uses the European threshold of fewer than five affected people per 10,000. Rarity in another country alone does not establish that a condition meets this definition.

**How often does Orphadata update?**

The current Orphadata API documentation specifies two updates each year, in July and December.

**Does an ORPHAcode always identify one disease?**

An ORPHAcode identifies a clinical entity, which can be a disorder, a group of disorders, or a subtype. Check that level before comparing records under similar names.

**Are Orphanet's terminology mappings exact matches?**

Orphanet distinguishes exact mappings from mappings between broader and narrower concepts. A mapped ICD or OMIM reference should therefore be read with its relationship qualification.

**Where can I find older Orphadata releases?**

Orphadata directs users to its GitHub archive for dataset versions since April 2020. Earlier versions are available on request; this is a source archive rather than a promise of historical queries through these endpoints.

