Skip to main content
Glama

get_judge_biography

Read-only

Get one judge's source-attributed birth details, education, and professional and judicial careers using the canonical profile URL from find_judges. Use for biographical questions rather than courtroom practice. Preserves date granularity, provenance, and source check dates; age is returned only for a valid full date of birth, otherwise null. Missing biography fields mean unavailable information, not a failed lookup.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
judge_urlYesCanonical profile_url returned by find_judges

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
judgeYes
caveatYes
researchYes
biographyYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • 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"
      +  }
      +]
  2. Changed5 schema fields changed
    • 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"
      +  }
      +]
    • addedOutput schema / properties / judge / properties / court / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / properties / judge / properties / court / type
      Removed value: -"string"
    • changedOutput schema / properties / judge / required
      Previous value: -[
      -  "name",
      -  "court",
      -  "profile_url"
      -]New value: +[
      +  "name",
      +  "profile_url"
      +]
    • changedOutput schema / properties / 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"
      +  }
      +]
  3. Changed1 schema field changed
    • changedOutput schema / properties / 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"
      +  }
      +]
  4. Changed2 schema fields changed
    • addedOutput schema / properties / judge / properties / last_updated
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • changedOutput schema / properties / 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"
      +  }
      +]
  5. Changed3 schema fields changed
    • 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"
      +]
  6. Changed6 schema fields changed
    • 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"
      -]
    • removedOutput schema / properties / judge / properties / slug
      Removed value: -{
      -  "type": "string"
      -}
    • changedOutput schema / properties / judge / required
      Previous value: -[
      -  "slug",
      -  "name",
      -  "court",
      -  "profile_url"
      -]New value: +[
      +  "name",
      +  "court",
      +  "profile_url"
      +]
    • changedOutput schema / properties / 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"
      +  }
      +]
  7. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "https://json-schema.org/draft/2020-12/schema",
      +  "additionalProperties": false,
      +  "properties": {
      +    "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"
      +        }
      +      ]
      +    },
      +    "caveat": {
      +      "type": "string"
      +    },
      +    "judge": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "court": {
      +          "type": "string"
      +        },
      +        "name": {
      +          "type": "string"
      +        },
      +        "profile_url": {
      +          "type": "string"
      +        },
      +        "slug": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "slug",
      +        "name",
      +        "court",
      +        "profile_url"
      +      ],
      +      "type": "object"
      +    },
      +    "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"
      +        }
      +      ]
      +    }
      +  },
      +  "required": [
      +    "judge",
      +    "biography",
      +    "research",
      +    "caveat"
      +  ],
      +  "type": "object"
      +}
  8. First observed

TDQS

A4.5/5.0
Behavior5/5

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

Beyond the readOnlyHint/destructiveHint annotations, it discloses real behavioral traits: date granularity and provenance are preserved, source check dates are included, age is non-null only for a valid full DOB, and absent fields signal unavailable data rather than a failed lookup. That last point directly shapes how an agent should interpret partial results.

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

Conciseness5/5

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

Front-loaded with the purpose, then usage guidance, then result semantics, in compact sentences with no filler. Every clause carries information an agent needs.

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

Completeness5/5

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

With an output schema present, the description is not obliged to document return structure, yet it still clarifies the nullable age and missing-field semantics. Nothing needed to select or call this single-parameter read tool is missing.

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 coverage is 100% and the single parameter is already documented as the canonical profile_url from find_judges. The description's 'canonical profile URL from find_judges' phrasing reinforces but does not extend the schema, so the baseline 3 applies.

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+resource (get one judge's biography) and enumerates the covered content: source-attributed birth details, education, professional and judicial careers. This clearly separates it from find_judges, which supplies the URL, and from courtroom-practice siblings.

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

Usage Guidelines4/5

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

'Use for biographical questions rather than courtroom practice' gives an explicit use condition and an implicit exclusion, and it pins the required input to find_judges output. It stops short of naming the closest sibling (get_judge_profile) as an alternative, so routing between the two is still left to inference.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.