[Integrations](https://spiral.ai/integrations) › [Devin](https://spiral.ai/integrations/devin) › [HGNC gene search](https://spiral.ai/integrations/devin/hgnc-gene-search)

# How to Use HGNC gene search in Devin

Find candidate human genes by name keywords, symbol prefixes, or chromosomal bands. Use it to build a shortlist when you can describe the genes but do not know their exact symbols.

|  |  |
| --- | --- |
| Model | HGNC gene 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 HGNC gene search in Devin

- Use HGNC gene search to find human genes with symbols beginning with ZNF and write the returned symbols and HGNC IDs to a project data file.
- Use HGNC gene search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from HGNC gene search and tell me what changed since last week.
- Check HGNC gene search and summarize what you find in three bullet points.
- Pull the newest data from HGNC gene search and give me the result as a table.

## How to set up HGNC gene search in Devin

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

### Use Spiral's MCP server

1. **Add a custom MCP**: Open Customize › MCPs. Click + and choose New MCP. Fill in:

2. **Sign in to Spiral and approve**: In Customize › MCPs, open Spiral and choose Connect. Spiral opens: sign in, pick the organization and click Authorize. No API key.

3. **Check it**: On Spiral's configuration page, click Test tools. Devin lists Spiral's tools.

### Use the Spiral skill

1. **Send Devin 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 HGNC gene 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": "genenames-org/genes/search",
    "input": {
      "query": "<query>"
    }
  }'
```

Then paste one of the prompts above: Devin finds HGNC gene search on Spiral, shows the price and runs it.

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

## HGNC gene search tools and prices

- [HGNC (HUGO Gene Nomenclature Committee) · Search](https://spiral.ai/tools/alexandria/genenames-org/genes/search) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 50 | 10 | Results per page. |
| offset | 0 to 100000 | 0 | Zero-based index of the first result. |
| status | approved, withdrawn, any | approved | `approved` (default), `withdrawn` entries only, or `any`. |
| locus_group | protein-coding gene, non-coding RNA, pseudogene, other | — | Only genes in this locus group. |

## What can you do with HGNC gene search in Devin?

Build a human gene annotation table with approved symbols and stable HGNC IDs. A coding agent can apply HGNC nomenclature to project data before joining research tables.

### Reconcile gene names across papers

Find genes mentioned by descriptive names, inspect their nomenclature, and normalize extracted symbol lists before comparing studies.

### Prepare gene annotations for a research portal

Find relevant human genes, standardize imported labels, and attach approved names and stable HGNC IDs to portal entries.

### Review a public assay gene list

Discover genes by a shared name or symbol prefix, compare them with a published assay list, and inspect individual records before revising the list.

### Build a gene reference for a literature review

Collect candidate genes by keyword, reconcile symbols copied from publications, and assemble a reference table of approved names and IDs.

### Explore genes in a chromosomal band

Find genes assigned to a cytogenetic band and inspect their locus types and nomenclature. Account for HGNC records that lack band-level locations.

### Create a gene nomenclature teaching table

Find examples by a symbol prefix and show how approved symbols, aliases, previous symbols, and stable HGNC IDs relate.

## Overview

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

## HGNC gene search in other agents

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

## More Devin guides

- [HGNC gene list normalization](https://spiral.ai/integrations/devin/hgnc-gene-list-normalization)
- [Health Canada drug product details](https://spiral.ai/integrations/devin/health-canada-drug-product-details)
- [HGNC gene details](https://spiral.ai/integrations/devin/hgnc-gene-details)
- [Health Canada drug search](https://spiral.ai/integrations/devin/health-canada-drug-search)
- [GTEx gene expression by tissue](https://spiral.ai/integrations/devin/gtex-gene-expression-by-tissue)
- [Human Protein Atlas antibody data](https://spiral.ai/integrations/devin/human-protein-atlas-antibody-data)

## Questions about HGNC gene search in Devin

**Can Devin use HGNC gene search?**

Yes. Add Spiral to Devin as an MCP server, and Devin can find and run HGNC gene search like any built-in tool.

**How much does HGNC gene search cost in Devin?**

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

**Do I need an Alexandria account to use HGNC gene search in Devin?**

No. Spiral runs HGNC gene 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 HGNC gene search in Devin?**

About two minutes: add a custom MCP, then sign in to Spiral and approve, then check it.

**Does Devin wait while HGNC gene search runs?**

HGNC gene search runs in the background. Devin starts the run, checks on it and gives you the json when it's ready.

**Does HGNC cover genes from every species?**

HGNC assigns nomenclature to human genes, including protein-coding genes, noncoding RNA genes, and pseudogenes. Its human records can link to other species, but those links do not make it a complete gene catalog for those species.

**Does HGNC provide exact genomic coordinates?**

HGNC provides cytogenetic locations, such as chromosomal bands, rather than genomic start and stop coordinates. Some records identify only the chromosome, so band-based searches can miss genes without a recorded band.

**What information does an HGNC search return?**

HGNC's source REST search returns HGNC IDs, symbols, and relevance scores. Fetching a gene record provides the fuller nomenclature and database cross-references.

**Can older gene names still be matched?**

HGNC records previous symbols and aliases alongside approved nomenclature. Its own multi-symbol checker searches approved, previous, withdrawn, and alias symbols.

**Can HGNC data be reused in research tools?**

HGNC imposes no restrictions on access to or use of its data. It requests acknowledgment of HGNC and a link to its website where possible.

