ESQ Matching Engine

Compare lawyers side by side

compare_attorneys

Read-onlyIdempotent

Use when the person asks to compare lawyers from search_attorneys. Compares 2 to 5 lawyers on practice areas, location, years licensed, fees, availability, data confidence and gaps, side by side in the order given, with no scores and without picking one. Pass match_id to use the person's filters. Says when prices or timing cannot be compared because the data is unknown. This is a listing service, not a lawyer referral service. No lawyer pays for placement or ranking of any kind.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "attorney_ids": "<attorney_ids>"
    },
    "name": "compare_attorneys"
  }
}

Input Schema

Name	Required	Description
`criteria`	No
`match_id`	No	The match_id from search_attorneys, so comparisons use the same filters
`priorities`	No	Ignored since 2026-11-05: lawyers are shown side by side in the order given, with no scores.
`attorney_ids`	Yes

Output Schema

Name	Required	Description	Default
`note`	Yes
`order`	Yes
`attorneys`	Yes
`api_version`	Yes
`differences`	Yes
`listing_notice`	Yes
`verification_gaps`	Yes
`criteria_from_match`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed6 schema fields changedNov 5, 2026

changedInput schema / properties / priorities / description

Previous value: -"What matters most, in order. Shifts ranking weights."New value: +"Ignored since 2026-11-05: lawyers are shown side by side in the order given, with no scores."

changedOutput schema / properties / attorneys / anyOf

Previous value: -[
-  {
-    "items": {
-      "anyOf": [
-        {
-          "additionalProperties": {},
-          "properties": {
-            "attorney_id": {
-              "x-observed-types": [
-                "string",
-                "null"
-              ]
-            },
-            "attribution": {
-              "anyOf": [
-                {
-                  "additionalProperties": {},
-                  "properties": {
-                    "data_confidence": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "match_id": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "official_license_source": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "official_license_source_url": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "profile_url": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "schema_version": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "source_checked_at": {
-                      "x-observed-types": "null"
-                    },
-                    "source_copied_at": {
-                      "x-observed-types": [
-                        "null",
-                        "string"
-                      ]
-                    },
-                    "source_home_url": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "source_name": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "suggested_citation": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    }
-                  },
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "data_confidence": {
-              "anyOf": [
-                {
-                  "additionalProperties": {},
-                  "properties": {
-                    "evidence_coverage_percent": {
-                      "x-observed-types": [
-                        "number",
-                        "null"
-                      ]
-                    },
-                    "known": {
-                      "anyOf": [
-                        {
-                          "items": {
-                            "x-observed-types": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "type": "array"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    },
-                    "level": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "limits": {
-                      "anyOf": [
-                        {
-                          "items": {
-                            "x-observed-types": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "type": "array"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    },
-                    "note": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "unknown": {
-                      "anyOf": [
-                        {
-                          "items": {
-                            "x-observed-types": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "type": "array"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    }
-                  },
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "fees": {
-              "anyOf": [
-                {
-                  "additionalProperties": {},
-                  "properties": {
-                    "items": {
-                      "anyOf": [
-                        {
-                          "items": {
-                            "anyOf": [
-                              {
-                                "additionalProperties": {},
-                                "properties": {
-                                  "basis": {
-                                    "x-observed-types": [
-                                      "string",
-                                      "null"
-                                    ]
-                                  },
-                                  "billing_model": {
-                                    "x-observed-types": [
-                                      "string",
-                                      "null"
-                                    ]
-                                  },
-                                  "free_consultation": {
-                                    "x-observed-types": [
-                                      "null",
-                                      "boolean"
-                                    ]
-                                  },
-                                  "high": {
-                                    "x-observed-types": [
-                                      "number",
-                                      "null"
-                                    ]
-                                  },
-                                  "low": {
-                                    "x-observed-types": [
-                                      "number",
-                                      "null"
-                                    ]
-                                  },
-                                  "observed_at": {
-                                    "x-observed-types": [
-                                      "string",
-                                      "null"
-                                    ]
-                                  },
-                                  "payment_plans": {
-                                    "x-observed-types": [
-                                      "boolean",
-                                      "null"
-                                    ]
-                                  },
-                                  "practice_area": {
-                                    "x-observed-types": "null"
-                                  },
-                                  "source_url": {
-                                    "x-observed-types": "null"
-                                  },
-                                  "stale": {
-                                    "x-observed-types": [
-                                      "boolean",
-                                      "null"
-                                    ]
-                                  },
-                                  "unit": {
-                                    "x-observed-types": [
-                                      "string",
-                                      "null"
-                                    ]
-                                  }
-                                },
-                                "type": "object"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "type": "array"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    },
-                    "note": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "status": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    }
-                  },
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "flags": {
-              "anyOf": [
-                {
-                  "items": {
-                    "x-observed-types": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "type": "array"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "gaps": {
-              "anyOf": [
-                {
-                  "items": {
-                    "x-observed-types": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "type": "array"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "languages": {
-              "x-observed-types": [
-                "string",
-                "null"
-              ]
-            },
-            "license": {
-              "anyOf": [
-                {
-                  "additionalProperties": {},
-                  "properties": {
-                    "all_published_jurisdictions": {
-                      "anyOf": [
-                        {
-                          "items": {
-                            "x-observed-types": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "type": "array"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    },
-                    "as_of": {
-                      "x-observed-types": [
-                        "null",
-                        "string"
-                      ]
-                    },
-                    "bar_number": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "basis": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "check": {
-                      "anyOf": [
-                        {
-                          "additionalProperties": {},
-                          "properties": {
-                            "basis": {
-                              "x-observed-types": [
-                                "string",
-                                "null"
-                              ]
-                            },
-                            "copied_from_official_source_at": {
-                              "x-observed-types": [
-                                "null",
-                                "string"
-                              ]
-                            },
-                            "jurisdiction_collection": {
-                              "anyOf": [
-                                {
-                                  "additionalProperties": {},
-                                  "properties": {
-                                    "basis": {
-                                      "x-observed-types": [
-                                        "string",
-                                        "null"
-                                      ]
-                                    },
-                                    "copied_by": {
-                                      "x-observed-types": [
-                                        "string",
-                                        "null"
-                                      ]
-                                    },
-                                    "copied_on": {
-                                      "x-observed-types": "null"
-                                    },
-                                    "loaded_into_directory": {
-                                      "x-observed-types": [
-                                        "string",
-                                        "null"
-                                      ]
-                                    },
-                                    "source_dataset_updated": {
-                                      "x-observed-types": "null"
-                                    }
-                                  },
-                                  "type": "object"
-                                },
-                                {
-                                  "type": "null"
-                                }
-                              ]
-                            },
-                            "last_authoritative_check": {
-                              "x-observed-types": "null"
-                            },
-                            "not_identity_verification": {
-                              "x-observed-types": [
-                                "string",
-                                "null"
-                              ]
-                            },
-                            "note": {
-                              "x-observed-types": [
-                                "string",
-                                "null"
-                              ]
-                            },
-                            "official_lookup_url": {
-                              "x-observed-types": [
-                                "string",
-                                "null"
-                              ]
-                            },
-                            "official_record_url": {
-                              "x-observed-types": [
-                                "string",
-                                "null"
-                              ]
-                            },
-                            "source_authority": {
-                              "x-observed-types": [
-                                "string",
-                                "null"
-                              ]
-                            },
-                            "source_collection_note": {
-                              "x-observed-types": [
-                                "string",
-                                "null"
-                              ]
-                            },
-                            "status": {
-                              "x-observed-types": [
-                                "string",
-                                "null"
-                              ]
-                            },
-                            "synced_to_esq_copilot": {
-                              "x-observed-types": [
-                                "string",
-                                "null"
-                              ]
-                            }
-                          },
-                          "type": "object"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    },
-                    "jurisdiction": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "source": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "source_url": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "stale": {
-                      "x-observed-types": [
-                        "null",
-                        "boolean"
-                      ]
-                    },
-                    "status": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    }
-                  },
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "location": {
-              "x-observed-types": [
-                "string",
-                "null"
-              ]
-            },
-            "name": {
-              "x-observed-types": [
-                "string",
-                "null"
-              ]
-            },
-            "practice_fit": {
-              "x-observed-types": [
-                "string",
-                "null"
-              ]
-            },
-            "price": {
-              "x-observed-types": [
-                "string",
-                "null"
-              ]
-            },
-            "private_client_intake": {
-              "anyOf": [
-                {
-                  "additionalProperties": {},
-                  "properties": {
-                    "basis": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "confirmed_at": {
-                      "x-observed-types": [
-                        "null",
-                        "string"
-                      ]
-                    },
-                    "employer_type": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "employer_type_basis": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "excluded_by_default": {
-                      "x-observed-types": [
-                        "boolean",
-                        "null"
-                      ]
-                    },
-                    "expires_at": {
-                      "x-observed-types": "null"
-                    },
-                    "note": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "stale": {
-                      "x-observed-types": [
-                        "boolean",
-                        "null"
-                      ]
-                    },
-                    "status": {
-                      "x-observed-types": [
-                        "string",
-                        "null"
-                      ]
-                    }
-                  },
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "score": {
-              "x-observed-types": [
-                "number",
-                "null"
-              ]
-            },
-            "strengths": {
-              "anyOf": [
-                {
-                  "items": {
-                    "x-observed-types": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "type": "array"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "timing": {
-              "x-observed-types": [
-                "string",
-                "null"
-              ]
-            },
-            "years_licensed": {
-              "x-observed-types": [
-                "number",
-                "null"
-              ]
-            }
-          },
-          "type": "object"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "anyOf": [
+        {
+          "additionalProperties": {},
+          "properties": {
+            "attorney_id": {
+              "x-observed-types": [
+                "string",
+                "null"
+              ]
+            },
+            "attribution": {
+              "anyOf": [
+                {
+                  "additionalProperties": {},
+                  "properties": {
+                    "data_confidence": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "match_id": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "official_license_source": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "official_license_source_url": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "profile_url": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "schema_version": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "source_checked_at": {
+                      "x-observed-types": "null"
+                    },
+                    "source_copied_at": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "source_home_url": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "source_name": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "suggested_citation": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "data_confidence": {
+              "anyOf": [
+                {
+                  "additionalProperties": {},
+                  "properties": {
+                    "evidence_coverage_percent": {
+                      "x-observed-types": [
+                        "number",
+                        "null"
+                      ]
+                    },
+                    "known": {
+                      "anyOf": [
+                        {
+                          "items": {
+                            "x-observed-types": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "type": "array"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "level": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "limits": {
+                      "anyOf": [
+                        {
+                          "items": {
+                            "x-observed-types": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "type": "array"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "note": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "unknown": {
+                      "anyOf": [
+                        {
+                          "items": {
+                            "x-observed-types": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "type": "array"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "fees": {
+              "anyOf": [
+                {
+                  "additionalProperties": {},
+                  "properties": {
+                    "items": {
+                      "anyOf": [
+                        {
+                          "items": {
+                            "anyOf": [
+                              {
+                                "additionalProperties": {},
+                                "properties": {
+                                  "basis": {
+                                    "x-observed-types": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  },
+                                  "billing_model": {
+                                    "x-observed-types": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  },
+                                  "free_consultation": {
+                                    "x-observed-types": [
+                                      "null",
+                                      "boolean"
+                                    ]
+                                  },
+                                  "high": {
+                                    "x-observed-types": [
+                                      "number",
+                                      "null"
+                                    ]
+                                  },
+                                  "low": {
+                                    "x-observed-types": [
+                                      "number",
+                                      "null"
+                                    ]
+                                  },
+                                  "observed_at": {
+                                    "x-observed-types": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  },
+                                  "payment_plans": {
+                                    "x-observed-types": [
+                                      "boolean",
+                                      "null"
+                                    ]
+                                  },
+                                  "practice_area": {
+                                    "x-observed-types": "null"
+                                  },
+                                  "source_url": {
+                                    "x-observed-types": "null"
+                                  },
+                                  "stale": {
+                                    "x-observed-types": [
+                                      "boolean",
+                                      "null"
+                                    ]
+                                  },
+                                  "unit": {
+                                    "x-observed-types": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  }
+                                },
+                                "type": "object"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "type": "array"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "note": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "status": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "flags": {
+              "anyOf": [
+                {
+                  "items": {
+                    "x-observed-types": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "gaps": {
+              "anyOf": [
+                {
+                  "items": {
+                    "x-observed-types": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "known_facts": {
+              "anyOf": [
+                {
+                  "items": {
+                    "x-observed-types": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "languages": {
+              "x-observed-types": [
+                "string",
+                "null"
+              ]
+            },
+            "license": {
+              "anyOf": [
+                {
+                  "additionalProperties": {},
+                  "properties": {
+                    "all_published_jurisdictions": {
+                      "anyOf": [
+                        {
+                          "items": {
+                            "x-observed-types": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "type": "array"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "as_of": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "bar_number": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "basis": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "check": {
+                      "anyOf": [
+                        {
+                          "additionalProperties": {},
+                          "properties": {
+                            "basis": {
+                              "x-observed-types": [
+                                "string",
+                                "null"
+                              ]
+                            },
+                            "copied_from_official_source_at": {
+                              "x-observed-types": [
+                                "string",
+                                "null"
+                              ]
+                            },
+                            "jurisdiction_collection": {
+                              "anyOf": [
+                                {
+                                  "additionalProperties": {},
+                                  "properties": {
+                                    "basis": {
+                                      "x-observed-types": [
+                                        "string",
+                                        "null"
+                                      ]
+                                    },
+                                    "copied_by": {
+                                      "x-observed-types": [
+                                        "string",
+                                        "null"
+                                      ]
+                                    },
+                                    "copied_on": {
+                                      "x-observed-types": "null"
+                                    },
+                                    "loaded_into_directory": {
+                                      "x-observed-types": [
+                                        "string",
+                                        "null"
+                                      ]
+                                    },
+                                    "source_dataset_updated": {
+                                      "x-observed-types": "null"
+                                    }
+                                  },
+                                  "type": "object"
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ]
+                            },
+                            "last_authoritative_check": {
+                              "x-observed-types": "null"
+                            },
+                            "not_identity_verification": {
+                              "x-observed-types": [
+                                "string",
+                                "null"
+                              ]
+                            },
+                            "note": {
+                              "x-observed-types": [
+                                "string",
+                                "null"
+                              ]
+                            },
+                            "official_lookup_url": {
+                              "x-observed-types": [
+                                "string",
+                                "null"
+                              ]
+                            },
+                            "official_record_url": {
+                              "x-observed-types": [
+                                "string",
+                                "null"
+                              ]
+                            },
+                            "source_authority": {
+                              "x-observed-types": [
+                                "string",
+                                "null"
+                              ]
+                            },
+                            "source_collection_note": {
+                              "x-observed-types": [
+                                "string",
+                                "null"
+                              ]
+                            },
+                            "status": {
+                              "x-observed-types": [
+                                "string",
+                                "null"
+                              ]
+                            },
+                            "synced_to_esq_copilot": {
+                              "x-observed-types": [
+                                "string",
+                                "null"
+                              ]
+                            }
+                          },
+                          "type": "object"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "jurisdiction": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "source": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "source_url": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "stale": {
+                      "x-observed-types": [
+                        "boolean",
+                        "null"
+                      ]
+                    },
+                    "status": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "location": {
+              "x-observed-types": [
+                "string",
+                "null"
+              ]
+            },
+            "name": {
+              "x-observed-types": [
+                "string",
+                "null"
+              ]
+            },
+            "practice_fit": {
+              "x-observed-types": [
+                "string",
+                "null"
+              ]
+            },
+            "price": {
+              "x-observed-types": [
+                "string",
+                "null"
+              ]
+            },
+            "private_client_intake": {
+              "anyOf": [
+                {
+                  "additionalProperties": {},
+                  "properties": {
+                    "basis": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "confirmed_at": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "employer_type": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "employer_type_basis": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "excluded_by_default": {
+                      "x-observed-types": [
+                        "boolean",
+                        "null"
+                      ]
+                    },
+                    "expires_at": {
+                      "x-observed-types": "null"
+                    },
+                    "note": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "stale": {
+                      "x-observed-types": [
+                        "boolean",
+                        "null"
+                      ]
+                    },
+                    "status": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "timing": {
+              "x-observed-types": [
+                "string",
+                "null"
+              ]
+            },
+            "years_licensed": {
+              "x-observed-types": [
+                "number",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / listing_notice

Added value: +{
+  "x-observed-types": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / order

Added value: +{
+  "x-observed-types": [
+    "string",
+    "null"
+  ]
+}

removedOutput schema / properties / weights_percent

Removed value: -{
-  "anyOf": [
-    {
-      "additionalProperties": {},
-      "properties": {
-        "experience": {
-          "x-observed-types": [
-            "number",
-            "null"
-          ]
-        },
-        "geography": {
-          "x-observed-types": [
-            "number",
-            "null"
-          ]
-        },
-        "practice": {
-          "x-observed-types": [
-            "number",
-            "null"
-          ]
-        },
-        "preferences": {
-          "x-observed-types": [
-            "number",
-            "null"
-          ]
-        },
-        "price": {
-          "x-observed-types": [
-            "number",
-            "null"
-          ]
-        },
-        "timing": {
-          "x-observed-types": [
-            "number",
-            "null"
-          ]
-        }
-      },
-      "type": "object"
-    },
-    {
-      "type": "null"
-    }
-  ]
-}

changedOutput schema / required

Previous value: -[
-  "api_version",
-  "criteria_from_match",
-  "weights_percent",
-  "attorneys",
-  "differences",
-  "verification_gaps",
-  "note"
-]New value: +[
+  "api_version",
+  "criteria_from_match",
+  "order",
+  "attorneys",
+  "differences",
+  "verification_gaps",
+  "note",
+  "listing_notice"
+]

Changed1 schema field changedNov 5, 2026

changedInput schema / properties / match_id / description

Previous value: -"The match_id from find_attorneys, so comparisons use the same criteria"New value: +"The match_id from search_attorneys, so comparisons use the same filters"

Changed10 schema fields changedOct 25, 2026

removedOutput schema / properties / api_version / type
```
Removed value: -[
-  "string",
-  "null"
-]
```
addedOutput schema / properties / api_version / x-observed-types
```
Added value: +[
+  "string",
+  "null"
+]
```

changedOutput schema / properties / attorneys / anyOf

Previous value: -[
-  {
-    "items": {
-      "anyOf": [
-        {
-          "additionalProperties": {},
-          "properties": {
-            "attorney_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "attribution": {
-              "anyOf": [
-                {
-                  "additionalProperties": {},
-                  "properties": {
-                    "data_confidence": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "match_id": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "official_license_source": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "official_license_source_url": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "profile_url": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "schema_version": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "source_checked_at": {
-                      "type": "null"
-                    },
-                    "source_copied_at": {
-                      "type": [
-                        "null",
-                        "string"
-                      ]
-                    },
-                    "source_home_url": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "source_name": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "suggested_citation": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    }
-                  },
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "data_confidence": {
-              "anyOf": [
-                {
-                  "additionalProperties": {},
-                  "properties": {
-                    "evidence_coverage_percent": {
-                      "type": [
-                        "number",
-                        "null"
-                      ]
-                    },
-                    "known": {
-                      "anyOf": [
-                        {
-                          "items": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "type": "array"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    },
-                    "level": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "limits": {
-                      "anyOf": [
-                        {
-                          "items": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "type": "array"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    },
-                    "note": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "unknown": {
-                      "anyOf": [
-                        {
-                          "items": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "type": "array"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    }
-                  },
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "fees": {
-              "anyOf": [
-                {
-                  "additionalProperties": {},
-                  "properties": {
-                    "items": {
-                      "anyOf": [
-                        {
-                          "items": {
-                            "anyOf": [
-                              {
-                                "additionalProperties": {},
-                                "properties": {
-                                  "basis": {
-                                    "type": [
-                                      "string",
-                                      "null"
-                                    ]
-                                  },
-                                  "billing_model": {
-                                    "type": [
-                                      "string",
-                                      "null"
-                                    ]
-                                  },
-                                  "free_consultation": {
-                                    "type": [
-                                      "null",
-                                      "boolean"
-                                    ]
-                                  },
-                                  "high": {
-                                    "type": [
-                                      "number",
-                                      "null"
-                                    ]
-                                  },
-                                  "low": {
-                                    "type": [
-                                      "number",
-                                      "null"
-                                    ]
-                                  },
-                                  "observed_at": {
-                                    "type": [
-                                      "string",
-                                      "null"
-                                    ]
-                                  },
-                                  "payment_plans": {
-                                    "type": [
-                                      "boolean",
-                                      "null"
-                                    ]
-                                  },
-                                  "practice_area": {
-                                    "type": "null"
-                                  },
-                                  "source_url": {
-                                    "type": "null"
-                                  },
-                                  "stale": {
-                                    "type": [
-                                      "boolean",
-                                      "null"
-                                    ]
-                                  },
-                                  "unit": {
-                                    "type": [
-                                      "string",
-                                      "null"
-                                    ]
-                                  }
-                                },
-                                "type": "object"
-                              },
-                              {
-                                "type": "null"
-                              }
-                            ]
-                          },
-                          "type": "array"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    },
-                    "note": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "status": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    }
-                  },
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "flags": {
-              "anyOf": [
-                {
-                  "items": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "type": "array"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "gaps": {
-              "anyOf": [
-                {
-                  "items": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "type": "array"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "languages": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "license": {
-              "anyOf": [
-                {
-                  "additionalProperties": {},
-                  "properties": {
-                    "all_published_jurisdictions": {
-                      "anyOf": [
-                        {
-                          "items": {
-                            "type": [
-                              "string",
-                              "null"
-                            ]
-                          },
-                          "type": "array"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    },
-                    "as_of": {
-                      "type": [
-                        "null",
-                        "string"
-                      ]
-                    },
-                    "bar_number": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "basis": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "check": {
-                      "anyOf": [
-                        {
-                          "additionalProperties": {},
-                          "properties": {
-                            "basis": {
-                              "type": [
-                                "string",
-                                "null"
-                              ]
-                            },
-                            "copied_from_official_source_at": {
-                              "type": [
-                                "null",
-                                "string"
-                              ]
-                            },
-                            "jurisdiction_collection": {
-                              "anyOf": [
-                                {
-                                  "additionalProperties": {},
-                                  "properties": {
-                                    "basis": {
-                                      "type": [
-                                        "string",
-                                        "null"
-                                      ]
-                                    },
-                                    "copied_by": {
-                                      "type": [
-                                        "string",
-                                        "null"
-                                      ]
-                                    },
-                                    "copied_on": {
-                                      "type": "null"
-                                    },
-                                    "loaded_into_directory": {
-                                      "type": [
-                                        "string",
-                                        "null"
-                                      ]
-                                    },
-                                    "source_dataset_updated": {
-                                      "type": "null"
-                                    }
-                                  },
-                                  "type": "object"
-                                },
-                                {
-                                  "type": "null"
-                                }
-                              ]
-                            },
-                            "last_authoritative_check": {
-                              "type": "null"
-                            },
-                            "not_identity_verification": {
-                              "type": [
-                                "string",
-                                "null"
-                              ]
-                            },
-                            "note": {
-                              "type": [
-                                "string",
-                                "null"
-                              ]
-                            },
-                            "official_lookup_url": {
-                              "type": [
-                                "string",
-                                "null"
-                              ]
-                            },
-                            "official_record_url": {
-                              "type": [
-                                "string",
-                                "null"
-                              ]
-                            },
-                            "source_authority": {
-                              "type": [
-                                "string",
-                                "null"
-                              ]
-                            },
-                            "source_collection_note": {
-                              "type": [
-                                "string",
-                                "null"
-                              ]
-                            },
-                            "status": {
-                              "type": [
-                                "string",
-                                "null"
-                              ]
-                            },
-                            "synced_to_esq_copilot": {
-                              "type": [
-                                "string",
-                                "null"
-                              ]
-                            }
-                          },
-                          "type": "object"
-                        },
-                        {
-                          "type": "null"
-                        }
-                      ]
-                    },
-                    "jurisdiction": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "source": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "source_url": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "stale": {
-                      "type": [
-                        "null",
-                        "boolean"
-                      ]
-                    },
-                    "status": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    }
-                  },
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "location": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "practice_fit": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "price": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "private_client_intake": {
-              "anyOf": [
-                {
-                  "additionalProperties": {},
-                  "properties": {
-                    "basis": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "confirmed_at": {
-                      "type": [
-                        "null",
-                        "string"
-                      ]
-                    },
-                    "employer_type": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "employer_type_basis": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "excluded_by_default": {
-                      "type": [
-                        "boolean",
-                        "null"
-                      ]
-                    },
-                    "expires_at": {
-                      "type": "null"
-                    },
-                    "note": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "stale": {
-                      "type": [
-                        "boolean",
-                        "null"
-                      ]
-                    },
-                    "status": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    }
-                  },
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "score": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "strengths": {
-              "anyOf": [
-                {
-                  "items": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "type": "array"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "timing": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "years_licensed": {
-              "type": [
-                "number",
-                "null"
-              ]
-            }
-          },
-          "type": "object"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "anyOf": [
+        {
+          "additionalProperties": {},
+          "properties": {
+            "attorney_id": {
+              "x-observed-types": [
+                "string",
+                "null"
+              ]
+            },
+            "attribution": {
+              "anyOf": [
+                {
+                  "additionalProperties": {},
+                  "properties": {
+                    "data_confidence": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "match_id": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "official_license_source": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "official_license_source_url": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "profile_url": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "schema_version": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "source_checked_at": {
+                      "x-observed-types": "null"
+                    },
+                    "source_copied_at": {
+                      "x-observed-types": [
+                        "null",
+                        "string"
+                      ]
+                    },
+                    "source_home_url": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "source_name": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "suggested_citation": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "data_confidence": {
+              "anyOf": [
+                {
+                  "additionalProperties": {},
+                  "properties": {
+                    "evidence_coverage_percent": {
+                      "x-observed-types": [
+                        "number",
+                        "null"
+                      ]
+                    },
+                    "known": {
+                      "anyOf": [
+                        {
+                          "items": {
+                            "x-observed-types": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "type": "array"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "level": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "limits": {
+                      "anyOf": [
+                        {
+                          "items": {
+                            "x-observed-types": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "type": "array"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "note": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "unknown": {
+                      "anyOf": [
+                        {
+                          "items": {
+                            "x-observed-types": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "type": "array"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "fees": {
+              "anyOf": [
+                {
+                  "additionalProperties": {},
+                  "properties": {
+                    "items": {
+                      "anyOf": [
+                        {
+                          "items": {
+                            "anyOf": [
+                              {
+                                "additionalProperties": {},
+                                "properties": {
+                                  "basis": {
+                                    "x-observed-types": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  },
+                                  "billing_model": {
+                                    "x-observed-types": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  },
+                                  "free_consultation": {
+                                    "x-observed-types": [
+                                      "null",
+                                      "boolean"
+                                    ]
+                                  },
+                                  "high": {
+                                    "x-observed-types": [
+                                      "number",
+                                      "null"
+                                    ]
+                                  },
+                                  "low": {
+                                    "x-observed-types": [
+                                      "number",
+                                      "null"
+                                    ]
+                                  },
+                                  "observed_at": {
+                                    "x-observed-types": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  },
+                                  "payment_plans": {
+                                    "x-observed-types": [
+                                      "boolean",
+                                      "null"
+                                    ]
+                                  },
+                                  "practice_area": {
+                                    "x-observed-types": "null"
+                                  },
+                                  "source_url": {
+                                    "x-observed-types": "null"
+                                  },
+                                  "stale": {
+                                    "x-observed-types": [
+                                      "boolean",
+                                      "null"
+                                    ]
+                                  },
+                                  "unit": {
+                                    "x-observed-types": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  }
+                                },
+                                "type": "object"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "type": "array"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "note": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "status": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "flags": {
+              "anyOf": [
+                {
+                  "items": {
+                    "x-observed-types": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "gaps": {
+              "anyOf": [
+                {
+                  "items": {
+                    "x-observed-types": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "languages": {
+              "x-observed-types": [
+                "string",
+                "null"
+              ]
+            },
+            "license": {
+              "anyOf": [
+                {
+                  "additionalProperties": {},
+                  "properties": {
+                    "all_published_jurisdictions": {
+                      "anyOf": [
+                        {
+                          "items": {
+                            "x-observed-types": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "type": "array"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "as_of": {
+                      "x-observed-types": [
+                        "null",
+                        "string"
+                      ]
+                    },
+                    "bar_number": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "basis": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "check": {
+                      "anyOf": [
+                        {
+                          "additionalProperties": {},
+                          "properties": {
+                            "basis": {
+                              "x-observed-types": [
+                                "string",
+                                "null"
+                              ]
+                            },
+                            "copied_from_official_source_at": {
+                              "x-observed-types": [
+                                "null",
+                                "string"
+                              ]
+                            },
+                            "jurisdiction_collection": {
+                              "anyOf": [
+                                {
+                                  "additionalProperties": {},
+                                  "properties": {
+                                    "basis": {
+                                      "x-observed-types": [
+                                        "string",
+                                        "null"
+                                      ]
+                                    },
+                                    "copied_by": {
+                                      "x-observed-types": [
+                                        "string",
+                                        "null"
+                                      ]
+                                    },
+                                    "copied_on": {
+                                      "x-observed-types": "null"
+                                    },
+                                    "loaded_into_directory": {
+                                      "x-observed-types": [
+                                        "string",
+                                        "null"
+                                      ]
+                                    },
+                                    "source_dataset_updated": {
+                                      "x-observed-types": "null"
+                                    }
+                                  },
+                                  "type": "object"
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ]
+                            },
+                            "last_authoritative_check": {
+                              "x-observed-types": "null"
+                            },
+                            "not_identity_verification": {
+                              "x-observed-types": [
+                                "string",
+                                "null"
+                              ]
+                            },
+                            "note": {
+                              "x-observed-types": [
+                                "string",
+                                "null"
+                              ]
+                            },
+                            "official_lookup_url": {
+                              "x-observed-types": [
+                                "string",
+                                "null"
+                              ]
+                            },
+                            "official_record_url": {
+                              "x-observed-types": [
+                                "string",
+                                "null"
+                              ]
+                            },
+                            "source_authority": {
+                              "x-observed-types": [
+                                "string",
+                                "null"
+                              ]
+                            },
+                            "source_collection_note": {
+                              "x-observed-types": [
+                                "string",
+                                "null"
+                              ]
+                            },
+                            "status": {
+                              "x-observed-types": [
+                                "string",
+                                "null"
+                              ]
+                            },
+                            "synced_to_esq_copilot": {
+                              "x-observed-types": [
+                                "string",
+                                "null"
+                              ]
+                            }
+                          },
+                          "type": "object"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "jurisdiction": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "source": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "source_url": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "stale": {
+                      "x-observed-types": [
+                        "null",
+                        "boolean"
+                      ]
+                    },
+                    "status": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "location": {
+              "x-observed-types": [
+                "string",
+                "null"
+              ]
+            },
+            "name": {
+              "x-observed-types": [
+                "string",
+                "null"
+              ]
+            },
+            "practice_fit": {
+              "x-observed-types": [
+                "string",
+                "null"
+              ]
+            },
+            "price": {
+              "x-observed-types": [
+                "string",
+                "null"
+              ]
+            },
+            "private_client_intake": {
+              "anyOf": [
+                {
+                  "additionalProperties": {},
+                  "properties": {
+                    "basis": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "confirmed_at": {
+                      "x-observed-types": [
+                        "null",
+                        "string"
+                      ]
+                    },
+                    "employer_type": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "employer_type_basis": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "excluded_by_default": {
+                      "x-observed-types": [
+                        "boolean",
+                        "null"
+                      ]
+                    },
+                    "expires_at": {
+                      "x-observed-types": "null"
+                    },
+                    "note": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "stale": {
+                      "x-observed-types": [
+                        "boolean",
+                        "null"
+                      ]
+                    },
+                    "status": {
+                      "x-observed-types": [
+                        "string",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "score": {
+              "x-observed-types": [
+                "number",
+                "null"
+              ]
+            },
+            "strengths": {
+              "anyOf": [
+                {
+                  "items": {
+                    "x-observed-types": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "timing": {
+              "x-observed-types": [
+                "string",
+                "null"
+              ]
+            },
+            "years_licensed": {
+              "x-observed-types": [
+                "number",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / criteria_from_match / type
```
Removed value: -[
-  "boolean",
-  "null"
-]
```
addedOutput schema / properties / criteria_from_match / x-observed-types
```
Added value: +[
+  "boolean",
+  "null"
+]
```

changedOutput schema / properties / differences / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "experience": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "price": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "timing": {
-        "type": [
-          "string",
-          "null"
-        ]
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "experience": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      },
+      "price": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      },
+      "timing": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / note / type
```
Removed value: -[
-  "string",
-  "null"
-]
```
addedOutput schema / properties / note / x-observed-types
```
Added value: +[
+  "string",
+  "null"
+]
```

changedOutput schema / properties / verification_gaps / anyOf

Previous value: -[
-  {
-    "items": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "x-observed-types": [
+        "string",
+        "null"
+      ]
+    },
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / weights_percent / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "experience": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "geography": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "practice": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "preferences": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "price": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "timing": {
-        "type": [
-          "number",
-          "null"
-        ]
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "experience": {
+        "x-observed-types": [
+          "number",
+          "null"
+        ]
+      },
+      "geography": {
+        "x-observed-types": [
+          "number",
+          "null"
+        ]
+      },
+      "practice": {
+        "x-observed-types": [
+          "number",
+          "null"
+        ]
+      },
+      "preferences": {
+        "x-observed-types": [
+          "number",
+          "null"
+        ]
+      },
+      "price": {
+        "x-observed-types": [
+          "number",
+          "null"
+        ]
+      },
+      "timing": {
+        "x-observed-types": [
+          "number",
+          "null"
+        ]
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed1 schema field changedOct 24, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": {},
+  "properties": {
+    "api_version": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "attorneys": {
+      "anyOf": [
+        {
+          "items": {
+            "anyOf": [
+              {
+                "additionalProperties": {},
+                "properties": {
+                  "attorney_id": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "attribution": {
+                    "anyOf": [
+                      {
+                        "additionalProperties": {},
+                        "properties": {
+                          "data_confidence": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "match_id": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "official_license_source": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "official_license_source_url": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "profile_url": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "schema_version": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "source_checked_at": {
+                            "type": "null"
+                          },
+                          "source_copied_at": {
+                            "type": [
+                              "null",
+                              "string"
+                            ]
+                          },
+                          "source_home_url": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "source_name": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "suggested_citation": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          }
+                        },
+                        "type": "object"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "data_confidence": {
+                    "anyOf": [
+                      {
+                        "additionalProperties": {},
+                        "properties": {
+                          "evidence_coverage_percent": {
+                            "type": [
+                              "number",
+                              "null"
+                            ]
+                          },
+                          "known": {
+                            "anyOf": [
+                              {
+                                "items": {
+                                  "type": [
+                                    "string",
+                                    "null"
+                                  ]
+                                },
+                                "type": "array"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "level": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "limits": {
+                            "anyOf": [
+                              {
+                                "items": {
+                                  "type": [
+                                    "string",
+                                    "null"
+                                  ]
+                                },
+                                "type": "array"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "note": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "unknown": {
+                            "anyOf": [
+                              {
+                                "items": {
+                                  "type": [
+                                    "string",
+                                    "null"
+                                  ]
+                                },
+                                "type": "array"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          }
+                        },
+                        "type": "object"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "fees": {
+                    "anyOf": [
+                      {
+                        "additionalProperties": {},
+                        "properties": {
+                          "items": {
+                            "anyOf": [
+                              {
+                                "items": {
+                                  "anyOf": [
+                                    {
+                                      "additionalProperties": {},
+                                      "properties": {
+                                        "basis": {
+                                          "type": [
+                                            "string",
+                                            "null"
+                                          ]
+                                        },
+                                        "billing_model": {
+                                          "type": [
+                                            "string",
+                                            "null"
+                                          ]
+                                        },
+                                        "free_consultation": {
+                                          "type": [
+                                            "null",
+                                            "boolean"
+                                          ]
+                                        },
+                                        "high": {
+                                          "type": [
+                                            "number",
+                                            "null"
+                                          ]
+                                        },
+                                        "low": {
+                                          "type": [
+                                            "number",
+                                            "null"
+                                          ]
+                                        },
+                                        "observed_at": {
+                                          "type": [
+                                            "string",
+                                            "null"
+                                          ]
+                                        },
+                                        "payment_plans": {
+                                          "type": [
+                                            "boolean",
+                                            "null"
+                                          ]
+                                        },
+                                        "practice_area": {
+                                          "type": "null"
+                                        },
+                                        "source_url": {
+                                          "type": "null"
+                                        },
+                                        "stale": {
+                                          "type": [
+                                            "boolean",
+                                            "null"
+                                          ]
+                                        },
+                                        "unit": {
+                                          "type": [
+                                            "string",
+                                            "null"
+                                          ]
+                                        }
+                                      },
+                                      "type": "object"
+                                    },
+                                    {
+                                      "type": "null"
+                                    }
+                                  ]
+                                },
+                                "type": "array"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "note": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "status": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          }
+                        },
+                        "type": "object"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "flags": {
+                    "anyOf": [
+                      {
+                        "items": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "type": "array"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "gaps": {
+                    "anyOf": [
+                      {
+                        "items": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "type": "array"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "languages": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "license": {
+                    "anyOf": [
+                      {
+                        "additionalProperties": {},
+                        "properties": {
+                          "all_published_jurisdictions": {
+                            "anyOf": [
+                              {
+                                "items": {
+                                  "type": [
+                                    "string",
+                                    "null"
+                                  ]
+                                },
+                                "type": "array"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "as_of": {
+                            "type": [
+                              "null",
+                              "string"
+                            ]
+                          },
+                          "bar_number": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "basis": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "check": {
+                            "anyOf": [
+                              {
+                                "additionalProperties": {},
+                                "properties": {
+                                  "basis": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  },
+                                  "copied_from_official_source_at": {
+                                    "type": [
+                                      "null",
+                                      "string"
+                                    ]
+                                  },
+                                  "jurisdiction_collection": {
+                                    "anyOf": [
+                                      {
+                                        "additionalProperties": {},
+                                        "properties": {
+                                          "basis": {
+                                            "type": [
+                                              "string",
+                                              "null"
+                                            ]
+                                          },
+                                          "copied_by": {
+                                            "type": [
+                                              "string",
+                                              "null"
+                                            ]
+                                          },
+                                          "copied_on": {
+                                            "type": "null"
+                                          },
+                                          "loaded_into_directory": {
+                                            "type": [
+                                              "string",
+                                              "null"
+                                            ]
+                                          },
+                                          "source_dataset_updated": {
+                                            "type": "null"
+                                          }
+                                        },
+                                        "type": "object"
+                                      },
+                                      {
+                                        "type": "null"
+                                      }
+                                    ]
+                                  },
+                                  "last_authoritative_check": {
+                                    "type": "null"
+                                  },
+                                  "not_identity_verification": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  },
+                                  "note": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  },
+                                  "official_lookup_url": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  },
+                                  "official_record_url": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  },
+                                  "source_authority": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  },
+                                  "source_collection_note": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  },
+                                  "status": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  },
+                                  "synced_to_esq_copilot": {
+                                    "type": [
+                                      "string",
+                                      "null"
+                                    ]
+                                  }
+                                },
+                                "type": "object"
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ]
+                          },
+                          "jurisdiction": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "source": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "source_url": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "stale": {
+                            "type": [
+                              "null",
+                              "boolean"
+                            ]
+                          },
+                          "status": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          }
+                        },
+                        "type": "object"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "location": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "name": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "practice_fit": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "price": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "private_client_intake": {
+                    "anyOf": [
+                      {
+                        "additionalProperties": {},
+                        "properties": {
+                          "basis": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "confirmed_at": {
+                            "type": [
+                              "null",
+                              "string"
+                            ]
+                          },
+                          "employer_type": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "employer_type_basis": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "excluded_by_default": {
+                            "type": [
+                              "boolean",
+                              "null"
+                            ]
+                          },
+                          "expires_at": {
+                            "type": "null"
+                          },
+                          "note": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          },
+                          "stale": {
+                            "type": [
+                              "boolean",
+                              "null"
+                            ]
+                          },
+                          "status": {
+                            "type": [
+                              "string",
+                              "null"
+                            ]
+                          }
+                        },
+                        "type": "object"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "score": {
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  },
+                  "strengths": {
+                    "anyOf": [
+                      {
+                        "items": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "type": "array"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "timing": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "years_licensed": {
+                    "type": [
+                      "number",
+                      "null"
+                    ]
+                  }
+                },
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "criteria_from_match": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "differences": {
+      "anyOf": [
+        {
+          "additionalProperties": {},
+          "properties": {
+            "experience": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "price": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "timing": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "note": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "verification_gaps": {
+      "anyOf": [
+        {
+          "items": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "weights_percent": {
+      "anyOf": [
+        {
+          "additionalProperties": {},
+          "properties": {
+            "experience": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "geography": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "practice": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "preferences": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "price": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "timing": {
+              "type": [
+                "number",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "required": [
+    "api_version",
+    "criteria_from_match",
+    "weights_percent",
+    "attorneys",
+    "differences",
+    "verification_gaps",
+    "note"
+  ],
+  "type": "object"
+}

First observedOct 17, 2026

TDQS

A4.6/5.0

Behavior5/5

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

Annotations already declare readOnly, idempotent, non-destructive and closed-world, and the description adds real behavior on top: output is ordered as given, no scores or ranking, no recommendation of a winner, and unknown price/timing data is explicitly flagged as incomparable. It also discloses the commercial posture (listing service, no paid placement), which an agent relaying results to a person would otherwise have no way to know.

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-loaded with the trigger condition and built from short, information-dense clauses. The closing two sentences about being a listing service rather than a referral service are trust/compliance framing rather than invocation guidance, so they earn their place less than the rest, but they are brief and unambiguous.

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?

An output schema exists, so return-value detail is not needed here; what the description must supply — cardinality limits, ordering semantics, absence of ranking, handling of missing data, and the required upstream tool — is all present. Nothing an agent needs in order to call this correctly and describe the result honestly is missing.

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

Parameters4/5

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

Schema description coverage is only 50%, but the description compensates for most of the gap: it explains that attorney_ids must be 2-5, that order is preserved, that match_id carries the search filters, and that priorities is inert because no scoring occurs. The one remaining hole is the criteria enum, whose seven values are never explained in the description or schema — though the enumerated comparison dimensions (practice areas, location, years licensed, fees, availability, verification) map closely enough to be inferred.

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 (compares) and resource (2 to 5 lawyers) plus the exact dimensions compared and the output shape (side by side, in the order given, no scores). It also names the sibling it consumes output from (search_attorneys), so an agent can tell it apart from find_attorneys or get_attorney_profile without opening a schema.

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 when the person asks to compare lawyers from search_attorneys" gives an explicit trigger and a prerequisite source tool, and "Pass match_id to use the person's filters" tells the agent how to carry context forward. It lacks an explicit when-not statement (e.g. what to do with a single lawyer or when to fall back to search_attorneys), which keeps it just short of a 5.

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

All ESQ Matching Engine 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.

Resources

Need Help?