Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Added value: +false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "study",
+      "filtersApplied"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `study_not_found`: The provided NCT ID does not match any study at ClinicalTrials.gov. `rate_limited`: ClinicalTrials.gov returned 429 after retry budget exhausted. Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "study_not_found",
+            "rate_limited"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "study",
-  "filtersApplied"
-]

Previous value: -"Optional cap on the number of locations returned. Omit for no cap (full upstream list). Pairs naturally with nearLocation for narrowing a large multi-site trial. Original total preserved in filtersApplied.totalLocations whenever a cap is applied."New value: +"Optional cap on the number of locations returned. Omit for no cap (full upstream list). Pairs naturally with nearLocation for narrowing a large multi-site trial. Original total preserved in filtersApplied.totalLocations only when the cap trims the list."

Previous value: -"Filter returned locations to those within radius of (lat, lon) and sort by distance. Adds distanceMi to each location. Locations without published coordinates are dropped — most US sites carry them; international sites less reliably so. For broader geographic filtering across studies, use clinicaltrials_search_studies with geoFilter."New value: +"Filter returned locations to those within radius of (lat, lon) and sort by distance. Adds distanceMi to each location. Locations without published coordinates are dropped — most US sites carry them; international sites less reliably so. Distances reflect ClinicalTrials.gov geocoding granularity — typically city-centroid, not facility-level — so multiple sites in the same city resolve to near-identical distances. For broader geographic filtering across studies, use clinicaltrials_search_studies with geoFilter."

Previous value: -"Optional cap on the number of secondary and other outcomes returned. Omit for no cap (full upstream lists). Primary outcomes are never capped. Original totals preserved in filtersApplied.totalSecondaryOutcomes / totalOtherOutcomes whenever a cap is applied."New value: +"Optional cap on the number of secondary and other outcomes returned. Omit for no cap (full upstream lists). Primary outcomes are never capped. Original totals preserved in filtersApplied.totalSecondaryOutcomes / totalOtherOutcomes only when the cap trims a list."

Previous value: -"Optional cap on the number of references returned. Omit for no cap (full upstream list). Original total preserved in filtersApplied.totalReferences whenever a cap is applied. seeAlsoLinks are never capped."New value: +"Optional cap on the number of references returned. Omit for no cap (full upstream list). Original total preserved in filtersApplied.totalReferences only when the cap trims the list. seeAlsoLinks are never capped."

Previous value: -"Echo of the locationLimit input."New value: +"Echo of the locationLimit input — present only when the cap trimmed the list."

Previous value: -"Echo of the outcomeLimit input."New value: +"Echo of the outcomeLimit input — present only when the cap trimmed a list."

Previous value: -"Echo of the referenceLimit input."New value: +"Echo of the referenceLimit input — present only when the cap trimmed the list."

Added value: +{
+  "description": "Optional cap on the number of references returned. Omit for no cap (full upstream list). Original total preserved in filtersApplied.totalReferences whenever a cap is applied. seeAlsoLinks are never capped.",
+  "maximum": 100,
+  "minimum": 1,
+  "type": "integer"
+}

Added value: +{
+  "description": "Echo of the referenceLimit input.",
+  "maximum": 9007199254740991,
+  "minimum": -9007199254740991,
+  "type": "integer"
+}

Added value: +{
+  "description": "Upstream reference count before referenceLimit was applied.",
+  "maximum": 9007199254740991,
+  "minimum": -9007199254740991,
+  "type": "integer"
+}

Added value: +{
+  "additionalProperties": false,
+  "description": "Compact counts of posted results, present when hasResults is true. The full resultsSection is intentionally omitted from this record-level tool — fetch it via clinicaltrials_get_study_results or the clinicaltrials://{nctId} resource.",
+  "properties": {
+    "baselineMeasures": {
+      "description": "Baseline characteristic measures.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "otherAdverseEvents": {
+      "description": "Distinct other (non-serious) adverse-event terms.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "outcomeMeasures": {
+      "description": "Posted outcome measures.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "participantFlowPeriods": {
+      "description": "Participant-flow periods.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "seriousAdverseEvents": {
+      "description": "Distinct serious adverse-event terms.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    }
+  },
+  "type": "object"
+}

Previous value: -"Full study record with caller-requested filters already applied to locations and outcomes. Top-level keys: protocolSection (identification, status, sponsor, conditions, design, arms/interventions, outcomes, eligibility, contacts/locations), derivedSection (MeSH-normalized terms), hasResults, resultsSection, documentSection. Use clinicaltrials_get_field_definitions to explore the schema."New value: +"Full study record with caller-requested filters already applied to locations and outcomes. Top-level keys: protocolSection (identification, status, sponsor, conditions, design, arms/interventions, outcomes, eligibility, contacts/locations), derivedSection (MeSH-normalized terms), hasResults, documentSection. The heavy resultsSection is omitted — see resultsSummary for counts and clinicaltrials_get_study_results for full results data. Use clinicaltrials_get_field_definitions to explore the schema."

Removed value: -10

Previous value: -"Max locations to render in the formatted output. 0 = unlimited. Default 10. Pairs naturally with nearLocation for narrowing a large multi-site trial."New value: +"Optional cap on the number of locations returned. Omit for no cap (full upstream list). Pairs naturally with nearLocation for narrowing a large multi-site trial. Original total preserved in filtersApplied.totalLocations whenever a cap is applied."

Previous value: -0New value: +1

Previous value: -"NCT identifier (e.g., NCT03722472)."New value: +"NCT identifier — format `NCT` followed by 8 digits (e.g., `NCT03722472`)."

Previous value: -"Filter rendered locations to those within radius of (lat, lon) and sort by distance. Only locations with upstream coordinates are returned — most US sites carry them; international sites less reliably so. Use clinicaltrials_search_studies with geoFilter for upstream-side geographic filtering."New value: +"Filter returned locations to those within radius of (lat, lon) and sort by distance. Adds distanceMi to each location. Locations without published coordinates are dropped — most US sites carry them; international sites less reliably so. For broader geographic filtering across studies, use clinicaltrials_search_studies with geoFilter."

Removed value: -5

Previous value: -"Max secondary and other outcomes to render in the formatted output. 0 = unlimited. Default 5. Primary outcomes always render in full."New value: +"Optional cap on the number of secondary and other outcomes returned. Omit for no cap (full upstream lists). Primary outcomes are never capped. Original totals preserved in filtersApplied.totalSecondaryOutcomes / totalOtherOutcomes whenever a cap is applied."

Previous value: -0New value: +1

Added value: +{
+  "additionalProperties": false,
+  "description": "Metadata about the filtering applied to `study`.",
+  "properties": {
+    "locationLimit": {
+      "description": "Echo of the locationLimit input.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "locationsWithoutGeo": {
+      "description": "Number of upstream locations dropped because they lacked geoPoint when nearLocation was provided.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "nearLocation": {
+      "additionalProperties": false,
+      "description": "Echo of the nearLocation input.",
+      "properties": {
+        "lat": {
+          "description": "Latitude in decimal degrees.",
+          "type": "number"
+        },
+        "lon": {
+          "description": "Longitude in decimal degrees.",
+          "type": "number"
+        },
+        "radiusMi": {
+          "description": "Radius in miles.",
+          "type": "number"
+        }
+      },
+      "required": [
+        "lat",
+        "lon",
+        "radiusMi"
+      ],
+      "type": "object"
+    },
+    "outcomeLimit": {
+      "description": "Echo of the outcomeLimit input.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "totalLocations": {
+      "description": "Upstream location count before any filter was applied.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "totalOtherOutcomes": {
+      "description": "Upstream other outcomes count before outcomeLimit was applied.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "totalSecondaryOutcomes": {
+      "description": "Upstream secondary outcomes count before outcomeLimit was applied.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    }
+  },
+  "type": "object"
+}

Removed value: -{
-  "description": "Echo of the locationLimit input; drives format() truncation.",
-  "maximum": 9007199254740991,
-  "minimum": -9007199254740991,
-  "type": "integer"
-}

Removed value: -{
-  "additionalProperties": false,
-  "description": "Echo of the nearLocation input; drives format() geo filter.",
-  "properties": {
-    "lat": {
-      "description": "Latitude in decimal degrees.",
-      "type": "number"
-    },
-    "lon": {
-      "description": "Longitude in decimal degrees.",
-      "type": "number"
-    },
-    "radiusMi": {
-      "description": "Radius in miles.",
-      "type": "number"
-    }
-  },
-  "required": [
-    "lat",
-    "lon",
-    "radiusMi"
-  ],
-  "type": "object"
-}

Removed value: -{
-  "description": "Echo of the outcomeLimit input; drives format() truncation.",
-  "maximum": 9007199254740991,
-  "minimum": -9007199254740991,
-  "type": "integer"
-}

Previous value: -"Full study record. Top-level keys: protocolSection (identification, status, sponsor, conditions, design, arms/interventions, outcomes, eligibility, contacts/locations), derivedSection (MeSH-normalized terms), hasResults, resultsSection, documentSection. Use clinicaltrials_get_field_definitions to explore the schema."New value: +"Full study record with caller-requested filters already applied to locations and outcomes. Top-level keys: protocolSection (identification, status, sponsor, conditions, design, arms/interventions, outcomes, eligibility, contacts/locations), derivedSection (MeSH-normalized terms), hasResults, resultsSection, documentSection. Use clinicaltrials_get_field_definitions to explore the schema."

Previous value: -[
-  "study"
-]New value: +[
+  "study",
+  "filtersApplied"
+]

Added value: +{
+  "default": 10,
+  "description": "Max locations to render in the formatted output. 0 = unlimited. Default 10. Pairs naturally with nearLocation for narrowing a large multi-site trial.",
+  "maximum": 500,
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "description": "Filter rendered locations to those within radius of (lat, lon) and sort by distance. Only locations with upstream coordinates are returned — most US sites carry them; international sites less reliably so. Use clinicaltrials_search_studies with geoFilter for upstream-side geographic filtering.",
+  "properties": {
+    "lat": {
+      "description": "Latitude in decimal degrees.",
+      "maximum": 90,
+      "minimum": -90,
+      "type": "number"
+    },
+    "lon": {
+      "description": "Longitude in decimal degrees.",
+      "maximum": 180,
+      "minimum": -180,
+      "type": "number"
+    },
+    "radiusMi": {
+      "default": 50,
+      "description": "Radius in miles. Default 50.",
+      "maximum": 500,
+      "minimum": 1,
+      "type": "number"
+    }
+  },
+  "required": [
+    "lat",
+    "lon"
+  ],
+  "type": "object"
+}

Added value: +{
+  "default": 5,
+  "description": "Max secondary and other outcomes to render in the formatted output. 0 = unlimited. Default 5. Primary outcomes always render in full.",
+  "maximum": 100,
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "description": "Echo of the locationLimit input; drives format() truncation.",
+  "maximum": 9007199254740991,
+  "minimum": -9007199254740991,
+  "type": "integer"
+}

Added value: +{
+  "additionalProperties": false,
+  "description": "Echo of the nearLocation input; drives format() geo filter.",
+  "properties": {
+    "lat": {
+      "description": "Latitude in decimal degrees.",
+      "type": "number"
+    },
+    "lon": {
+      "description": "Longitude in decimal degrees.",
+      "type": "number"
+    },
+    "radiusMi": {
+      "description": "Radius in miles.",
+      "type": "number"
+    }
+  },
+  "required": [
+    "lat",
+    "lon",
+    "radiusMi"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "Echo of the outcomeLimit input; drives format() truncation.",
+  "maximum": 9007199254740991,
+  "minimum": -9007199254740991,
+  "type": "integer"
+}

Previous value: -"Full study record."New value: +"Full study record. Top-level keys: protocolSection (identification, status, sponsor, conditions, design, arms/interventions, outcomes, eligibility, contacts/locations), derivedSection (MeSH-normalized terms), hasResults, resultsSection, documentSection. Use clinicaltrials_get_field_definitions to explore the schema."