ct_recent_updates

Pack: clinicaltrials · Endpoint: https://gateway.pipeworx.io/clinicaltrials/mcp

Track recent ClinicalTrials.gov activity by a specific event class within a verifiable date window. Three DISTINCT recency events, chosen via date_type: “last_update” (any edit to a study, ~5k/week — the default), “first_posted” (a study newly REGISTERED, ~1.3k/week), or “results_posted” (RESULTS first posted, ~140/week). Pass since (and optional until, YYYY-MM-DD) to bound a window — e.g. the last 7 days — and the returned total_count is the exact number of studies in that window so you can verify a weekly count from the output. Every study returns all THREE dates separately (first_posted_date, last_update_post_date, results_first_post_date) plus the design fields a screen needs (study_type, primary_purpose, phase, status, enrollment, conditions, interventions, sponsor). Sorted by the chosen event date, newest first. Use for “new trials registered this week”, “trials that posted results in the last month”, “recently updated diabetes studies”.

Parameters

NameTypeRequiredDescription
date_typestringnoWhich recency event to track/sort/window by: “last_update” (any edit, default), “first_posted” (new registration), “results_posted” (results first posted). These are different event classes with very different volumes — pick deliberately.
sincestringnoWindow start (inclusive), YYYY-MM-DD. e.g. for a weekly review pass 7 days ago. Applies to the chosen date_type.
untilstringnoOptional window end (inclusive), YYYY-MM-DD. Omit for open-ended (up to today).
statusstringnoOptional overall-status filter (validated; e.g. RECRUITING, or a comma-union like “RECRUITING,COMPLETED”).
querystringnoOptional search term (condition/drug/keyword) to narrow results.
limitnumbernoNumber of results per page (1-100, default 20). total_count reports the full window size regardless of limit.

Example call

Arguments

{
  "query": "oncology",
  "limit": 20
}

curl

curl -X POST https://gateway.pipeworx.io/clinicaltrials/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ct_recent_updates","arguments":{"query":"oncology","limit":20}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('ct_recent_updates', {
  "query": "oncology",
  "limit": 20
});

More examples

{
  "limit": 30
}

Response shape

Always returns: total_count, studies

FieldTypeDescription
total_countnumberTotal recently updated trials
studiesarrayList of formatted trial summaries
Full JSON Schema
{
  "type": "object",
  "properties": {
    "total_count": {
      "type": "number",
      "description": "Total recently updated trials"
    },
    "studies": {
      "type": "array",
      "description": "List of formatted trial summaries",
      "items": {
        "type": "object",
        "properties": {
          "nct_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "NCT identifier"
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Brief trial title"
          },
          "official_title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Official trial title"
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Overall trial status"
          },
          "phase": {
            "type": [
              "string",
              "null"
            ],
            "description": "Trial phase(s) comma-separated"
          },
          "enrollment": {
            "type": [
              "number",
              "null"
            ],
            "description": "Target enrollment count"
          },
          "enrollment_type": {
            "type": [
              "string",
              "null"
            ],
            "description": "Enrollment type"
          },
          "conditions": {
            "type": "array",
            "description": "List of trial conditions",
            "items": {
              "type": "string"
            }
          },
          "interventions": {
            "type": "array",
            "description": "List of interventions",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Intervention type"
                },
                "name": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Intervention name"
                },
                "description": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Intervention description"
                }
              }
            }
          },
          "sponsor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Lead sponsor name"
          },
          "sponsor_class": {
            "type": [
              "string",
              "null"
            ],
            "description": "Sponsor class"
          },
          "collaborators": {
            "type": "array",
            "description": "List of collaborator names",
            "items": {
              "type": "string"
            }
          },
          "start_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "Trial start date"
          },
          "primary_completion_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "Primary completion date"
          },
          "completion_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "Final completion date"
          }
        }
      }
    }
  },
  "required": [
    "total_count",
    "studies"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "clinicaltrials": {
      "url": "https://gateway.pipeworx.io/clinicaltrials/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build August 8, 2026