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

# How to Use Open Targets disease search in opencode

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 opencode

- 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 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 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: opencode finds Open Targets disease search on Spiral, shows the price and runs it.

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

## 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 opencode?

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 opencode guides](https://spiral.ai/integrations/opencode)

## 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)
- [Claude Code](https://spiral.ai/integrations/claude-code/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)
- [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 opencode guides

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

## Questions about Open Targets disease search in opencode

**Can opencode use Open Targets disease search?**

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

**How much does Open Targets disease 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 Open Targets disease search in opencode?**

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 opencode?**

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

**Does opencode wait while Open Targets disease search runs?**

Open Targets disease search runs in the background. opencode 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.

