ct_search

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

Search clinical trials by keyword, condition, status (e.g., ‘Recruiting’), or phase (e.g., ‘Phase 2’). Returns NCT IDs, titles, status, enrollment, and sponsor info.

Parameters

NameTypeRequiredDescription
querystringyesSearch term (e.g., “GLP-1 receptor agonist”, “breast cancer immunotherapy”)
statusstringnoFilter by overall status: RECRUITING, ACTIVE_NOT_RECRUITING, COMPLETED, TERMINATED, WITHDRAWN, ENROLLING_BY_INVITATION, SUSPENDED, NOT_YET_RECRUITING
phasestringnoFilter by phase: EARLY_PHASE1, PHASE1, PHASE2, PHASE3, PHASE4
sponsorstringnoFilter by sponsor name (e.g., “Pfizer”, “Novo Nordisk”)
limitnumbernoNumber of results (1-100, default 10)

Example call

Arguments

{
  "query": "GLP-1 receptor agonist",
  "status": "RECRUITING",
  "phase": "PHASE2",
  "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_search","arguments":{"query":"GLP-1 receptor agonist","status":"RECRUITING","phase":"PHASE2","limit":20}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('ct_search', {
  "query": "GLP-1 receptor agonist",
  "status": "RECRUITING",
  "phase": "PHASE2",
  "limit": 20
});

More examples

{
  "query": "breast cancer immunotherapy",
  "sponsor": "Pfizer",
  "limit": 10
}

Response shape

Always returns: total_count, studies

FieldTypeDescription
total_countnumberTotal number of matching trials
studiesarrayList of formatted trial summaries
Full JSON Schema
{
  "type": "object",
  "properties": {
    "total_count": {
      "type": "number",
      "description": "Total number of matching 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 (e.g., Actual, Anticipated)"
          },
          "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 May 9, 2026