Isrctn Tools

Configuration File: isrctn_tools.json Tool Type: Local Tools Count: 3

This page contains all tools defined in the isrctn_tools.json configuration file.

Available Tools

ISRCTN_get_trial (Type: ISRCTNGetTrialTool)

Retrieve a single ISRCTN clinical trial by its ISRCTN id (e.g. ‘ISRCTN12336055’). Returns the ful…

ISRCTN_get_trial tool specification

Tool Information:

  • Name: ISRCTN_get_trial

  • Type: ISRCTNGetTrialTool

  • Description: Retrieve a single ISRCTN clinical trial by its ISRCTN id (e.g. ‘ISRCTN12336055’). Returns the full record: title, scientific title, acronym, study hypothesis, plain-English summary, primary and secondary study design, phase, conditions, interventions, primary and secondary outcomes, inclusion/exclusion eligibility (gender, age range, healthy volunteers), sponsors, funders, contacts, recruitment countries, recruitment start/end dates, drug names, target and final enrolment, IPD-sharing statement, end date, and cross-reference ids (DOI, EudraCT, ClinicalTrials.gov). No API key required.

Parameters:

  • isrctn_id (string) (required) ISRCTN id, e.g. ‘ISRCTN12336055’ (the ‘ISRCTN’ prefix is optional).

Example Usage:

query = {
    "name": "ISRCTN_get_trial",
    "arguments": {
        "isrctn_id": "example_value"
    }
}
result = tu.run(query)

ISRCTN_search_trials (Type: ISRCTNSearchTool)

Search the ISRCTN clinical trial registry — a WHO-primary registry (UK-based, international scope…

ISRCTN_search_trials tool specification

Tool Information:

  • Name: ISRCTN_search_trials

  • Type: ISRCTNSearchTool

  • Description: Search the ISRCTN clinical trial registry — a WHO-primary registry (UK-based, international scope) — by free text. Returns matching trials with ISRCTN id, title, scientific title, acronym, study hypothesis, primary study design, end date, and cross-reference ids (DOI, EudraCT, ClinicalTrials.gov). A third trial source alongside ClinicalTrials.gov and EU CTIS. No API key required.

Parameters:

  • query (string) (required) Free-text search, e.g. ‘cystic fibrosis’, ‘diabetes prevention’.

  • limit ([‘integer’, ‘null’]) (optional) Max trials to return (default 10, max 100).

Example Usage:

query = {
    "name": "ISRCTN_search_trials",
    "arguments": {
        "query": "example_value"
    }
}
result = tu.run(query)

ISRCTN_search_trials_fielded (Type: ISRCTNSearchTool)

Field-scoped (fielded) search of the ISRCTN clinical trial registry using its boolean query DSL. …

ISRCTN_search_trials_fielded tool specification

Tool Information:

  • Name: ISRCTN_search_trials_fielded

  • Type: ISRCTNSearchTool

  • Description: Field-scoped (fielded) search of the ISRCTN clinical trial registry using its boolean query DSL. Unlike the free-text ISRCTN_search_trials, this lets you scope a query to specific registry fields so results are precise. Pass a raw ‘q’ DSL string such as ‘condition:diabetes’, ‘phase:”Phase III”’, or combine fields with AND/OR: ‘gender:Female AND condition:asthma’. Alternatively pass field helpers (condition, phase, gender, intervention, sponsor, funder, country, drug_name) which are joined with AND. Returns detailed trial records (interventions, primary/secondary outcomes, inclusion/exclusion eligibility, sponsors, funders, recruitment countries and dates, drug names, enrolment, IPD-sharing, plain-English summary). No API key required.

Parameters:

  • q ([‘string’, ‘null’]) (optional) Raw ISRCTN field-scoped boolean query, used verbatim. Examples: ‘condition:diabetes’, ‘phase:”Phase III”’, ‘gender:Female AND condition:asthma’.

  • query ([‘string’, ‘null’]) (optional) Alias for ‘q’; a full field-scoped DSL string.

  • condition ([‘string’, ‘null’]) (optional) Condition field helper (compiled to condition:VALUE), e.g. ‘diabetes’.

  • phase ([‘string’, ‘null’]) (optional) Phase field helper (compiled to phase:VALUE), e.g. ‘Phase III’.

  • gender ([‘string’, ‘null’]) (optional) Gender field helper (compiled to gender:VALUE), e.g. ‘Female’.

  • intervention ([‘string’, ‘null’]) (optional) Intervention field helper (compiled to intervention:VALUE).

  • sponsor ([‘string’, ‘null’]) (optional) Sponsor field helper (compiled to sponsor:VALUE).

  • funder ([‘string’, ‘null’]) (optional) Funder field helper (compiled to funder:VALUE).

  • country ([‘string’, ‘null’]) (optional) Recruitment country field helper (compiled to recruitmentCountry:VALUE).

  • drug_name ([‘string’, ‘null’]) (optional) Drug name field helper (compiled to drugName:VALUE).

  • limit ([‘integer’, ‘null’]) (optional) Max trials to return (default 10, max 100).

Example Usage:

query = {
    "name": "ISRCTN_search_trials_fielded",
    "arguments": {
    }
}
result = tu.run(query)