clinicaltrialsgov-mcp-server 1.2.1 → 1.3.0

package/README.md

@@ -5,7 +5,7 @@
 
 <div align="center">
 
-[![Version](https://img.shields.io/badge/Version-2.3.1-blue.svg?style=flat-square)](./CHANGELOG.md) [![MCP Spec](https://img.shields.io/badge/MCP%20Spec-2025--06--18-8A2BE2.svg?style=flat-square)](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification/2025-06-18/changelog.mdx) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.18.2-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Status](https://img.shields.io/badge/Status-Stable-brightgreen.svg?style=flat-square)](https://github.com/cyanheads/clinicaltrialsgov-mcp-server/issues) [![TypeScript](https://img.shields.io/badge/TypeScript-^5.9.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.2.23-blueviolet.svg?style=flat-square)](https://bun.sh/) [![Code Coverage](https://img.shields.io/badge/Coverage-92.46%25-brightgreen.svg?style=flat-square)](./vitest.config.ts)
+[![Version](https://img.shields.io/badge/Version-1.3.0-blue.svg?style=flat-square)](./CHANGELOG.md) [![MCP Spec](https://img.shields.io/badge/MCP%20Spec-2025--06--18-8A2BE2.svg?style=flat-square)](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification/2025-06-18/changelog.mdx) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.18.2-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Status](https://img.shields.io/badge/Status-Stable-brightgreen.svg?style=flat-square)](https://github.com/cyanheads/clinicaltrialsgov-mcp-server/issues) [![TypeScript](https://img.shields.io/badge/TypeScript-^5.9.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.2.23-blueviolet.svg?style=flat-square)](https://bun.sh/) [![Code Coverage](https://img.shields.io/badge/Coverage-92.46%25-brightgreen.svg?style=flat-square)](./vitest.config.ts)
 
 </div>
 
@@ -13,13 +13,14 @@
 
 ## 🛠️ Tools Overview
 
-This server provides three powerful tools for accessing and analyzing clinical trial data from ClinicalTrials.gov:
+This server provides four powerful tools for accessing and analyzing clinical trial data from ClinicalTrials.gov:
 
-| Tool Name                       | Description                                                                                                                                |
-| :------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------- |
-| `clinicaltrials_search_studies` | Searches for clinical studies using a combination of query terms and filters. Supports pagination, sorting, and geographic filtering.      |
-| `clinicaltrials_get_study`      | Fetches one or more clinical studies by their NCT IDs. Returns either complete study data or concise summaries for each.                   |
-| `clinicaltrials_analyze_trends` | Performs statistical analysis on studies, aggregating data by status, country, sponsor, or phase. Handles up to 5000 studies per analysis. |
+| Tool Name                       | Description                                                                                                                                  |
+| :------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------- |
+| `clinicaltrials_search_studies` | Searches for clinical studies using query terms, filters, pagination, and sorting. Now includes geographic filtering.                        |
+| `clinicaltrials_get_study`      | Fetches one or more clinical studies by their NCT IDs, returning either full data or concise summaries.                                        |
+| `clinicaltrials_analyze_trends` | Performs statistical analysis on up to 5000 studies, with new time-series analysis by year and month.                                        |
+| `clinicaltrials_compare_studies`| Performs a detailed side-by-side comparison of 2-5 clinical studies, highlighting commonalities and differences.                              |
 
 ### `clinicaltrials_search_studies`
 
@@ -85,6 +86,28 @@ This server provides three powerful tools for accessing and analyzing clinical t
 
 📖 **[View detailed examples →](./examples/clinicaltrials_analyze_trends.md)**
 
+---
+
+### `clinicaltrials_compare_studies`
+
+**Compare and contrast multiple studies** to identify key similarities and differences.
+
+**Key Features:**
+
+- Side-by-side comparison of 2-5 studies by NCT ID
+- Extracts and contrasts eligibility, design, interventions, outcomes, sponsors, and more
+- Generates a summary of commonalities and differences
+- Handles partial failures gracefully if some studies cannot be fetched
+- Highly configurable to focus on specific fields of interest
+
+**Example Use Cases:**
+
+- "Compare the study design and eligibility criteria for NCT04516746 and NCT04516759"
+- "What are the main differences in interventions and outcomes between these three leading Alzheimer's trials?"
+- "Show me a side-by-side of sponsor and location data for these competitor studies"
+
+📖 **[View detailed examples →](./examples/clinicaltrials_compare_studies.md)**
+
 ## ✨ Features
 
 This server is built on the [`mcp-ts-template`](https://github.com/cyanheads/mcp-ts-template) and inherits its rich feature set:
@@ -158,7 +181,7 @@ All configuration is centralized and validated at startup in `src/config/index.t
 | Variable                | Description                                                                    | Default     |
 | :---------------------- | :----------------------------------------------------------------------------- | :---------- |
 | `MCP_TRANSPORT_TYPE`    | The transport to use: `stdio` or `http`.                                       | `http`      |
-| `MCP_HTTP_PORT`         | The port for the HTTP server.                                                  | `3010`      |
+| `MCP_HTTP_PORT`         | The port for the HTTP server.                                                  | `3017`      |
 | `MCP_AUTH_MODE`         | Authentication mode: `none`, `jwt`, or `oauth`.                                | `none`      |
 | `STORAGE_PROVIDER_TYPE` | Storage backend: `in-memory`, `filesystem`, `supabase`, `cloudflare-kv`, `r2`. | `in-memory` |
 | `OTEL_ENABLED`          | Set to `true` to enable OpenTelemetry.                                         | `false`     |

package/dist/index.js

@@ -117491,55 +117491,10 @@ var z = /* @__PURE__ */ Object.freeze({
   quotelessJson,
   ZodError
 });
-
-// src/types-global/errors.ts
-var JsonRpcErrorCode;
-((JsonRpcErrorCode2) => {
-  JsonRpcErrorCode2[JsonRpcErrorCode2["ParseError"] = -32700] = "ParseError";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["InvalidRequest"] = -32600] = "InvalidRequest";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["MethodNotFound"] = -32601] = "MethodNotFound";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["InvalidParams"] = -32602] = "InvalidParams";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["InternalError"] = -32603] = "InternalError";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["ServiceUnavailable"] = -32000] = "ServiceUnavailable";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["NotFound"] = -32001] = "NotFound";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["Conflict"] = -32002] = "Conflict";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["RateLimited"] = -32003] = "RateLimited";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["Timeout"] = -32004] = "Timeout";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["Forbidden"] = -32005] = "Forbidden";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["Unauthorized"] = -32006] = "Unauthorized";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["ValidationError"] = -32007] = "ValidationError";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["ConfigurationError"] = -32008] = "ConfigurationError";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["InitializationFailed"] = -32009] = "InitializationFailed";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["DatabaseError"] = -32010] = "DatabaseError";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["SerializationError"] = -32070] = "SerializationError";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["UnknownError"] = -32099] = "UnknownError";
-})(JsonRpcErrorCode ||= {});
-
-class McpError extends Error {
-  code;
-  data;
-  constructor(code, message, data, options) {
-    super(message, options);
-    this.code = code;
-    if (data) {
-      this.data = data;
-    }
-    this.name = "McpError";
-    Object.setPrototypeOf(this, McpError.prototype);
-    if (Error.captureStackTrace) {
-      Error.captureStackTrace(this, McpError);
-    }
-  }
-}
-var ErrorSchema = z.object({
-  code: z.nativeEnum(JsonRpcErrorCode).describe("Standardized error code from JsonRpcErrorCode enum"),
-  message: z.string().min(1, "Error message cannot be empty.").describe("Detailed human-readable error message"),
-  data: z.record(z.string(), z.unknown()).optional().describe("Optional structured data providing more context about the error")
-}).describe("Schema for validating structured error objects, ensuring consistency in error reporting.");
 // package.json
 var package_default = {
   name: "clinicaltrialsgov-mcp-server",
-  version: "1.2.1",
+  version: "1.3.0",
   mcpName: "io.github.cyanheads/clinicaltrialsgov-mcp-server",
   description: "ClinicalTrials.gov Model Context Protocol (MCP) Server that provides a suite of tools for interacting with the official ClinicalTrials.gov v2 API. Enables AI agents and LLMs to programmatically search, retrieve, and analyze clinical trial data.",
   main: "dist/index.js",
@@ -117569,9 +117524,12 @@ var package_default = {
   homepage: "https://github.com/cyanheads/clinicaltrialsgov-mcp-server#readme",
   scripts: {
     build: "bun build ./src/index.ts --outdir ./dist --target node",
+    "build:worker": "bun build ./src/worker.ts --outdir ./dist --target bun --no-external",
+    "deploy:dev": "MCP_TRANSPORT_TYPE=http bunx wrangler dev",
+    "deploy:prod": "MCP_TRANSPORT_TYPE=http bunx wrangler deploy",
     start: "bun ./dist/index.js",
-    "start:stdio": "MCP_LOG_LEVEL=debug MCP_TRANSPORT_TYPE=stdio bun ./dist/index.js",
-    "start:http": "MCP_LOG_LEVEL=debug MCP_TRANSPORT_TYPE=http bun ./dist/index.js",
+    "start:stdio": "MCP_TRANSPORT_TYPE=stdio bun ./dist/index.js",
+    "start:http": "MCP_TRANSPORT_TYPE=http bun ./dist/index.js",
     dev: "bun --watch src/index.ts",
     "dev:stdio": "MCP_LOG_LEVEL=debug MCP_TRANSPORT_TYPE=stdio bun --watch src/index.ts",
     "dev:http": "MCP_LOG_LEVEL=debug MCP_TRANSPORT_TYPE=http bun --watch src/index.ts",
@@ -117586,6 +117544,7 @@ var package_default = {
     tree: "bun run scripts/tree.ts",
     "fetch-spec": "bun run scripts/fetch-openapi-spec.ts",
     format: 'bun run prettier --write "**/*.{ts,js,json,md,html,css}"',
+    prepare: "bunx husky",
     inspector: "bunx mcp-inspector --config mcp.json --server clinicaltrialsgov-mcp-server",
     "db:duckdb-example": "MCP_LOG_LEVEL=debug tsc && node dist/storage/duckdbExample.js",
     test: "bun test --config vitest.config.ts",
@@ -117711,6 +117670,51 @@ var package_default = {
   }
 };
 
+// src/types-global/errors.ts
+var JsonRpcErrorCode;
+((JsonRpcErrorCode2) => {
+  JsonRpcErrorCode2[JsonRpcErrorCode2["ParseError"] = -32700] = "ParseError";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["InvalidRequest"] = -32600] = "InvalidRequest";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["MethodNotFound"] = -32601] = "MethodNotFound";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["InvalidParams"] = -32602] = "InvalidParams";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["InternalError"] = -32603] = "InternalError";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["ServiceUnavailable"] = -32000] = "ServiceUnavailable";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["NotFound"] = -32001] = "NotFound";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["Conflict"] = -32002] = "Conflict";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["RateLimited"] = -32003] = "RateLimited";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["Timeout"] = -32004] = "Timeout";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["Forbidden"] = -32005] = "Forbidden";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["Unauthorized"] = -32006] = "Unauthorized";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["ValidationError"] = -32007] = "ValidationError";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["ConfigurationError"] = -32008] = "ConfigurationError";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["InitializationFailed"] = -32009] = "InitializationFailed";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["DatabaseError"] = -32010] = "DatabaseError";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["SerializationError"] = -32070] = "SerializationError";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["UnknownError"] = -32099] = "UnknownError";
+})(JsonRpcErrorCode ||= {});
+
+class McpError extends Error {
+  code;
+  data;
+  constructor(code, message, data, options) {
+    super(message, options);
+    this.code = code;
+    if (data) {
+      this.data = data;
+    }
+    this.name = "McpError";
+    Object.setPrototypeOf(this, McpError.prototype);
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, McpError);
+    }
+  }
+}
+var ErrorSchema = z.object({
+  code: z.nativeEnum(JsonRpcErrorCode).describe("Standardized error code from JsonRpcErrorCode enum"),
+  message: z.string().min(1, "Error message cannot be empty.").describe("Detailed human-readable error message"),
+  data: z.record(z.string(), z.unknown()).optional().describe("Optional structured data providing more context about the error")
+}).describe("Schema for validating structured error objects, ensuring consistency in error reporting.");
+
 // src/config/index.ts
 var packageManifest = package_default;
 var hasFileSystemAccess = typeof process !== "undefined" && typeof process.versions === "object" && process.versions !== null && typeof process.versions.node === "string";
@@ -117759,7 +117763,7 @@ var ConfigSchema = z.object({
   }, z.enum(["development", "production", "testing"])).default("development"),
   mcpTransportType: z.preprocess(emptyStringAsUndefined, z.enum(["stdio", "http"]).default("stdio")),
   mcpSessionMode: z.preprocess(emptyStringAsUndefined, z.enum(["stateless", "stateful", "auto"]).default("auto")),
-  mcpHttpPort: z.coerce.number().default(3010),
+  mcpHttpPort: z.coerce.number().default(3017),
   mcpHttpHost: z.string().default("127.0.0.1"),
   mcpHttpEndpointPath: z.string().default("/mcp"),
   mcpHttpMaxPortRetries: z.coerce.number().default(15),
@@ -119520,7 +119524,7 @@ async function fetchWithTimeout(url, timeoutMs, context, options) {
 
 // src/container/index.ts
 var import_reflect_metadata = __toESM(require_Reflect(), 1);
-var import_tsyringe21 = __toESM(require_cjs3(), 1);
+var import_tsyringe22 = __toESM(require_cjs3(), 1);
 
 // src/container/registrations/core.ts
 var import_tsyringe9 = __toESM(require_cjs3(), 1);
@@ -119742,8 +119746,23 @@ class ClinicalTrialsGovProvider {
     if (params.query) {
       queryParams.set("query.term", params.query);
     }
-    if (params.filter) {
-      queryParams.set("filter.advanced", params.filter);
+    const geoFilters = [];
+    if (params.country) {
+      geoFilters.push(`AREA[LocationCountry]${params.country}`);
+    }
+    if (params.state) {
+      geoFilters.push(`AREA[LocationState]${params.state}`);
+    }
+    if (params.city) {
+      geoFilters.push(`AREA[LocationCity]${params.city}`);
+    }
+    let combinedFilter = params.filter || "";
+    if (geoFilters.length > 0) {
+      const geoFilterExpression = geoFilters.join(" AND ");
+      combinedFilter = combinedFilter ? `(${combinedFilter}) AND (${geoFilterExpression})` : geoFilterExpression;
+    }
+    if (combinedFilter) {
+      queryParams.set("filter.advanced", combinedFilter);
     }
     if (params.pageSize) {
       queryParams.set("pageSize", String(params.pageSize));
@@ -119754,6 +119773,9 @@ class ClinicalTrialsGovProvider {
     if (params.sort) {
       queryParams.set("sort", params.sort);
     }
+    if (params.fields && params.fields.length > 0) {
+      queryParams.set("fields", params.fields.join(","));
+    }
     queryParams.set("countTotal", "true");
     const url = `${BASE_URL}/studies?${queryParams.toString()}`;
     const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
@@ -126883,7 +126905,7 @@ var registerCoreServices = () => {
 };
 
 // src/container/registrations/mcp.ts
-var import_tsyringe20 = __toESM(require_cjs3(), 1);
+var import_tsyringe21 = __toESM(require_cjs3(), 1);
 
 // src/mcp-server/resources/resource-registration.ts
 var import_tsyringe10 = __toESM(require_cjs3(), 1);
@@ -130198,10 +130220,10 @@ var registerResources = (container3) => {
 };
 
 // src/mcp-server/server.ts
-var import_tsyringe15 = __toESM(require_cjs3(), 1);
+var import_tsyringe16 = __toESM(require_cjs3(), 1);
 
 // src/mcp-server/tools/tool-registration.ts
-var import_tsyringe14 = __toESM(require_cjs3(), 1);
+var import_tsyringe15 = __toESM(require_cjs3(), 1);
 
 // src/mcp-server/tools/definitions/clinicaltrials-analyze-trends.tool.ts
 var import_tsyringe11 = __toESM(require_cjs3(), 1);
@@ -130247,7 +130269,7 @@ function withToolAuth(requiredScopes, logicFn) {
 // src/mcp-server/tools/definitions/clinicaltrials-analyze-trends.tool.ts
 var TOOL_NAME = "clinicaltrials_analyze_trends";
 var TOOL_TITLE = "Analyze Clinical Trial Trends";
-var TOOL_DESCRIPTION = "Performs statistical analysis on clinical trial studies matching search criteria. Aggregates data by status, country, sponsor type, or phase. May fetch up to 5000 studies.";
+var TOOL_DESCRIPTION = "Performs statistical analysis on clinical trial studies matching search criteria. Aggregates data by status, country, sponsor type, phase, year, or month. May fetch up to 5000 studies.";
 var TOOL_ANNOTATIONS = {
   readOnlyHint: true,
   idempotentHint: true,
@@ -130259,7 +130281,9 @@ var AnalysisTypeSchema = z.enum([
   "countByStatus",
   "countByCountry",
   "countBySponsorType",
-  "countByPhase"
+  "countByPhase",
+  "countByYear",
+  "countByMonth"
 ]);
 var InputSchema = z.object({
   query: z.string().optional().describe("General search query for conditions, interventions, sponsors, or other terms."),
@@ -130267,7 +130291,7 @@ var InputSchema = z.object({
   analysisType: z.union([
     AnalysisTypeSchema.describe("A single analysis type to perform."),
     z.array(AnalysisTypeSchema).min(1).describe("An array of analysis types to perform.")
-  ]).describe("Specify one or more analysis types: countByStatus, countByCountry, countBySponsorType, or countByPhase.")
+  ]).describe("Specify one or more analysis types: countByStatus, countByCountry, countBySponsorType, countByPhase, countByYear, or countByMonth.")
 }).describe("Input parameters for analyzing clinical trial trends.");
 var AnalysisResultSchema = z.object({
   analysisType: AnalysisTypeSchema.describe("The type of analysis performed."),
@@ -130353,6 +130377,26 @@ async function analyzeTrendsLogic(input, appContext, _sdkContext) {
           });
           continue;
         }
+        case "countByYear": {
+          const startDate = study.protocolSection?.statusModule?.startDateStruct?.date;
+          if (startDate) {
+            const year = startDate.substring(0, 4);
+            results[year] = (results[year] ?? 0) + 1;
+          } else {
+            results["Unknown"] = (results["Unknown"] ?? 0) + 1;
+          }
+          continue;
+        }
+        case "countByMonth": {
+          const startDate = study.protocolSection?.statusModule?.startDateStruct?.date;
+          if (startDate && startDate.length >= 7) {
+            const yearMonth = startDate.substring(0, 7);
+            results[yearMonth] = (results[yearMonth] ?? 0) + 1;
+          } else {
+            results["Unknown"] = (results["Unknown"] ?? 0) + 1;
+          }
+          continue;
+        }
       }
       if (key) {
         results[key] = (results[key] ?? 0) + 1;
@@ -130413,16 +130457,472 @@ var analyzeTrendsTool = {
   responseFormatter
 };
 
-// src/mcp-server/tools/definitions/clinicaltrials-get-study.tool.ts
+// src/mcp-server/tools/definitions/clinicaltrials-compare-studies.tool.ts
 var import_tsyringe12 = __toESM(require_cjs3(), 1);
-var TOOL_NAME2 = "clinicaltrials_get_study";
-var TOOL_TITLE2 = "Get Clinical Study";
-var TOOL_DESCRIPTION2 = "Fetches one or more clinical trial studies from ClinicalTrials.gov by their NCT ID(s). Returns full study data or concise summaries.";
+var TOOL_NAME2 = "clinicaltrials_compare_studies";
+var TOOL_TITLE2 = "Compare Clinical Studies";
+var TOOL_DESCRIPTION2 = "Performs side-by-side comparison of 2-5 clinical trial studies. Compares eligibility criteria, design, interventions, outcomes, sponsors, and other key aspects.";
 var TOOL_ANNOTATIONS2 = {
   readOnlyHint: true,
   idempotentHint: true,
   openWorldHint: true
 };
+var ComparisonCategorySchema = z.enum([
+  "eligibility",
+  "design",
+  "interventions",
+  "outcomes",
+  "sponsors",
+  "locations",
+  "status",
+  "all"
+]);
+var InputSchema2 = z.object({
+  nctIds: z.array(z.string().regex(/^[Nn][Cc][Tt]\d{8}$/, "NCT ID must be 8 digits")).min(2, "At least 2 NCT IDs are required for comparison.").max(5, "Maximum 5 NCT IDs allowed for comparison.").describe("An array of 2-5 NCT IDs to compare."),
+  compareFields: z.union([
+    ComparisonCategorySchema.describe("A single comparison category to analyze."),
+    z.array(ComparisonCategorySchema).min(1).describe("An array of comparison categories to analyze.")
+  ]).default("all").describe("Specify which aspects to compare: eligibility, design, interventions, outcomes, sponsors, locations, status, or all.")
+}).describe("Input parameters for comparing clinical trial studies.");
+var StudyComparisonSchema = z.object({
+  nctId: z.string().describe("The NCT identifier."),
+  title: z.string().optional().describe("The study title."),
+  eligibility: z.object({
+    criteria: z.string().optional().describe("Eligibility criteria text."),
+    sex: z.string().optional().describe("Sex requirement."),
+    minimumAge: z.string().optional().describe("Minimum age."),
+    healthyVolunteers: z.boolean().optional().describe("Accepts healthy volunteers."),
+    stdAges: z.array(z.string()).optional().describe("Standard age groups.")
+  }).optional().describe("Eligibility criteria details."),
+  design: z.object({
+    studyType: z.string().optional().describe("Type of study."),
+    phases: z.array(z.string()).optional().describe("Trial phases."),
+    allocation: z.string().optional().describe("Allocation method."),
+    interventionModel: z.string().optional().describe("Intervention model."),
+    primaryPurpose: z.string().optional().describe("Primary purpose."),
+    masking: z.string().optional().describe("Masking/blinding approach.")
+  }).optional().describe("Study design details."),
+  interventions: z.array(z.object({
+    type: z.string().optional().describe("Intervention type."),
+    name: z.string().optional().describe("Intervention name."),
+    description: z.string().optional().describe("Description.")
+  })).optional().describe("List of interventions."),
+  outcomes: z.object({
+    primary: z.array(z.object({
+      measure: z.string().optional().describe("Outcome measure."),
+      timeFrame: z.string().optional().describe("Time frame.")
+    })).optional().describe("Primary outcomes."),
+    secondary: z.array(z.object({
+      measure: z.string().optional().describe("Outcome measure."),
+      timeFrame: z.string().optional().describe("Time frame.")
+    })).optional().describe("Secondary outcomes.")
+  }).optional().describe("Outcome measures."),
+  sponsors: z.object({
+    leadSponsor: z.object({
+      name: z.string().optional().describe("Sponsor name."),
+      class: z.string().optional().describe("Sponsor class.")
+    }).optional().describe("Lead sponsor."),
+    collaborators: z.array(z.object({
+      name: z.string().optional().describe("Collaborator name."),
+      class: z.string().optional().describe("Collaborator class.")
+    })).optional().describe("Collaborators.")
+  }).optional().describe("Sponsor information."),
+  locations: z.object({
+    totalCount: z.number().optional().describe("Total number of locations."),
+    countries: z.array(z.string()).optional().describe("List of countries."),
+    topCities: z.array(z.string()).optional().describe("Top cities by location count.")
+  }).optional().describe("Location summary."),
+  status: z.object({
+    overallStatus: z.string().optional().describe("Overall status."),
+    startDate: z.string().optional().describe("Start date."),
+    completionDate: z.string().optional().describe("Completion date."),
+    lastUpdateDate: z.string().optional().describe("Last update date.")
+  }).optional().describe("Status and timeline information.")
+}).describe("Structured comparison data for a single study.");
+var OutputSchema2 = z.object({
+  comparisons: z.array(StudyComparisonSchema).describe("Array of study comparisons."),
+  summary: z.object({
+    totalStudies: z.number().describe("Number of studies compared."),
+    comparedFields: z.array(z.string()).describe("Fields that were compared."),
+    commonalities: z.array(z.string()).optional().describe("Key commonalities found across studies."),
+    differences: z.array(z.string()).optional().describe("Key differences found across studies.")
+  }).describe("Summary of the comparison."),
+  errors: z.array(z.object({
+    nctId: z.string().describe("The NCT ID that failed."),
+    error: z.string().describe("Error message.")
+  })).optional().describe("Any errors encountered during comparison.")
+}).describe("Comparison results for clinical trial studies.");
+function extractEligibility(study) {
+  const eligibility = study.protocolSection?.eligibilityModule;
+  if (!eligibility)
+    return;
+  return {
+    criteria: eligibility.eligibilityCriteria,
+    sex: eligibility.sex,
+    minimumAge: eligibility.minimumAge,
+    healthyVolunteers: eligibility.healthyVolunteers,
+    stdAges: eligibility.stdAges
+  };
+}
+function extractDesign(study) {
+  const design = study.protocolSection?.designModule;
+  if (!design)
+    return;
+  return {
+    studyType: design.studyType,
+    phases: design.phases,
+    allocation: design.designInfo?.allocation,
+    interventionModel: design.designInfo?.interventionModel,
+    primaryPurpose: design.designInfo?.primaryPurpose,
+    masking: design.designInfo?.maskingInfo?.masking
+  };
+}
+function extractInterventions(study) {
+  const interventions = study.protocolSection?.armsInterventionsModule?.interventions;
+  if (!interventions)
+    return;
+  return interventions.map((i) => ({
+    type: i.type,
+    name: i.name,
+    description: i.description
+  }));
+}
+function extractOutcomes(study) {
+  const outcomes = study.protocolSection?.outcomesModule;
+  if (!outcomes)
+    return;
+  return {
+    primary: outcomes.primaryOutcomes?.map((o) => ({
+      measure: o.measure,
+      timeFrame: o.timeFrame
+    })),
+    secondary: outcomes.secondaryOutcomes?.map((o) => ({
+      measure: o.measure,
+      timeFrame: o.timeFrame
+    }))
+  };
+}
+function extractSponsors(study) {
+  const sponsors = study.protocolSection?.sponsorCollaboratorsModule;
+  if (!sponsors)
+    return;
+  return {
+    leadSponsor: sponsors.leadSponsor ? {
+      name: sponsors.leadSponsor.name,
+      class: sponsors.leadSponsor.class
+    } : undefined,
+    collaborators: sponsors.collaborators?.map((c) => ({
+      name: c.name,
+      class: c.class
+    }))
+  };
+}
+function extractLocations(study) {
+  const locations = study.protocolSection?.contactsLocationsModule?.locations;
+  if (!locations || locations.length === 0)
+    return;
+  const countries = [
+    ...new Set(locations.map((l) => l.country).filter(Boolean))
+  ];
+  const cityCount = {};
+  locations.forEach((loc) => {
+    if (loc.city) {
+      cityCount[loc.city] = (cityCount[loc.city] ?? 0) + 1;
+    }
+  });
+  const topCities = Object.entries(cityCount).sort((a, b) => b[1] - a[1]).slice(0, 5).map(([city]) => city);
+  return {
+    totalCount: locations.length,
+    countries,
+    topCities
+  };
+}
+function extractStatus(study) {
+  const status = study.protocolSection?.statusModule;
+  if (!status)
+    return;
+  return {
+    overallStatus: status.overallStatus,
+    startDate: status.startDateStruct?.date,
+    completionDate: status.completionDateStruct?.date,
+    lastUpdateDate: status.lastUpdatePostDateStruct?.date
+  };
+}
+function createStudyComparison(study, compareFields) {
+  const nctId = study.protocolSection?.identificationModule?.nctId ?? "Unknown";
+  const title = study.protocolSection?.identificationModule?.officialTitle ?? study.protocolSection?.identificationModule?.briefTitle;
+  const comparison = { nctId, title };
+  const shouldInclude = (field) => compareFields.includes("all") || compareFields.includes(field);
+  if (shouldInclude("eligibility")) {
+    comparison.eligibility = extractEligibility(study);
+  }
+  if (shouldInclude("design")) {
+    comparison.design = extractDesign(study);
+  }
+  if (shouldInclude("interventions")) {
+    comparison.interventions = extractInterventions(study);
+  }
+  if (shouldInclude("outcomes")) {
+    comparison.outcomes = extractOutcomes(study);
+  }
+  if (shouldInclude("sponsors")) {
+    comparison.sponsors = extractSponsors(study);
+  }
+  if (shouldInclude("locations")) {
+    comparison.locations = extractLocations(study);
+  }
+  if (shouldInclude("status")) {
+    comparison.status = extractStatus(study);
+  }
+  return comparison;
+}
+function analyzeSummary(comparisons, compareFields) {
+  const commonalities = [];
+  const differences = [];
+  if (compareFields.includes("all") || compareFields.includes("design")) {
+    const allPhases = comparisons.map((c) => c.design?.phases).filter(Boolean);
+    if (allPhases.length > 0) {
+      const firstPhases = allPhases[0]?.join(",");
+      const allSame = allPhases.every((p) => p?.join(",") === firstPhases);
+      if (allSame && firstPhases) {
+        commonalities.push(`All studies are in phase: ${firstPhases}`);
+      } else {
+        differences.push("Studies are in different trial phases");
+      }
+    }
+  }
+  if (compareFields.includes("all") || compareFields.includes("sponsors")) {
+    const sponsors = comparisons.map((c) => c.sponsors?.leadSponsor?.name).filter(Boolean);
+    const uniqueSponsors = [...new Set(sponsors)];
+    if (uniqueSponsors.length === 1 && sponsors.length === comparisons.length) {
+      commonalities.push(`All studies sponsored by: ${uniqueSponsors[0]}`);
+    } else if (uniqueSponsors.length > 1) {
+      differences.push(`Different lead sponsors: ${uniqueSponsors.join(", ")}`);
+    }
+  }
+  if (compareFields.includes("all") || compareFields.includes("status")) {
+    const statuses = comparisons.map((c) => c.status?.overallStatus).filter(Boolean);
+    const uniqueStatuses = [...new Set(statuses)];
+    if (uniqueStatuses.length === 1 && statuses.length === comparisons.length) {
+      commonalities.push(`All studies have status: ${uniqueStatuses[0]}`);
+    } else if (uniqueStatuses.length > 1) {
+      differences.push(`Different statuses: ${uniqueStatuses.join(", ")}`);
+    }
+  }
+  if (compareFields.includes("all") || compareFields.includes("locations")) {
+    const allCountries = comparisons.map((c) => c.locations?.countries ?? []).filter((countries) => countries.length > 0);
+    if (allCountries.length > 1) {
+      const commonCountries = allCountries.reduce((acc, countries) => acc.filter((c) => countries.includes(c)));
+      if (commonCountries.length > 0) {
+        commonalities.push(`Common countries: ${commonCountries.slice(0, 5).join(", ")}`);
+      }
+    }
+  }
+  return {
+    totalStudies: comparisons.length,
+    comparedFields: compareFields,
+    commonalities: commonalities.length > 0 ? commonalities : undefined,
+    differences: differences.length > 0 ? differences : undefined
+  };
+}
+async function compareStudiesLogic(input, appContext, _sdkContext) {
+  logger.debug(`Executing compareStudiesLogic for NCT IDs: ${input.nctIds.join(", ")}`, {
+    ...appContext,
+    toolInput: input
+  });
+  const provider = import_tsyringe12.container.resolve(ClinicalTrialsProvider);
+  const compareFields = Array.isArray(input.compareFields) ? input.compareFields : [input.compareFields];
+  const comparisons = [];
+  const errors = [];
+  const studyPromises = input.nctIds.map(async (nctId) => {
+    try {
+      const study = await provider.fetchStudy(nctId, appContext);
+      logger.info(`Successfully fetched study ${nctId} for comparison`, {
+        ...appContext
+      });
+      return { nctId, study };
+    } catch (error2) {
+      const errorMessage = error2 instanceof McpError ? error2.message : "An unexpected error occurred";
+      logger.warning(`Failed to fetch study ${nctId}: ${errorMessage}`, {
+        ...appContext,
+        nctId,
+        error: error2
+      });
+      errors.push({ nctId, error: errorMessage });
+      return null;
+    }
+  });
+  const results = await Promise.all(studyPromises);
+  results.forEach((result2) => {
+    if (result2) {
+      const comparison = createStudyComparison(result2.study, compareFields);
+      comparisons.push(comparison);
+    }
+  });
+  if (comparisons.length < 2) {
+    throw new McpError(-32007 /* ValidationError */, `Insufficient studies for comparison. Need at least 2, got ${comparisons.length}. ${errors.length > 0 ? `Errors: ${errors.map((e) => `${e.nctId}: ${e.error}`).join("; ")}` : ""}`, { errors, successfulFetches: comparisons.length });
+  }
+  const summary = analyzeSummary(comparisons, compareFields);
+  logger.info(`Successfully compared ${comparisons.length} studies`, {
+    ...appContext,
+    comparedFields: compareFields
+  });
+  const result = { comparisons, summary };
+  if (errors.length > 0) {
+    result.errors = errors;
+  }
+  return result;
+}
+function responseFormatter2(result) {
+  const { comparisons, summary, errors } = result;
+  const summaryParts = [
+    `# Comparison of ${summary.totalStudies} Clinical Trials`,
+    "",
+    "## Studies",
+    ...comparisons.map((c) => `- **${c.nctId}**: ${c.title ?? "No title"}`),
+    ""
+  ];
+  if (summary.commonalities && summary.commonalities.length > 0) {
+    summaryParts.push("## Commonalities");
+    summaryParts.push(...summary.commonalities.map((c) => `- ${c}`));
+    summaryParts.push("");
+  }
+  if (summary.differences && summary.differences.length > 0) {
+    summaryParts.push("## Key Differences");
+    summaryParts.push(...summary.differences.map((d) => `- ${d}`));
+    summaryParts.push("");
+  }
+  if (errors && errors.length > 0) {
+    summaryParts.push("## Errors");
+    summaryParts.push(...errors.map((e) => `- **${e.nctId}**: ${e.error}`));
+    summaryParts.push("");
+  }
+  summaryParts.push("---");
+  summaryParts.push("");
+  const detailParts = ["## Detailed Comparison", ""];
+  comparisons.forEach((comp, idx) => {
+    if (idx > 0)
+      detailParts.push("---", "");
+    detailParts.push(`### ${comp.nctId}: ${comp.title ?? "No title"}`, "");
+    if (comp.status) {
+      detailParts.push("**Status:**");
+      detailParts.push(`- Overall Status: ${comp.status.overallStatus ?? "N/A"}`);
+      detailParts.push(`- Start Date: ${comp.status.startDate ?? "N/A"}`);
+      detailParts.push(`- Completion Date: ${comp.status.completionDate ?? "N/A"}`);
+      detailParts.push("");
+    }
+    if (comp.design) {
+      detailParts.push("**Design:**");
+      detailParts.push(`- Study Type: ${comp.design.studyType ?? "N/A"}`);
+      detailParts.push(`- Phases: ${comp.design.phases?.join(", ") ?? "N/A"}`);
+      detailParts.push(`- Allocation: ${comp.design.allocation ?? "N/A"}`);
+      detailParts.push(`- Intervention Model: ${comp.design.interventionModel ?? "N/A"}`);
+      detailParts.push(`- Primary Purpose: ${comp.design.primaryPurpose ?? "N/A"}`);
+      detailParts.push(`- Masking: ${comp.design.masking ?? "N/A"}`);
+      detailParts.push("");
+    }
+    if (comp.eligibility) {
+      detailParts.push("**Eligibility:**");
+      detailParts.push(`- Sex: ${comp.eligibility.sex ?? "N/A"}`);
+      detailParts.push(`- Minimum Age: ${comp.eligibility.minimumAge ?? "N/A"}`);
+      detailParts.push(`- Healthy Volunteers: ${comp.eligibility.healthyVolunteers ?? "N/A"}`);
+      if (comp.eligibility.stdAges?.length) {
+        detailParts.push(`- Age Groups: ${comp.eligibility.stdAges.join(", ")}`);
+      }
+      if (comp.eligibility.criteria) {
+        detailParts.push(`- Criteria: ${comp.eligibility.criteria.substring(0, 200)}${comp.eligibility.criteria.length > 200 ? "..." : ""}`);
+      }
+      detailParts.push("");
+    }
+    if (comp.interventions && comp.interventions.length > 0) {
+      detailParts.push("**Interventions:**");
+      comp.interventions.forEach((int) => {
+        detailParts.push(`- ${int.type ?? "Unknown"}: ${int.name ?? "N/A"}`);
+        if (int.description) {
+          detailParts.push(`  ${int.description.substring(0, 150)}${int.description.length > 150 ? "..." : ""}`);
+        }
+      });
+      detailParts.push("");
+    }
+    if (comp.outcomes) {
+      if (comp.outcomes.primary && comp.outcomes.primary.length > 0) {
+        detailParts.push("**Primary Outcomes:**");
+        comp.outcomes.primary.forEach((out) => {
+          detailParts.push(`- ${out.measure ?? "N/A"}`);
+          if (out.timeFrame) {
+            detailParts.push(`  Time Frame: ${out.timeFrame}`);
+          }
+        });
+        detailParts.push("");
+      }
+      if (comp.outcomes.secondary && comp.outcomes.secondary.length > 0) {
+        detailParts.push("**Secondary Outcomes:**");
+        comp.outcomes.secondary.slice(0, 3).forEach((out) => {
+          detailParts.push(`- ${out.measure ?? "N/A"}`);
+        });
+        if (comp.outcomes.secondary.length > 3) {
+          detailParts.push(`  ...and ${comp.outcomes.secondary.length - 3} more`);
+        }
+        detailParts.push("");
+      }
+    }
+    if (comp.sponsors) {
+      detailParts.push("**Sponsors:**");
+      if (comp.sponsors.leadSponsor) {
+        detailParts.push(`- Lead: ${comp.sponsors.leadSponsor.name ?? "N/A"} (${comp.sponsors.leadSponsor.class ?? "N/A"})`);
+      }
+      if (comp.sponsors.collaborators && comp.sponsors.collaborators.length > 0) {
+        detailParts.push(`- Collaborators: ${comp.sponsors.collaborators.length}`);
+        comp.sponsors.collaborators.slice(0, 3).forEach((collab) => {
+          detailParts.push(`  - ${collab.name ?? "N/A"}`);
+        });
+        if (comp.sponsors.collaborators.length > 3) {
+          detailParts.push(`  ...and ${comp.sponsors.collaborators.length - 3} more`);
+        }
+      }
+      detailParts.push("");
+    }
+    if (comp.locations) {
+      detailParts.push("**Locations:**");
+      detailParts.push(`- Total: ${comp.locations.totalCount ?? 0}`);
+      if (comp.locations.countries?.length) {
+        detailParts.push(`- Countries: ${comp.locations.countries.join(", ")}`);
+      }
+      if (comp.locations.topCities?.length) {
+        detailParts.push(`- Top Cities: ${comp.locations.topCities.join(", ")}`);
+      }
+      detailParts.push("");
+    }
+  });
+  return [
+    {
+      type: "text",
+      text: [...summaryParts, ...detailParts].join(`
+`)
+    }
+  ];
+}
+var compareStudiesTool = {
+  name: TOOL_NAME2,
+  title: TOOL_TITLE2,
+  description: TOOL_DESCRIPTION2,
+  inputSchema: InputSchema2,
+  outputSchema: OutputSchema2,
+  annotations: TOOL_ANNOTATIONS2,
+  logic: withToolAuth(["tool:clinicaltrials:read"], compareStudiesLogic),
+  responseFormatter: responseFormatter2
+};
+
+// src/mcp-server/tools/definitions/clinicaltrials-get-study.tool.ts
+var import_tsyringe13 = __toESM(require_cjs3(), 1);
+var TOOL_NAME3 = "clinicaltrials_get_study";
+var TOOL_TITLE3 = "Get Clinical Study";
+var TOOL_DESCRIPTION3 = "Fetches one or more clinical trial studies from ClinicalTrials.gov by their NCT ID(s). Returns full study data or concise summaries.";
+var TOOL_ANNOTATIONS3 = {
+  readOnlyHint: true,
+  idempotentHint: true,
+  openWorldHint: true
+};
 var StudySummarySchema = z.object({
   nctId: z.string().optional().describe("The NCT identifier of the study."),
   title: z.string().optional().describe("The official title of the study."),
@@ -130435,14 +130935,14 @@ var StudySummarySchema = z.object({
   })).optional().describe("List of interventions being tested."),
   leadSponsor: z.string().optional().describe("The lead sponsor organization.")
 }).passthrough().describe("Concise summary of a clinical trial study.");
-var InputSchema2 = z.object({
+var InputSchema3 = z.object({
   nctIds: z.union([
     z.string().regex(/^[Nn][Cc][Tt]\d{8}$/, "NCT ID must be 8 digits").describe('A single NCT ID (e.g., "NCT12345678").'),
     z.array(z.string().regex(/^[Nn][Cc][Tt]\d{8}$/, "NCT ID must be 8 digits")).min(1, "At least one NCT ID is required.").max(5, "Maximum 5 NCT IDs allowed per request.").describe("An array of up to 5 NCT IDs.")
   ]).describe('A single NCT ID (e.g., "NCT12345678") or an array of up to 5 NCT IDs to fetch.'),
   summaryOnly: z.boolean().default(false).describe("If true, returns concise summaries. If false (default), returns full study data.")
 }).describe("Input parameters for fetching clinical trial studies.");
-var OutputSchema2 = z.object({
+var OutputSchema3 = z.object({
   studies: z.array(z.union([StudySchema, StudySummarySchema])).describe("Array of full study data or summaries."),
   errors: z.array(z.object({
     nctId: z.string().describe("The NCT ID that failed."),
@@ -130469,7 +130969,7 @@ async function getStudyLogic(input, appContext, _sdkContext) {
     ...appContext,
     toolInput: input
   });
-  const provider = import_tsyringe12.container.resolve(ClinicalTrialsProvider);
+  const provider = import_tsyringe13.container.resolve(ClinicalTrialsProvider);
   const studies = [];
   const errors = [];
   const studyPromises = nctIds.map(async (nctId) => {
@@ -130502,7 +131002,7 @@ async function getStudyLogic(input, appContext, _sdkContext) {
   }
   return result;
 }
-function responseFormatter2(result) {
+function responseFormatter3(result) {
   return [
     {
       type: "text",
@@ -130511,34 +131011,38 @@ function responseFormatter2(result) {
   ];
 }
 var getStudyTool = {
-  name: TOOL_NAME2,
-  title: TOOL_TITLE2,
-  description: TOOL_DESCRIPTION2,
-  inputSchema: InputSchema2,
-  outputSchema: OutputSchema2,
-  annotations: TOOL_ANNOTATIONS2,
+  name: TOOL_NAME3,
+  title: TOOL_TITLE3,
+  description: TOOL_DESCRIPTION3,
+  inputSchema: InputSchema3,
+  outputSchema: OutputSchema3,
+  annotations: TOOL_ANNOTATIONS3,
   logic: withToolAuth(["tool:clinicaltrials:read"], getStudyLogic),
-  responseFormatter: responseFormatter2
+  responseFormatter: responseFormatter3
 };
 
 // src/mcp-server/tools/definitions/clinicaltrials-search-studies.tool.ts
-var import_tsyringe13 = __toESM(require_cjs3(), 1);
-var TOOL_NAME3 = "clinicaltrials_search_studies";
-var TOOL_TITLE3 = "Search Clinical Trials";
-var TOOL_DESCRIPTION3 = "Searches for clinical trial studies from ClinicalTrials.gov using queries and filters. Supports pagination, sorting, and advanced filtering.";
-var TOOL_ANNOTATIONS3 = {
+var import_tsyringe14 = __toESM(require_cjs3(), 1);
+var TOOL_NAME4 = "clinicaltrials_search_studies";
+var TOOL_TITLE4 = "Search Clinical Trials";
+var TOOL_DESCRIPTION4 = "Searches for clinical trial studies from ClinicalTrials.gov using queries and filters. Supports pagination, sorting, and advanced filtering.";
+var TOOL_ANNOTATIONS4 = {
   readOnlyHint: true,
   idempotentHint: true,
   openWorldHint: true
 };
-var InputSchema3 = z.object({
+var InputSchema4 = z.object({
   query: z.string().optional().describe("General search query for conditions, interventions, sponsors, or other terms."),
   filter: z.string().optional().describe("Advanced filter expression using the ClinicalTrials.gov filter syntax."),
   pageSize: z.number().int().min(1).max(200).default(10).describe("Number of studies to return per page (1-200). Defaults to 10."),
   pageToken: z.string().optional().describe("Token for retrieving the next page of results."),
-  sort: z.string().optional().describe('Sort order specification (e.g., "LastUpdateDate:desc", "EnrollmentCount").')
+  sort: z.string().optional().describe('Sort order specification (e.g., "LastUpdateDate:desc", "EnrollmentCount").'),
+  fields: z.array(z.string()).optional().describe('Specific fields to return (reduces payload size). Example: ["NCTId", "BriefTitle", "OverallStatus"].'),
+  country: z.string().optional().describe('Filter studies by country (e.g., "United States", "Canada").'),
+  state: z.string().optional().describe('Filter studies by state or province (e.g., "California", "Ontario").'),
+  city: z.string().optional().describe('Filter studies by city (e.g., "New York", "Toronto").')
 }).describe("Input parameters for searching clinical trial studies.");
-var OutputSchema3 = z.object({
+var OutputSchema4 = z.object({
   pagedStudies: PagedStudiesSchema
 });
 async function searchStudiesLogic(input, appContext, _sdkContext) {
@@ -130546,13 +131050,17 @@ async function searchStudiesLogic(input, appContext, _sdkContext) {
     ...appContext,
     toolInput: input
   });
-  const provider = import_tsyringe13.container.resolve(ClinicalTrialsProvider);
+  const provider = import_tsyringe14.container.resolve(ClinicalTrialsProvider);
   const pagedStudies = await provider.listStudies({
     ...input.query && { query: input.query },
     ...input.filter && { filter: input.filter },
     pageSize: input.pageSize,
     ...input.pageToken && { pageToken: input.pageToken },
-    ...input.sort && { sort: input.sort }
+    ...input.sort && { sort: input.sort },
+    ...input.fields && { fields: input.fields },
+    ...input.country && { country: input.country },
+    ...input.state && { state: input.state },
+    ...input.city && { city: input.city }
   }, appContext);
   logger.info(`Successfully searched studies: ${pagedStudies.studies?.length ?? 0} results`, {
     ...appContext,
@@ -130560,7 +131068,7 @@ async function searchStudiesLogic(input, appContext, _sdkContext) {
   });
   return { pagedStudies };
 }
-function responseFormatter3(result) {
+function responseFormatter4(result) {
   const { pagedStudies } = result;
   const studyCount = pagedStudies.studies?.length ?? 0;
   const totalCount = pagedStudies.totalCount;
@@ -130593,19 +131101,20 @@ ${studyList}${moreStudies}${pagination}`
   ];
 }
 var searchStudiesTool = {
-  name: TOOL_NAME3,
-  title: TOOL_TITLE3,
-  description: TOOL_DESCRIPTION3,
-  inputSchema: InputSchema3,
-  outputSchema: OutputSchema3,
-  annotations: TOOL_ANNOTATIONS3,
+  name: TOOL_NAME4,
+  title: TOOL_TITLE4,
+  description: TOOL_DESCRIPTION4,
+  inputSchema: InputSchema4,
+  outputSchema: OutputSchema4,
+  annotations: TOOL_ANNOTATIONS4,
   logic: withToolAuth(["tool:clinicaltrials:read"], searchStudiesLogic),
-  responseFormatter: responseFormatter3
+  responseFormatter: responseFormatter4
 };
 
 // src/mcp-server/tools/definitions/index.ts
 var allToolDefinitions = [
   analyzeTrendsTool,
+  compareStudiesTool,
   getStudyTool,
   searchStudiesTool
 ];
@@ -130617,7 +131126,7 @@ var defaultResponseFormatter2 = (result) => [
 function createMcpToolHandler({
   toolName,
   logic,
-  responseFormatter: responseFormatter4 = defaultResponseFormatter2
+  responseFormatter: responseFormatter5 = defaultResponseFormatter2
 }) {
   return async (input, callContext) => {
     const sdkContext = callContext;
@@ -130634,7 +131143,7 @@ function createMcpToolHandler({
       const result = await measureToolExecution(() => logic(input, appContext, sdkContext), { ...appContext, toolName }, input);
       return {
         structuredContent: result,
-        content: responseFormatter4(result)
+        content: responseFormatter5(result)
       };
     } catch (error2) {
       const mcpError = ErrorHandler.handleError(error2, {
@@ -130705,15 +131214,15 @@ class ToolRegistry {
   }
 }
 ToolRegistry = __legacyDecorateClassTS([
-  import_tsyringe14.injectable(),
-  __legacyDecorateParamTS(0, import_tsyringe14.injectAll(ToolDefinitions)),
+  import_tsyringe15.injectable(),
+  __legacyDecorateParamTS(0, import_tsyringe15.injectAll(ToolDefinitions)),
   __legacyMetadataTS("design:paramtypes", [
     Array
   ])
 ], ToolRegistry);
-var registerTools = (container6) => {
+var registerTools = (container7) => {
   for (const tool of allToolDefinitions) {
-    container6.register(ToolDefinitions, { useValue: tool });
+    container7.register(ToolDefinitions, { useValue: tool });
   }
 };
 
@@ -130745,9 +131254,9 @@ async function createMcpServerInstance() {
   });
   try {
     logger.debug("Registering all MCP capabilities via registries...", context);
-    const toolRegistry = import_tsyringe15.container.resolve(ToolRegistry);
+    const toolRegistry = import_tsyringe16.container.resolve(ToolRegistry);
     await toolRegistry.registerAll(server);
-    const resourceRegistry = import_tsyringe15.container.resolve(ResourceRegistry);
+    const resourceRegistry = import_tsyringe16.container.resolve(ResourceRegistry);
     await resourceRegistry.registerAll(server);
     logger.info("All MCP capabilities registered successfully", context);
   } catch (err) {
@@ -130762,7 +131271,7 @@ async function createMcpServerInstance() {
 }
 
 // src/mcp-server/transports/manager.ts
-var import_tsyringe19 = __toESM(require_cjs3(), 1);
+var import_tsyringe20 = __toESM(require_cjs3(), 1);
 
 // node_modules/hono/dist/http-exception.js
 var HTTPException = class extends Error {
@@ -133430,7 +133939,7 @@ var cors = (options) => {
 import http from "http";
 import { randomUUID } from "node:crypto";
 // src/mcp-server/transports/auth/authFactory.ts
-var import_tsyringe18 = __toESM(require_cjs3(), 1);
+var import_tsyringe19 = __toESM(require_cjs3(), 1);
 
 // node_modules/jose/dist/webapi/lib/buffer_utils.js
 var encoder = new TextEncoder;
@@ -134948,7 +135457,7 @@ function createRemoteJWKSet(url, options) {
   return remoteJWKSet;
 }
 // src/mcp-server/transports/auth/strategies/jwtStrategy.ts
-var import_tsyringe16 = __toESM(require_cjs3(), 1);
+var import_tsyringe17 = __toESM(require_cjs3(), 1);
 class JwtStrategy {
   config;
   logger;
@@ -135051,9 +135560,9 @@ class JwtStrategy {
   }
 }
 JwtStrategy = __legacyDecorateClassTS([
-  import_tsyringe16.injectable(),
-  __legacyDecorateParamTS(0, import_tsyringe16.inject(AppConfig)),
-  __legacyDecorateParamTS(1, import_tsyringe16.inject(Logger2)),
+  import_tsyringe17.injectable(),
+  __legacyDecorateParamTS(0, import_tsyringe17.inject(AppConfig)),
+  __legacyDecorateParamTS(1, import_tsyringe17.inject(Logger2)),
   __legacyMetadataTS("design:paramtypes", [
     Object,
     Object
@@ -135061,7 +135570,7 @@ JwtStrategy = __legacyDecorateClassTS([
 ], JwtStrategy);
 
 // src/mcp-server/transports/auth/strategies/oauthStrategy.ts
-var import_tsyringe17 = __toESM(require_cjs3(), 1);
+var import_tsyringe18 = __toESM(require_cjs3(), 1);
 class OauthStrategy {
   config;
   logger;
@@ -135178,9 +135687,9 @@ class OauthStrategy {
   }
 }
 OauthStrategy = __legacyDecorateClassTS([
-  import_tsyringe17.injectable(),
-  __legacyDecorateParamTS(0, import_tsyringe17.inject(AppConfig)),
-  __legacyDecorateParamTS(1, import_tsyringe17.inject(Logger2)),
+  import_tsyringe18.injectable(),
+  __legacyDecorateParamTS(0, import_tsyringe18.inject(AppConfig)),
+  __legacyDecorateParamTS(1, import_tsyringe18.inject(Logger2)),
   __legacyMetadataTS("design:paramtypes", [
     Object,
     Object
@@ -135188,8 +135697,8 @@ OauthStrategy = __legacyDecorateClassTS([
 ], OauthStrategy);
 
 // src/mcp-server/transports/auth/authFactory.ts
-import_tsyringe18.container.register(JwtStrategy, { useClass: JwtStrategy });
-import_tsyringe18.container.register(OauthStrategy, { useClass: OauthStrategy });
+import_tsyringe19.container.register(JwtStrategy, { useClass: JwtStrategy });
+import_tsyringe19.container.register(OauthStrategy, { useClass: OauthStrategy });
 function createAuthStrategy() {
   const context = requestContextService.createRequestContext({
     operation: "createAuthStrategy",
@@ -135199,10 +135708,10 @@ function createAuthStrategy() {
   switch (config.mcpAuthMode) {
     case "jwt":
       logger.debug("Resolving JWT strategy from container.", context);
-      return import_tsyringe18.container.resolve(JwtStrategy);
+      return import_tsyringe19.container.resolve(JwtStrategy);
     case "oauth":
       logger.debug("Resolving OAuth strategy from container.", context);
-      return import_tsyringe18.container.resolve(OauthStrategy);
+      return import_tsyringe19.container.resolve(OauthStrategy);
     case "none":
       logger.info("Authentication is disabled ('none' mode).", context);
       return null;
@@ -135716,10 +136225,10 @@ class TransportManager {
   }
 }
 TransportManager = __legacyDecorateClassTS([
-  import_tsyringe19.injectable(),
-  __legacyDecorateParamTS(0, import_tsyringe19.inject(AppConfig)),
-  __legacyDecorateParamTS(1, import_tsyringe19.inject(Logger2)),
-  __legacyDecorateParamTS(2, import_tsyringe19.inject(CreateMcpServerInstance)),
+  import_tsyringe20.injectable(),
+  __legacyDecorateParamTS(0, import_tsyringe20.inject(AppConfig)),
+  __legacyDecorateParamTS(1, import_tsyringe20.inject(Logger2)),
+  __legacyDecorateParamTS(2, import_tsyringe20.inject(CreateMcpServerInstance)),
   __legacyMetadataTS("design:paramtypes", [
     typeof AppConfigType === "undefined" ? Object : AppConfigType,
     Object,
@@ -135729,14 +136238,14 @@ TransportManager = __legacyDecorateClassTS([
 
 // src/container/registrations/mcp.ts
 var registerMcpServices = () => {
-  import_tsyringe20.container.registerSingleton(ToolRegistry);
-  import_tsyringe20.container.registerSingleton(ResourceRegistry);
-  registerTools(import_tsyringe20.container);
-  registerResources(import_tsyringe20.container);
-  import_tsyringe20.container.register(CreateMcpServerInstance, {
+  import_tsyringe21.container.registerSingleton(ToolRegistry);
+  import_tsyringe21.container.registerSingleton(ResourceRegistry);
+  registerTools(import_tsyringe21.container);
+  registerResources(import_tsyringe21.container);
+  import_tsyringe21.container.register(CreateMcpServerInstance, {
     useValue: createMcpServerInstance
   });
-  import_tsyringe20.container.registerSingleton(TransportManagerToken, TransportManager);
+  import_tsyringe21.container.registerSingleton(TransportManagerToken, TransportManager);
   logger.info("MCP services and factories registered with the DI container.");
 };
 
@@ -135750,7 +136259,7 @@ function composeContainer() {
   registerMcpServices();
   isContainerComposed = true;
 }
-var container_default = import_tsyringe21.container;
+var container_default = import_tsyringe22.container;
 
 // src/index.ts
 var config2;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clinicaltrialsgov-mcp-server",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "mcpName": "io.github.cyanheads/clinicaltrialsgov-mcp-server",
   "description": "ClinicalTrials.gov Model Context Protocol (MCP) Server that provides a suite of tools for interacting with the official ClinicalTrials.gov v2 API. Enables AI agents and LLMs to programmatically search, retrieve, and analyze clinical trial data.",
   "main": "dist/index.js",
@@ -30,9 +30,12 @@
   "homepage": "https://github.com/cyanheads/clinicaltrialsgov-mcp-server#readme",
   "scripts": {
     "build": "bun build ./src/index.ts --outdir ./dist --target node",
+    "build:worker": "bun build ./src/worker.ts --outdir ./dist --target bun --no-external",
+    "deploy:dev": "MCP_TRANSPORT_TYPE=http bunx wrangler dev",
+    "deploy:prod": "MCP_TRANSPORT_TYPE=http bunx wrangler deploy",
     "start": "bun ./dist/index.js",
-    "start:stdio": "MCP_LOG_LEVEL=debug MCP_TRANSPORT_TYPE=stdio bun ./dist/index.js",
-    "start:http": "MCP_LOG_LEVEL=debug MCP_TRANSPORT_TYPE=http bun ./dist/index.js",
+    "start:stdio": "MCP_TRANSPORT_TYPE=stdio bun ./dist/index.js",
+    "start:http": "MCP_TRANSPORT_TYPE=http bun ./dist/index.js",
     "dev": "bun --watch src/index.ts",
     "dev:stdio": "MCP_LOG_LEVEL=debug MCP_TRANSPORT_TYPE=stdio bun --watch src/index.ts",
     "dev:http": "MCP_LOG_LEVEL=debug MCP_TRANSPORT_TYPE=http bun --watch src/index.ts",
@@ -47,6 +50,7 @@
     "tree": "bun run scripts/tree.ts",
     "fetch-spec": "bun run scripts/fetch-openapi-spec.ts",
     "format": "bun run prettier --write \"**/*.{ts,js,json,md,html,css}\"",
+    "prepare": "bunx husky",
     "inspector": "bunx mcp-inspector --config mcp.json --server clinicaltrialsgov-mcp-server",
     "db:duckdb-example": "MCP_LOG_LEVEL=debug tsc && node dist/storage/duckdbExample.js",
     "test": "bun test --config vitest.config.ts",