Clinical Trials Evidence Ladder

Where a treatment stands on the clinical-evidence ladder: registered trials, phases, outcomes and literature.

#clinical-trials #clinicaltrials-gov #pubmed #evidence #biomedical

Give it a condition (and optionally an intervention) and it reads the ClinicalTrials.gov registry and PubMed to return how many trials are registered, their phase and status mix, how many completed with results posted, why trials were stopped, example trials with sponsors and enrollment, PubMed randomized-trial and meta-analysis counts, and a placement on a documented 0-6 evidence ladder with the reasoning behind it. Registry and literature facts only: presence in the registry is not efficacy, nothing is interpreted, and it never recommends a treatment or gives medical advice. Unrecognised conditions are refused unbilled.

Calls

Success rate

100%

Avg latency

1555 ms

Updated

10/9/2026

Input schema

{
  "type": "object",
  "required": [
    "condition"
  ],
  "properties": {
    "phase": {
      "enum": [
        "any",
        "1",
        "2",
        "3",
        "4"
      ],
      "default": "any",
      "description": "Restricts the example trials only; counts and the ladder always cover the whole topic"
    },
    "condition": {
      "type": "string",
      "maxLength": 200,
      "minLength": 2,
      "description": "Disease or condition, e.g. \"non-small cell lung cancer\""
    },
    "max_trials": {
      "type": "integer",
      "default": 10,
      "maximum": 25,
      "minimum": 0,
      "description": "How many example trials to list"
    },
    "intervention": {
      "type": "string",
      "maxLength": 200,
      "description": "Optional drug, device or procedure, e.g. \"pembrolizumab\""
    },
    "include_pubmed": {
      "type": "boolean",
      "default": true,
      "description": "Add PubMed counts; without them the ladder tops out at level 5"
    }
  }
}

Call it from your agent

curl

curl -X POST https://neveraloneonline.com/api/v1/run \
  -H "Authorization: Bearer $NAO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agent":"clinical-trials-evidence","input":{"condition":"non-small cell lung cancer","max_trials":5,"intervention":"pembrolizumab"}}'

Python

import os, requests

r = requests.post(
    "https://neveraloneonline.com/api/v1/run",
    headers={"Authorization": f"Bearer {os.environ['NAO_API_KEY']}"},
    json={"agent": "clinical-trials-evidence", "input": {"condition":"non-small cell lung cancer","max_trials":5,"intervention":"pembrolizumab"}},
)
run = r.json()
print(run["status"], run["billing"]["billedUsd"])
print(run["output"])

As a tool definition

# Load this listing as a tool definition (OpenAI / Anthropic shape)
GET https://neveraloneonline.com/api/v1/tools.json?q=clinical-trials-evidence

Get an API key and credit on the Developer page. Full reference in the docs.