[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [Open Targets disease search](https://spiral.ai/integrations/claude-code/open-targets-disease-search)

# How to Use Open Targets disease search in Claude Code

Open Targets disease search returns disease and phenotype identifiers with synonyms and vocabulary mappings. Use it to choose a disease term before looking up target associations, supporting evidence, or known drugs.

|  |  |
| --- | --- |
| Model | Open Targets disease 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 Open Targets disease search in Claude Code

- Use Open Targets disease search to find asthma and rheumatoid arthritis, then add their returned names and identifiers to a proposed mapping table for the disease labels in this project's CSV.
- Use Open Targets disease search to retrieve synonyms for systemic lupus erythematosus and prepare alias entries for this project's disease search feature.
- Use Open Targets disease search to find cystic fibrosis and write its returned vocabulary mappings to a JSON fixture in this project.
- Use Open Targets disease search to compare Crohn's disease and ulcerative colitis, then flag any project rows that currently assign both labels to the same identifier.
- Use Open Targets disease search to retrieve the current identifiers and vocabulary mappings for type 2 diabetes, then compare them with this project's saved disease mapping file.

## How to set up Open Targets disease search in Claude Code

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

### Use Spiral's MCP server

1. **Add the hosted server**: This adds Spiral to the current project. Add `--scope user` to use it in every project.

```bash
claude mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `claude`, type `/mcp`, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

### Use the Spiral skill

1. **Send Claude Code 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 Open Targets disease 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": "platform-opentargets-org/diseases/search_diseases",
    "input": {
      "query": "<query>"
    }
  }'
```

Then paste one of the prompts above: Claude Code finds Open Targets disease search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/claude-code

## Open Targets disease search tools and prices

- [Open Targets Platform · Search diseases](https://spiral.ai/tools/alexandria/platform-opentargets-org/diseases/search_diseases) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 50 | 10 | Rows per page, 1 to 50. |
| cursor |  | — | `next_cursor` from the previous page. Repeat the same inputs and `limit` with it. Pattern: ^[0-9]+$. |

## What can you do with Open Targets disease search in Claude Code?

Add Open Targets disease identifiers and vocabulary mappings to a project's research tables. A coding agent can compare labels and synonyms against existing files and prepare proposed matches for review.

### Standardize disease names in a research list

Match labels such as Crohn's disease and ulcerative colitis to Open Targets identifiers before combining results from separate analyses.

### Build a disease vocabulary crosswalk

Collect the returned vocabulary mappings for conditions such as cystic fibrosis and Huntington disease to connect records across disease databases.

### Expand literature search terms

Use returned synonyms for amyotrophic lateral sclerosis or systemic lupus erythematosus to prepare a terminology list for a separate literature search.

### Review broad and specific disease labels

Compare the returned names and identifiers for melanoma and cutaneous melanoma before selecting the condition for an evidence review.

### Maintain disease mappings across updates

Compare saved identifiers, labels, synonyms, and vocabulary mappings with newly retrieved records each quarter to identify terminology changes.

### Prepare disease IDs for target research

Resolve asthma, rheumatoid arthritis, or type 2 diabetes to the intended disease terms before requesting associations, supporting evidence, or known drugs.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Claude Code guides](https://spiral.ai/integrations/claude-code)

## Open Targets disease search in other agents

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

## More Claude Code guides

- [NIH RePORTER grant search](https://spiral.ai/integrations/claude-code/nih-reporter-grant-search)
- [Open Targets drugs](https://spiral.ai/integrations/claude-code/open-targets-drugs)
- [NIH RePORTER grant publications](https://spiral.ai/integrations/claude-code/nih-reporter-grant-publications)
- [Open Targets target profile](https://spiral.ai/integrations/claude-code/open-targets-target-profile)
- [NIH RePORTER grant details](https://spiral.ai/integrations/claude-code/nih-reporter-grant-details)
- [Open Targets target-disease associations](https://spiral.ai/integrations/claude-code/open-targets-target-disease-associations)

## Questions about Open Targets disease search in Claude Code

**Can Claude Code use Open Targets disease search?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Open Targets disease search like any built-in tool.

**How much does Open Targets disease search cost in Claude Code?**

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

**Do I need an Alexandria account to use Open Targets disease search in Claude Code?**

No. Spiral runs Open Targets disease 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 Open Targets disease search in Claude Code?**

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

**Does Claude Code wait while Open Targets disease search runs?**

Open Targets disease search runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.

**Does Open Targets cover only diseases?**

Its disease or phenotype category also includes biological processes and measurements related to human targets. A measurement term can therefore be a valid result alongside a named disease.

**Which disease vocabularies does Open Targets cover?**

The provider documents disease and phenotype coverage across EFO, MONDO, HP, and Orphanet, with synonyms and vocabulary mappings. Use the returned mappings to connect terminology across those sources.

**How often does Open Targets refresh its data?**

Open Targets Platform publishes quarterly data updates. Plan terminology reviews around that cadence.

**Does Open Targets reproduce the complete EFO hierarchy?**

Open Targets modifies EFO for clinical interpretation. It removes some high-level categories, including disease by anatomical region, and rearranges others.

**Why might a disease now have a MONDO identifier?**

The Platform's 26.06 update incorporated EFO 3.88.0, which replaced many EFO disease terms with Mondo terms. When reviewing an older disease list, compare the current labels and mappings before retaining an EFO identifier.

