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 by free text. The official XML API has no pagination an…

ISRCTN_search_trials tool specification

Tool Information:

  • Name: ISRCTN_search_trials

  • Type: ISRCTNSearchTool

  • Description: Search the ISRCTN clinical trial registry by free text. The official XML API has no pagination and returns at most 100 matches; metadata explicitly reports truncation, unreachable_results, and whether increasing limit can retrieve more. No API key required.

Parameters:

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

  • limit (integer) (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 ISRCTN search using its boolean query DSL. The official XML API has no pagination an…

ISRCTN_search_trials_fielded tool specification

Tool Information:

  • Name: ISRCTN_search_trials_fielded

  • Type: ISRCTNSearchTool

  • Description: Field-scoped ISRCTN search using its boolean query DSL. The official XML API has no pagination and returns at most 100 matches; metadata explicitly reports truncation, unreachable_results, and whether increasing limit can retrieve more.

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) (optional) Max trials to return (default 10, max 100).

Example Usage:

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