clinicaltrialsgov-mcp-server
Version:
Search ClinicalTrials.gov trials, retrieve study details and results, and match patients to eligible trials via MCP. STDIO or Streamable HTTP.
54 lines • 2.63 kB
TypeScript
/**
* @fileoverview Single study lookup by NCT ID. Returns the full study record including
* protocol details, eligibility criteria, outcomes, arms, interventions, contacts, and locations.
* @module mcp-server/tools/definitions/get-study.tool
*/
import { z } from '@cyanheads/mcp-ts-core';
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
export declare const getStudy: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
nctId: z.ZodString;
locationLimit: z.ZodOptional<z.ZodNumber>;
outcomeLimit: z.ZodOptional<z.ZodNumber>;
referenceLimit: z.ZodOptional<z.ZodNumber>;
nearLocation: z.ZodOptional<z.ZodObject<{
lat: z.ZodNumber;
lon: z.ZodNumber;
radiusMi: z.ZodDefault<z.ZodNumber>;
}, z.core.$strip>>;
}, z.core.$strip>, z.ZodObject<{
study: z.ZodRecord<z.ZodString, z.ZodUnknown>;
filtersApplied: z.ZodObject<{
totalLocations: z.ZodOptional<z.ZodNumber>;
locationsWithoutGeo: z.ZodOptional<z.ZodNumber>;
totalSecondaryOutcomes: z.ZodOptional<z.ZodNumber>;
totalOtherOutcomes: z.ZodOptional<z.ZodNumber>;
totalReferences: z.ZodOptional<z.ZodNumber>;
locationLimit: z.ZodOptional<z.ZodNumber>;
outcomeLimit: z.ZodOptional<z.ZodNumber>;
referenceLimit: z.ZodOptional<z.ZodNumber>;
nearLocation: z.ZodOptional<z.ZodObject<{
lat: z.ZodNumber;
lon: z.ZodNumber;
radiusMi: z.ZodNumber;
}, z.core.$strip>>;
}, z.core.$strip>;
resultsSummary: z.ZodOptional<z.ZodObject<{
outcomeMeasures: z.ZodOptional<z.ZodNumber>;
seriousAdverseEvents: z.ZodOptional<z.ZodNumber>;
otherAdverseEvents: z.ZodOptional<z.ZodNumber>;
participantFlowPeriods: z.ZodOptional<z.ZodNumber>;
baselineMeasures: z.ZodOptional<z.ZodNumber>;
}, z.core.$strip>>;
}, z.core.$strip>, readonly [{
readonly reason: "study_not_found";
readonly code: JsonRpcErrorCode.NotFound;
readonly when: "The provided NCT ID does not match any study at ClinicalTrials.gov.";
readonly recovery: "Verify the NCT ID at clinicaltrials.gov or call clinicaltrials_search_studies to discover a valid identifier.";
}, {
readonly reason: "rate_limited";
readonly code: JsonRpcErrorCode.RateLimited;
readonly when: "ClinicalTrials.gov returned 429 after retry budget exhausted.";
readonly recovery: "ClinicalTrials.gov rate-limited the request after several retries; wait about a minute before trying again.";
readonly retryable: true;
}], undefined>;
//# sourceMappingURL=get-study.tool.d.ts.map