Spiral gives your agent every tool with one account. Browse the tools →

Codex · Health

How to Use Open Targets disease search in Codex

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.

Prompts to try with Open Targets disease search in Codex

Copy an example into Codex, or ask in your own words.

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.

Open Targets disease searchCodex
Try asking
  • 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 Codex

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

Use Spiral's MCP server

  1. Add the hosted server
    codex mcp add spiral --url https://api.spiral.ai/mcp
  2. Sign in

    Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.

    codex mcp login spiral

Use the Spiral skill

  1. Send Codex 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.

    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.

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

Open Targets disease search providers and prices

Spiral runs Open Targets disease search through Alexandria. Open a card for today's price, with every fee included.

AlexandriaHealth
Open Targets Platform · Search diseases
platform-opentargets-org/diseases/search_diseases

Settings you can ask for

Ask Codex for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Limit1 to 5010

Rows per page, 1 to 50.

Every API field of Open Targets Platform · Search diseases is on its tool page: open its card above.

What can you do with Open Targets disease search in Codex?

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.

Questions about Open Targets disease search in Codex

Can Codex use Open Targets disease search?

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

How much does Open Targets disease search cost in Codex?

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

Do I need an Alexandria account to use Open Targets disease search in Codex?

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 Codex?

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

Does Codex wait while Open Targets disease search runs?

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

Get started

Start using Open Targets disease search in Codex

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Codex:

Set up Codex

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options