KnowJudges

get_judge_profile

Read-only

Get one judge's public profile using the canonical profile URL from find_judges. Use for identity and assignments; use get_judge_biography for biography and get_courtroom_presentation_rules for practice. Preserve stated uncertainty: an assignment end date does not by itself end judicial service or establish a senior-status transition. Source check dates describe evidence checks; last_updated describes publication. Missing fields are unavailable information. Broader rules are not personal preferences.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`judge_url`	Yes	Canonical profile_url returned by find_judges

Output Schema

TableJSON Schema

Name	Required	Description	Default
`judge`	Yes
`sources`	Yes
`summary`	No
`findings`	Yes
`biography`	Yes
`scope_note`	No
`before_you_appear`	Yes
`biography_research`	Yes
`specialty_programs`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 12, 2026

changedOutput schema / properties / biography / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "aba_rating": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "age": {
-        "anyOf": [
-          {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "age_approximate": {
-        "anyOf": [
-          {
-            "type": "boolean"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "age_as_of": {
-        "type": "string"
-      },
-      "birth_place": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "chief_judge_service": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "commission_date": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "confirmation_date": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "date_of_birth": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "date_of_birth_granularity": {
-        "anyOf": [
-          {
-            "enum": [
-              "year",
-              "month",
-              "day"
-            ],
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "education": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "degree": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "degree_year": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "school": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "judicial_career": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "nomination_date": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "other_bio": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "other_federal_judicial_service": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "political_affiliations": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "endDate": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "party": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "source": {
-              "anyOf": [
-                {
-                  "enum": [
-                    "Ballot",
-                    "Appointer",
-                    "Other",
-                    "Unspecified"
-                  ],
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "startDate": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "professional_career": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "senate_vote": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "required": [
-      "date_of_birth",
-      "date_of_birth_granularity",
-      "age",
-      "age_as_of",
-      "age_approximate",
-      "birth_place",
-      "education",
-      "professional_career",
-      "other_bio",
-      "judicial_career",
-      "other_federal_judicial_service",
-      "nomination_date",
-      "confirmation_date",
-      "commission_date",
-      "senate_vote",
-      "aba_rating",
-      "chief_judge_service",
-      "political_affiliations"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "aba_rating": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "age": {
+        "anyOf": [
+          {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "age_approximate": {
+        "anyOf": [
+          {
+            "type": "boolean"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "age_as_of": {
+        "type": "string"
+      },
+      "birth_place": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "chief_judge_service": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "commission_date": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "confirmation_date": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "date_of_birth": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "date_of_birth_granularity": {
+        "anyOf": [
+          {
+            "enum": [
+              "year",
+              "month",
+              "day"
+            ],
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "education": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "degree": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "degree_year": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "school": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "education_notes": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "judicial_career": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "nomination_date": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "other_bio": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "other_federal_judicial_service": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "political_affiliations": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "endDate": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "party": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "source": {
+              "anyOf": [
+                {
+                  "enum": [
+                    "Ballot",
+                    "Appointer",
+                    "Other",
+                    "Unspecified"
+                  ],
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "startDate": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "professional_career": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "senate_vote": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "required": [
+      "date_of_birth",
+      "date_of_birth_granularity",
+      "age",
+      "age_as_of",
+      "age_approximate",
+      "birth_place",
+      "education",
+      "professional_career",
+      "other_bio",
+      "judicial_career",
+      "other_federal_judicial_service",
+      "nomination_date",
+      "confirmation_date",
+      "commission_date",
+      "senate_vote",
+      "aba_rating",
+      "chief_judge_service",
+      "political_affiliations"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / specialty_programs

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "coordinator": {
+        "type": "string"
+      },
+      "counties": {
+        "type": "string"
+      },
+      "email": {
+        "type": "string"
+      },
+      "hosts": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "knowjudges_url": {
+              "type": "string"
+            },
+            "name": {
+              "type": "string"
+            },
+            "relationship_status": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "knowjudges_url",
+            "relationship_status"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "judges": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "url": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "url"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "name": {
+        "type": "string"
+      },
+      "presiding_judge_names": {
+        "type": "string"
+      },
+      "source_date": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "source_url": {
+        "type": "string"
+      },
+      "type_codes": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "name",
+      "type_codes",
+      "counties",
+      "presiding_judge_names",
+      "coordinator",
+      "email",
+      "source_url",
+      "judges",
+      "hosts"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Changed3 schema fields changedOct 8, 2026

addedOutput schema / properties / findings / items / properties / applicability

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / properties / judge / properties / court_assignments / items / properties / assignment_type

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / properties / judge / properties / court_assignments / items / properties / identity_note

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

Changed65 schema fields changedOct 7, 2026

changedOutput schema / properties / biography / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "aba_rating": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "age": {
-        "anyOf": [
-          {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "age_approximate": {
-        "anyOf": [
-          {
-            "type": "boolean"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "age_as_of": {
-        "type": "string"
-      },
-      "birth_place": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "chief_judge_service": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "commission_date": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "confirmation_date": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "date_of_birth": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "date_of_birth_granularity": {
-        "anyOf": [
-          {
-            "enum": [
-              "year",
-              "month",
-              "day"
-            ],
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "education": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "degree": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "degree_year": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "school": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "school",
-            "degree",
-            "degree_year"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "judicial_career": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "nomination_date": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "other_bio": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "other_federal_judicial_service": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "political_affiliations": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "endDate": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "party": {
-              "type": "string"
-            },
-            "source": {
-              "enum": [
-                "Ballot",
-                "Appointer",
-                "Other",
-                "Unspecified"
-              ],
-              "type": "string"
-            },
-            "startDate": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            }
-          },
-          "required": [
-            "party",
-            "source",
-            "startDate",
-            "endDate"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "professional_career": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "senate_vote": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "required": [
-      "date_of_birth",
-      "date_of_birth_granularity",
-      "age",
-      "age_as_of",
-      "age_approximate",
-      "birth_place",
-      "education",
-      "professional_career",
-      "other_bio",
-      "judicial_career",
-      "other_federal_judicial_service",
-      "nomination_date",
-      "confirmation_date",
-      "commission_date",
-      "senate_vote",
-      "aba_rating",
-      "chief_judge_service",
-      "political_affiliations"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "aba_rating": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "age": {
+        "anyOf": [
+          {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "age_approximate": {
+        "anyOf": [
+          {
+            "type": "boolean"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "age_as_of": {
+        "type": "string"
+      },
+      "birth_place": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "chief_judge_service": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "commission_date": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "confirmation_date": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "date_of_birth": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "date_of_birth_granularity": {
+        "anyOf": [
+          {
+            "enum": [
+              "year",
+              "month",
+              "day"
+            ],
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "education": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "degree": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "degree_year": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "school": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "judicial_career": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "nomination_date": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "other_bio": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "other_federal_judicial_service": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "political_affiliations": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "endDate": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "party": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "source": {
+              "anyOf": [
+                {
+                  "enum": [
+                    "Ballot",
+                    "Appointer",
+                    "Other",
+                    "Unspecified"
+                  ],
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "startDate": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "professional_career": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "senate_vote": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "required": [
+      "date_of_birth",
+      "date_of_birth_granularity",
+      "age",
+      "age_as_of",
+      "age_approximate",
+      "birth_place",
+      "education",
+      "professional_career",
+      "other_bio",
+      "judicial_career",
+      "other_federal_judicial_service",
+      "nomination_date",
+      "confirmation_date",
+      "commission_date",
+      "senate_vote",
+      "aba_rating",
+      "chief_judge_service",
+      "political_affiliations"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / biography_research / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "evidence": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "field": {
-              "type": "string"
-            },
-            "source_url": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "supporting_quote": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            }
-          },
-          "required": [
-            "field",
-            "source_url",
-            "supporting_quote"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "last_checked": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "sources": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "official": {
-              "type": "boolean"
-            },
-            "published_at": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "publisher": {
-              "type": "string"
-            },
-            "retrieved_at": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "title": {
-              "type": "string"
-            },
-            "url": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "url",
-            "title",
-            "publisher",
-            "published_at",
-            "official"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "sources",
-      "evidence"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "evidence": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "field": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "source_url": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "supporting_quote": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "last_checked": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "sources": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "official": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "published_at": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "publisher": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "retrieved_at": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "title": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "url": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "sources",
+      "evidence"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / findings / items / properties / category / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / findings / items / properties / category / type
```
Removed value: -"string"
```

addedOutput schema / properties / findings / items / properties / evidence_excerpt / anyOf

Added value: +[
+  {
+    "maxLength": 800,
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / findings / items / properties / evidence_excerpt / maxLength
```
Removed value: -800
```
removedOutput schema / properties / findings / items / properties / evidence_excerpt / type
```
Removed value: -"string"
```

addedOutput schema / properties / findings / items / properties / posture / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / findings / items / properties / posture / type
```
Removed value: -"string"
```
addedOutput schema / properties / findings / items / properties / proceeding_stage / anyOf
```
Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / findings / items / properties / proceeding_stage / type
```
Removed value: -"string"
```

addedOutput schema / properties / findings / items / properties / scope / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / findings / items / properties / scope / type
```
Removed value: -"string"
```

addedOutput schema / properties / findings / items / properties / summary / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / findings / items / properties / summary / type
```
Removed value: -"string"
```

addedOutput schema / properties / findings / items / properties / topic / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / findings / items / properties / topic / type
```
Removed value: -"string"
```

removedOutput schema / properties / findings / items / required

Removed value: -[
-  "topic",
-  "category",
-  "summary",
-  "posture",
-  "scope",
-  "proceeding_stage",
-  "source_url",
-  "source_title",
-  "evidence_excerpt",
-  "source_page",
-  "source_section",
-  "effective_date"
-]

addedOutput schema / properties / judge / properties / canonical_name / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / judge / properties / canonical_name / type
```
Removed value: -"string"
```

addedOutput schema / properties / judge / properties / court / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / judge / properties / court / type
```
Removed value: -"string"
```
addedOutput schema / properties / judge / properties / court_assignments / items / properties / court / anyOf
```
Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / judge / properties / court_assignments / items / properties / court / type
```
Removed value: -"string"
```
addedOutput schema / properties / judge / properties / court_assignments / items / properties / court_level / anyOf
```
Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / judge / properties / court_assignments / items / properties / court_level / type
```
Removed value: -"string"
```
addedOutput schema / properties / judge / properties / court_assignments / items / properties / judicial_role / anyOf
```
Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / judge / properties / court_assignments / items / properties / judicial_role / type
```
Removed value: -"string"
```
addedOutput schema / properties / judge / properties / court_assignments / items / properties / jurisdiction_type / anyOf
```
Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / judge / properties / court_assignments / items / properties / jurisdiction_type / type
```
Removed value: -"string"
```
addedOutput schema / properties / judge / properties / court_assignments / items / properties / service_status / anyOf
```
Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / judge / properties / court_assignments / items / properties / service_status / type
```
Removed value: -"string"
```

removedOutput schema / properties / judge / properties / court_assignments / items / required

Removed value: -[
-  "court",
-  "court_level",
-  "judicial_role",
-  "county",
-  "service_status"
-]

addedOutput schema / properties / judge / properties / court_level / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / judge / properties / court_level / type
```
Removed value: -"string"
```

addedOutput schema / properties / judge / properties / judicial_role / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / judge / properties / judicial_role / type
```
Removed value: -"string"
```
addedOutput schema / properties / judge / properties / judicial_services / items / properties / judicial_role / anyOf
```
Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / judge / properties / judicial_services / items / properties / judicial_role / type
```
Removed value: -"string"
```
addedOutput schema / properties / judge / properties / judicial_services / items / properties / service_status / anyOf
```
Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / judge / properties / judicial_services / items / properties / service_status / type
```
Removed value: -"string"
```

removedOutput schema / properties / judge / properties / judicial_services / items / required

Removed value: -[
-  "judicial_role",
-  "service_status",
-  "active_from",
-  "active_to"
-]

addedOutput schema / properties / judge / properties / jurisdiction_type / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / judge / properties / jurisdiction_type / type
```
Removed value: -"string"
```

addedOutput schema / properties / judge / properties / official_profile_url / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / judge / properties / official_profile_url / type
```
Removed value: -"string"
```

addedOutput schema / properties / judge / properties / presentation_posture / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / judge / properties / presentation_posture / type
```
Removed value: -"string"
```

addedOutput schema / properties / judge / properties / service_status / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / judge / properties / service_status / type
```
Removed value: -"string"
```

addedOutput schema / properties / judge / properties / source_authority / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / judge / properties / source_authority / type
```
Removed value: -"string"
```

addedOutput schema / properties / judge / properties / state / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / judge / properties / state / type
```
Removed value: -"string"
```

changedOutput schema / properties / judge / required

Previous value: -[
-  "name",
-  "canonical_name",
-  "state",
-  "county",
-  "court",
-  "court_level",
-  "jurisdiction_type",
-  "judicial_role",
-  "service_status",
-  "judicial_services",
-  "court_assignments",
-  "official_profile_url",
-  "source_authority",
-  "presentation_posture",
-  "profile_url"
-]New value: +[
+  "name",
+  "judicial_services",
+  "court_assignments",
+  "profile_url"
+]

addedOutput schema / properties / sources / items / properties / issuing_court / anyOf
```
Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / sources / items / properties / issuing_court / type
```
Removed value: -"string"
```

addedOutput schema / properties / sources / items / properties / scope / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / sources / items / properties / scope / type
```
Removed value: -"string"
```

addedOutput schema / properties / sources / items / properties / title / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / sources / items / properties / title / type
```
Removed value: -"string"
```

addedOutput schema / properties / sources / items / properties / url / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / sources / items / properties / url / type
```
Removed value: -"string"
```

changedOutput schema / properties / sources / items / required

Previous value: -[
-  "url",
-  "title",
-  "issuing_court",
-  "scope",
-  "publication_date",
-  "effective_date"
-]New value: +[
+  "publication_date",
+  "effective_date"
+]

changedOutput schema / required

Previous value: -[
-  "judge",
-  "summary",
-  "scope_note",
-  "before_you_appear",
-  "biography",
-  "biography_research",
-  "findings",
-  "sources"
-]New value: +[
+  "judge",
+  "before_you_appear",
+  "biography",
+  "biography_research",
+  "findings",
+  "sources"
+]

Changed11 schema fields changedOct 7, 2026

changedOutput schema / properties / biography_research / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "evidence": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "confidence": {
-              "type": "string"
-            },
-            "field": {
-              "type": "string"
-            },
-            "source_url": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "supporting_quote": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "verification_status": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "field",
-            "source_url",
-            "verification_status",
-            "confidence",
-            "supporting_quote"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "fields_found": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "fields_not_publicly_found": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "fields_pending": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "sources": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "official": {
-              "type": "boolean"
-            },
-            "published_at": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "publisher": {
-              "type": "string"
-            },
-            "source_type": {
-              "type": "string"
-            },
-            "title": {
-              "type": "string"
-            },
-            "url": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "url",
-            "title",
-            "publisher",
-            "source_type",
-            "published_at",
-            "official"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "status": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "fields_found",
-      "fields_not_publicly_found",
-      "fields_pending",
-      "sources",
-      "evidence"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "evidence": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "field": {
+              "type": "string"
+            },
+            "source_url": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "supporting_quote": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "field",
+            "source_url",
+            "supporting_quote"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "last_checked": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "sources": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "official": {
+              "type": "boolean"
+            },
+            "published_at": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "publisher": {
+              "type": "string"
+            },
+            "retrieved_at": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "title": {
+              "type": "string"
+            },
+            "url": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "url",
+            "title",
+            "publisher",
+            "published_at",
+            "official"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "sources",
+      "evidence"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / findings / items / properties / confidence_reason
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / properties / findings / items / properties / evidence_type
```
Removed value: -{
-  "type": "string"
-}
```

addedOutput schema / properties / findings / items / properties / last_verified

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

removedOutput schema / properties / findings / items / properties / verification_status
```
Removed value: -{
-  "type": "string"
-}
```

changedOutput schema / properties / findings / items / required

Previous value: -[
-  "topic",
-  "category",
-  "summary",
-  "posture",
-  "scope",
-  "proceeding_stage",
-  "evidence_type",
-  "source_url",
-  "source_title",
-  "evidence_excerpt",
-  "source_page",
-  "source_section",
-  "effective_date",
-  "verification_status",
-  "confidence_reason"
-]New value: +[
+  "topic",
+  "category",
+  "summary",
+  "posture",
+  "scope",
+  "proceeding_stage",
+  "source_url",
+  "source_title",
+  "evidence_excerpt",
+  "source_page",
+  "source_section",
+  "effective_date"
+]

removedOutput schema / properties / judge / properties / human_reviewed
```
Removed value: -{
-  "type": "boolean"
-}
```

changedOutput schema / properties / judge / required

Previous value: -[
-  "name",
-  "canonical_name",
-  "state",
-  "county",
-  "court",
-  "court_level",
-  "jurisdiction_type",
-  "judicial_role",
-  "service_status",
-  "judicial_services",
-  "court_assignments",
-  "official_profile_url",
-  "source_authority",
-  "presentation_posture",
-  "human_reviewed",
-  "profile_url"
-]New value: +[
+  "name",
+  "canonical_name",
+  "state",
+  "county",
+  "court",
+  "court_level",
+  "jurisdiction_type",
+  "judicial_role",
+  "service_status",
+  "judicial_services",
+  "court_assignments",
+  "official_profile_url",
+  "source_authority",
+  "presentation_posture",
+  "profile_url"
+]

addedOutput schema / properties / sources / items / properties / last_verified

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

removedOutput schema / properties / sources / items / properties / status
```
Removed value: -{
-  "type": "string"
-}
```

changedOutput schema / properties / sources / items / required

Previous value: -[
-  "url",
-  "title",
-  "issuing_court",
-  "scope",
-  "status",
-  "publication_date",
-  "effective_date"
-]New value: +[
+  "url",
+  "title",
+  "issuing_court",
+  "scope",
+  "publication_date",
+  "effective_date"
+]

Changed8 schema fields changedOct 7, 2026

changedOutput schema / properties / biography_research / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "evidence": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "confidence": {
-              "type": "string"
-            },
-            "field": {
-              "type": "string"
-            },
-            "source_url": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "supporting_quote": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "verification_status": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "field",
-            "source_url",
-            "verification_status",
-            "confidence",
-            "supporting_quote"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "fields_found": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "fields_not_publicly_found": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "fields_pending": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "last_checked": {
-        "type": "string"
-      },
-      "sources": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "official": {
-              "type": "boolean"
-            },
-            "published_at": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "publisher": {
-              "type": "string"
-            },
-            "retrieved_at": {
-              "type": "string"
-            },
-            "source_type": {
-              "type": "string"
-            },
-            "title": {
-              "type": "string"
-            },
-            "url": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "url",
-            "title",
-            "publisher",
-            "source_type",
-            "retrieved_at",
-            "published_at",
-            "official"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "status": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "fields_found",
-      "fields_not_publicly_found",
-      "fields_pending",
-      "last_checked",
-      "sources",
-      "evidence"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "evidence": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "confidence": {
+              "type": "string"
+            },
+            "field": {
+              "type": "string"
+            },
+            "source_url": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "supporting_quote": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "verification_status": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "field",
+            "source_url",
+            "verification_status",
+            "confidence",
+            "supporting_quote"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "fields_found": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "fields_not_publicly_found": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "fields_pending": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "sources": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "official": {
+              "type": "boolean"
+            },
+            "published_at": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "publisher": {
+              "type": "string"
+            },
+            "source_type": {
+              "type": "string"
+            },
+            "title": {
+              "type": "string"
+            },
+            "url": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "url",
+            "title",
+            "publisher",
+            "source_type",
+            "published_at",
+            "official"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "status": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "fields_found",
+      "fields_not_publicly_found",
+      "fields_pending",
+      "sources",
+      "evidence"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / findings / items / properties / last_verified

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ]
-}

changedOutput schema / properties / findings / items / required

Previous value: -[
-  "topic",
-  "category",
-  "summary",
-  "posture",
-  "scope",
-  "proceeding_stage",
-  "evidence_type",
-  "source_url",
-  "source_title",
-  "evidence_excerpt",
-  "source_page",
-  "source_section",
-  "effective_date",
-  "last_verified",
-  "verification_status",
-  "confidence_reason"
-]New value: +[
+  "topic",
+  "category",
+  "summary",
+  "posture",
+  "scope",
+  "proceeding_stage",
+  "evidence_type",
+  "source_url",
+  "source_title",
+  "evidence_excerpt",
+  "source_page",
+  "source_section",
+  "effective_date",
+  "verification_status",
+  "confidence_reason"
+]

addedOutput schema / properties / judge / properties / last_updated

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

removedOutput schema / properties / judge / properties / last_verified
```
Removed value: -{
-  "type": "string"
-}
```

changedOutput schema / properties / judge / required

Previous value: -[
-  "name",
-  "canonical_name",
-  "state",
-  "county",
-  "court",
-  "court_level",
-  "jurisdiction_type",
-  "judicial_role",
-  "service_status",
-  "judicial_services",
-  "court_assignments",
-  "official_profile_url",
-  "source_authority",
-  "last_verified",
-  "presentation_posture",
-  "human_reviewed",
-  "profile_url"
-]New value: +[
+  "name",
+  "canonical_name",
+  "state",
+  "county",
+  "court",
+  "court_level",
+  "jurisdiction_type",
+  "judicial_role",
+  "service_status",
+  "judicial_services",
+  "court_assignments",
+  "official_profile_url",
+  "source_authority",
+  "presentation_posture",
+  "human_reviewed",
+  "profile_url"
+]

removedOutput schema / properties / sources / items / properties / last_verified
```
Removed value: -{
-  "type": "string"
-}
```

changedOutput schema / properties / sources / items / required

Previous value: -[
-  "url",
-  "title",
-  "issuing_court",
-  "scope",
-  "status",
-  "publication_date",
-  "effective_date",
-  "last_verified"
-]New value: +[
+  "url",
+  "title",
+  "issuing_court",
+  "scope",
+  "status",
+  "publication_date",
+  "effective_date"
+]

Changed3 schema fields changedOct 7, 2026

removedInput schema / properties / judge_slug

Removed value: -{
-  "description": "Legacy judge identifier; prefer judge_url",
-  "minLength": 1,
-  "type": "string"
-}

addedInput schema / properties / judge_url / format
```
Added value: +"uri"
```
addedInput schema / required
```
Added value: +[
+  "judge_url"
+]
```

Changed18 schema fields changedOct 7, 2026

changedInput schema / properties / judge_slug / description

Previous value: -"Canonical slug returned by find_judges"New value: +"Legacy judge identifier; prefer judge_url"

addedInput schema / properties / judge_url

Added value: +{
+  "description": "Canonical profile_url returned by find_judges",
+  "type": "string"
+}

removedInput schema / required
```
Removed value: -[
-  "judge_slug"
-]
```

changedOutput schema / properties / biography_research / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "evidence": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "confidence": {
-              "type": "string"
-            },
-            "field": {
-              "type": "string"
-            },
-            "match_method": {
-              "type": "string"
-            },
-            "parser_version": {
-              "type": "string"
-            },
-            "source_id": {
-              "type": "string"
-            },
-            "supporting_quote": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "verification_status": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "field",
-            "source_id",
-            "verification_status",
-            "confidence",
-            "match_method",
-            "parser_version",
-            "supporting_quote"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "fields_found": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "fields_not_publicly_found": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "fields_pending": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "last_checked": {
-        "type": "string"
-      },
-      "sensitive_field_policy": {
-        "const": "explicit_source_only",
-        "type": "string"
-      },
-      "sources": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "content_hash": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "id": {
-              "type": "string"
-            },
-            "official": {
-              "type": "boolean"
-            },
-            "published_at": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "publisher": {
-              "type": "string"
-            },
-            "retrieved_at": {
-              "type": "string"
-            },
-            "source_type": {
-              "type": "string"
-            },
-            "title": {
-              "type": "string"
-            },
-            "url": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "id",
-            "url",
-            "title",
-            "publisher",
-            "source_type",
-            "retrieved_at",
-            "published_at",
-            "content_hash",
-            "official"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "status": {
-        "enum": [
-          "complete",
-          "partial",
-          "identity_only",
-          "not_publicly_found",
-          "manual_review"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "fields_found",
-      "fields_not_publicly_found",
-      "fields_pending",
-      "last_checked",
-      "sensitive_field_policy",
-      "sources",
-      "evidence"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "evidence": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "confidence": {
+              "type": "string"
+            },
+            "field": {
+              "type": "string"
+            },
+            "source_url": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "supporting_quote": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "verification_status": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "field",
+            "source_url",
+            "verification_status",
+            "confidence",
+            "supporting_quote"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "fields_found": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "fields_not_publicly_found": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "fields_pending": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "last_checked": {
+        "type": "string"
+      },
+      "sources": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "official": {
+              "type": "boolean"
+            },
+            "published_at": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "publisher": {
+              "type": "string"
+            },
+            "retrieved_at": {
+              "type": "string"
+            },
+            "source_type": {
+              "type": "string"
+            },
+            "title": {
+              "type": "string"
+            },
+            "url": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "url",
+            "title",
+            "publisher",
+            "source_type",
+            "retrieved_at",
+            "published_at",
+            "official"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "status": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "fields_found",
+      "fields_not_publicly_found",
+      "fields_pending",
+      "last_checked",
+      "sources",
+      "evidence"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / judge / properties / court_assignments / items / properties / assignment_id
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / properties / judge / properties / court_assignments / items / properties / court_id
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / properties / judge / properties / court_assignments / items / properties / service_id
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / properties / judge / properties / court_assignments / items / properties / source_line
```
Removed value: -{
-  "type": "number"
-}
```

removedOutput schema / properties / judge / properties / court_assignments / items / properties / source_record_id

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ]
-}

changedOutput schema / properties / judge / properties / court_assignments / items / required

Previous value: -[
-  "court_id",
-  "court",
-  "court_level",
-  "judicial_role",
-  "county",
-  "service_status"
-]New value: +[
+  "court",
+  "court_level",
+  "judicial_role",
+  "county",
+  "service_status"
+]

removedOutput schema / properties / judge / properties / court_id
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / properties / judge / properties / judicial_services / items / properties / person_id
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / properties / judge / properties / judicial_services / items / properties / service_id
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / properties / judge / properties / judicial_services / items / properties / source_record_ids
```
Removed value: -{
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}
```

changedOutput schema / properties / judge / properties / judicial_services / items / required

Previous value: -[
-  "service_id",
-  "person_id",
-  "judicial_role",
-  "service_status",
-  "active_from",
-  "active_to",
-  "source_record_ids"
-]New value: +[
+  "judicial_role",
+  "service_status",
+  "active_from",
+  "active_to"
+]

removedOutput schema / properties / judge / properties / profile_tier
```
Removed value: -{
-  "type": "string"
-}
```
removedOutput schema / properties / judge / properties / slug
```
Removed value: -{
-  "type": "string"
-}
```

changedOutput schema / properties / judge / required

Previous value: -[
-  "slug",
-  "name",
-  "canonical_name",
-  "state",
-  "county",
-  "court_id",
-  "court",
-  "court_level",
-  "jurisdiction_type",
-  "judicial_role",
-  "service_status",
-  "judicial_services",
-  "court_assignments",
-  "official_profile_url",
-  "source_authority",
-  "last_verified",
-  "presentation_posture",
-  "profile_tier",
-  "human_reviewed",
-  "profile_url"
-]New value: +[
+  "name",
+  "canonical_name",
+  "state",
+  "county",
+  "court",
+  "court_level",
+  "jurisdiction_type",
+  "judicial_role",
+  "service_status",
+  "judicial_services",
+  "court_assignments",
+  "official_profile_url",
+  "source_authority",
+  "last_verified",
+  "presentation_posture",
+  "human_reviewed",
+  "profile_url"
+]

Changed1 schema field changedOct 7, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false,
+  "properties": {
+    "before_you_appear": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "biography": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "aba_rating": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "age": {
+              "anyOf": [
+                {
+                  "maximum": 9007199254740991,
+                  "minimum": -9007199254740991,
+                  "type": "integer"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "age_approximate": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "age_as_of": {
+              "type": "string"
+            },
+            "birth_place": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "chief_judge_service": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "commission_date": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "confirmation_date": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "date_of_birth": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "date_of_birth_granularity": {
+              "anyOf": [
+                {
+                  "enum": [
+                    "year",
+                    "month",
+                    "day"
+                  ],
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "education": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "degree": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "degree_year": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "school": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "school",
+                  "degree",
+                  "degree_year"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "judicial_career": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "nomination_date": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "other_bio": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "other_federal_judicial_service": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "political_affiliations": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "endDate": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "party": {
+                    "type": "string"
+                  },
+                  "source": {
+                    "enum": [
+                      "Ballot",
+                      "Appointer",
+                      "Other",
+                      "Unspecified"
+                    ],
+                    "type": "string"
+                  },
+                  "startDate": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "party",
+                  "source",
+                  "startDate",
+                  "endDate"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "professional_career": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "senate_vote": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "date_of_birth",
+            "date_of_birth_granularity",
+            "age",
+            "age_as_of",
+            "age_approximate",
+            "birth_place",
+            "education",
+            "professional_career",
+            "other_bio",
+            "judicial_career",
+            "other_federal_judicial_service",
+            "nomination_date",
+            "confirmation_date",
+            "commission_date",
+            "senate_vote",
+            "aba_rating",
+            "chief_judge_service",
+            "political_affiliations"
+          ],
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "biography_research": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "evidence": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "confidence": {
+                    "type": "string"
+                  },
+                  "field": {
+                    "type": "string"
+                  },
+                  "match_method": {
+                    "type": "string"
+                  },
+                  "parser_version": {
+                    "type": "string"
+                  },
+                  "source_id": {
+                    "type": "string"
+                  },
+                  "supporting_quote": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "verification_status": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "field",
+                  "source_id",
+                  "verification_status",
+                  "confidence",
+                  "match_method",
+                  "parser_version",
+                  "supporting_quote"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "fields_found": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "fields_not_publicly_found": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "fields_pending": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "last_checked": {
+              "type": "string"
+            },
+            "sensitive_field_policy": {
+              "const": "explicit_source_only",
+              "type": "string"
+            },
+            "sources": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "content_hash": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "official": {
+                    "type": "boolean"
+                  },
+                  "published_at": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "publisher": {
+                    "type": "string"
+                  },
+                  "retrieved_at": {
+                    "type": "string"
+                  },
+                  "source_type": {
+                    "type": "string"
+                  },
+                  "title": {
+                    "type": "string"
+                  },
+                  "url": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "id",
+                  "url",
+                  "title",
+                  "publisher",
+                  "source_type",
+                  "retrieved_at",
+                  "published_at",
+                  "content_hash",
+                  "official"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "status": {
+              "enum": [
+                "complete",
+                "partial",
+                "identity_only",
+                "not_publicly_found",
+                "manual_review"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "status",
+            "fields_found",
+            "fields_not_publicly_found",
+            "fields_pending",
+            "last_checked",
+            "sensitive_field_policy",
+            "sources",
+            "evidence"
+          ],
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "findings": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "category": {
+            "type": "string"
+          },
+          "confidence_reason": {
+            "type": "string"
+          },
+          "effective_date": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "evidence_excerpt": {
+            "maxLength": 800,
+            "type": "string"
+          },
+          "evidence_type": {
+            "type": "string"
+          },
+          "last_verified": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "posture": {
+            "type": "string"
+          },
+          "proceeding_stage": {
+            "type": "string"
+          },
+          "scope": {
+            "type": "string"
+          },
+          "source_page": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "source_section": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "source_title": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "source_url": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "summary": {
+            "type": "string"
+          },
+          "topic": {
+            "type": "string"
+          },
+          "verification_status": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "topic",
+          "category",
+          "summary",
+          "posture",
+          "scope",
+          "proceeding_stage",
+          "evidence_type",
+          "source_url",
+          "source_title",
+          "evidence_excerpt",
+          "source_page",
+          "source_section",
+          "effective_date",
+          "last_verified",
+          "verification_status",
+          "confidence_reason"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "judge": {
+      "additionalProperties": false,
+      "properties": {
+        "canonical_name": {
+          "type": "string"
+        },
+        "county": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "court": {
+          "type": "string"
+        },
+        "court_assignments": {
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "assignment_end": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "assignment_id": {
+                "type": "string"
+              },
+              "assignment_start": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "county": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "court": {
+                "type": "string"
+              },
+              "court_id": {
+                "type": "string"
+              },
+              "court_level": {
+                "type": "string"
+              },
+              "judicial_role": {
+                "type": "string"
+              },
+              "jurisdiction_type": {
+                "type": "string"
+              },
+              "service_id": {
+                "type": "string"
+              },
+              "service_status": {
+                "type": "string"
+              },
+              "source_line": {
+                "type": "number"
+              },
+              "source_record_id": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "source_url": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
+            "required": [
+              "court_id",
+              "court",
+              "court_level",
+              "judicial_role",
+              "county",
+              "service_status"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "court_id": {
+          "type": "string"
+        },
+        "court_level": {
+          "type": "string"
+        },
+        "human_reviewed": {
+          "type": "boolean"
+        },
+        "judicial_role": {
+          "type": "string"
+        },
+        "judicial_services": {
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "active_from": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "active_to": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "judicial_role": {
+                "type": "string"
+              },
+              "person_id": {
+                "type": "string"
+              },
+              "service_id": {
+                "type": "string"
+              },
+              "service_status": {
+                "type": "string"
+              },
+              "source_record_ids": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              }
+            },
+            "required": [
+              "service_id",
+              "person_id",
+              "judicial_role",
+              "service_status",
+              "active_from",
+              "active_to",
+              "source_record_ids"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "jurisdiction_type": {
+          "type": "string"
+        },
+        "last_verified": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        },
+        "official_profile_url": {
+          "type": "string"
+        },
+        "presentation_posture": {
+          "type": "string"
+        },
+        "profile_tier": {
+          "type": "string"
+        },
+        "profile_url": {
+          "type": "string"
+        },
+        "service_status": {
+          "type": "string"
+        },
+        "slug": {
+          "type": "string"
+        },
+        "source_authority": {
+          "type": "string"
+        },
+        "state": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "slug",
+        "name",
+        "canonical_name",
+        "state",
+        "county",
+        "court_id",
+        "court",
+        "court_level",
+        "jurisdiction_type",
+        "judicial_role",
+        "service_status",
+        "judicial_services",
+        "court_assignments",
+        "official_profile_url",
+        "source_authority",
+        "last_verified",
+        "presentation_posture",
+        "profile_tier",
+        "human_reviewed",
+        "profile_url"
+      ],
+      "type": "object"
+    },
+    "scope_note": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "sources": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "effective_date": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "issuing_court": {
+            "type": "string"
+          },
+          "last_verified": {
+            "type": "string"
+          },
+          "publication_date": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "scope": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          },
+          "url": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "url",
+          "title",
+          "issuing_court",
+          "scope",
+          "status",
+          "publication_date",
+          "effective_date",
+          "last_verified"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "summary": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "required": [
+    "judge",
+    "summary",
+    "scope_note",
+    "before_you_appear",
+    "biography",
+    "biography_research",
+    "findings",
+    "sources"
+  ],
+  "type": "object"
+}

First observedAug 17, 2026

TDQS

A4.3/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true and destructiveHint=false, so safety is covered. The description adds real interpretive context beyond that: how to read assignment end dates, the distinction between source check dates and last_updated, and that missing fields mean unavailable data. It does not describe pagination or response shape, but with an output schema present that is acceptable.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loads purpose and routing in the first sentence, then appends interpretation caveats. The caveat sentences are dense and slightly list-like but each carries a distinct semantic warning; nothing is redundant with the schema or annotations.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need no explanation, and annotations carry the safety profile. The description covers the one thing structured fields cannot: how to interpret uncertainty in dates and missing fields. Slightly complete enough, though it says nothing about what happens if the URL is stale or invalid.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% and the single required param is documented as 'Canonical profile_url returned by find_judges'. The description reinforces that origin but adds no format or validation detail, so the baseline 3 is correct.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Get one judge's public profile') and anchors the input to its source ('canonical profile URL from find_judges'). It explicitly distinguishes itself from get_judge_biography and get_courtroom_presentation_rules, so an agent can route without opening schemas.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit when-to-use ('identity and assignments') and names the two sibling alternatives with their respective scopes (biography, practice rules). The only remaining ambiguity is that the alternatives are not conditioned on a scenario, but the split is clear.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All KnowJudges tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

get_judge_profile

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources