[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [ISRCTN clinical trial search](https://spiral.ai/integrations/opencode/isrctn-clinical-trial-search)

# How to Use ISRCTN clinical trial search in opencode

Find ISRCTN studies with their titles, study status, and recruitment status. Use it to build a shortlist for a research question before retrieving individual study records.

|  |  |
| --- | --- |
| Model | ISRCTN clinical trial 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 ISRCTN clinical trial search in opencode

- Use ISRCTN clinical trial search to find asthma studies recruiting in the United Kingdom and add their identifiers, titles, and recruitment statuses to our research table.
- Use ISRCTN clinical trial search for cancer OR neoplasm and create a screening CSV of the returned study identifiers and titles.
- Use ISRCTN clinical trial search to find studies sponsored by the University of Oxford and populate our portfolio table with their identifiers, titles, and study statuses.
- Use ISRCTN clinical trial search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from ISRCTN clinical trial search and tell me what changed since last week.

## How to set up ISRCTN clinical trial 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 ISRCTN clinical trial 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": "isrctn-com/clinical-trials/search",
    "input": {
      "term": "<term>"
    }
  }'
```

Then paste one of the prompts above: opencode finds ISRCTN clinical trial search on Spiral, shows the price and runs it.

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

## ISRCTN clinical trial search tools and prices

- [ISRCTN · Search](https://spiral.ai/tools/alexandria/isrctn-com/clinical-trials/search) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| term |  | — | Free text searched across the whole record, with AND, OR, NOT, quoted phrases and parentheses, e.g. "tranexamic acid" AND trauma. Field constraints from the ISRCTN API also work (condition:asthma). Unbalanced quotes or parentheses are refused: the registry would silently match nothing. |
| phase |  | — | Any of these phases; combined phases match both (PHASE2 matches Phase I/II, Phase II and Phase II/III). |
| title |  | — | Words in the public or scientific title, or the acronym, matched as a phrase, e.g. "RECOVERY". |
| funder |  | — | Funder name, matched as a phrase, e.g. "Wellcome Trust". |
| status |  | — | Keep studies whose overall or recruitment status is any of these, computed as ISRCTN computes them (see overall_status and recruitment_status). The registry does not index computed statuses, so each page is filtered after fetching: total_count is null and a page can come back short with a next_page_token. |
| country |  | — | Recruitment country as the registry names it ("United Kingdom", "United States of America", "Korea, South"); UK, US, USA and common aliases work. "United Kingdom" also matches studies that list only England, Scotland, Wales or Northern Ireland. |

## What can you do with ISRCTN clinical trial search in opencode?

Build a research screening table from ISRCTN study records in your project. Use registered study designs, eligibility criteria, and outcome measures to give reviewers a consistent comparison.

### Build a systematic review screening list

Find studies about asthma, then examine their registered populations, interventions, and eligibility criteria to prepare a screening table.

### Review a sponsor's research portfolio

Find studies sponsored by the University of Oxford and inspect their designs, recruitment dates, and funders for an institutional research brief.

### Compare registered outcome measures

Find knee osteoarthritis studies and compare their primary outcomes, measurement methods, and assessment timepoints before drafting a protocol.

### Map study locations

Find diabetes studies recruiting in the United Kingdom, then inspect their participating institutions and sites to describe the research footprint.

### Audit data-sharing plans

Find dementia studies associated with a funder and examine their stated participant-data sharing plans for a research transparency review.

### Prepare a trial background brief

Locate studies involving tranexamic acid and trauma, then summarize their registered aims, eligibility, interventions, and outcomes for a research meeting.

## Overview

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

## ISRCTN clinical trial search in other agents

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

## More opencode guides

- [IHME GBD release details](https://spiral.ai/integrations/opencode/ihme-gbd-release-details)
- [ISRCTN study details](https://spiral.ai/integrations/opencode/isrctn-study-details)
- [IHME GBD hierarchy children](https://spiral.ai/integrations/opencode/ihme-gbd-hierarchy-children)
- [Medicaid NADAC drug cost history](https://spiral.ai/integrations/opencode/medicaid-nadac-drug-cost-history)
- [IHME GBD entity details](https://spiral.ai/integrations/opencode/ihme-gbd-entity-details)
- [Medicaid NADAC drug search](https://spiral.ai/integrations/opencode/medicaid-nadac-drug-search)

## Questions about ISRCTN clinical trial search in opencode

**Can opencode use ISRCTN clinical trial search?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run ISRCTN clinical trial search like any built-in tool.

**How much does ISRCTN clinical trial 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 ISRCTN clinical trial search in opencode?**

No. Spiral runs ISRCTN clinical trial 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 ISRCTN clinical trial search in opencode?**

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

**Does opencode wait while ISRCTN clinical trial search runs?**

ISRCTN clinical trial search runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**Does ISRCTN cover only randomized trials?**

No. ISRCTN covers both observational and interventional studies that assess health interventions in human populations.

**How quickly are study records updated?**

ISRCTN updates records on request and says an update can usually be performed within two working days, depending on its size.

**Are older study records complete?**

Some older ISRCTN records do not meet current registration requirements for completeness. Historical records can therefore have less information than newer registrations.

**Can a published study disappear from ISRCTN?**

Published studies remain permanently on the register and cannot be deleted. ISRCTN preserves earlier information and adds updates with date stamps.

**Does ISRCTN search recognize medical synonyms?**

ISRCTN has no synonym system. A search for cancer does not automatically find records that use neoplasm, so include alternate medical terms when building a shortlist.

