ESQ Matching Engine

Get a lawyer's profile and sources

get_attorney_profile

Read-onlyIdempotent

Use when the person wants details on one listed lawyer. Returns license status with its official source and check date, private-client intake evidence, practice areas, service area, fees, availability, languages, data freshness, the directory profile link, how to contact the lawyer and a suggested citation. Also returns the exact consent text to show before a message is sent. This is a listing service, not a lawyer referral service. No lawyer pays for placement or ranking of any kind.

Input Schema

Name	Required	Description	Default
`attorney_id`	Yes

Output Schema

Name	Required	Description	Default
`fees`	Yes
`firm`	Yes
`name`	Yes
`contact`	Yes
`license`	Yes
`notices`	Yes
`freshness`	Yes
`languages`	Yes
`test_data`	No
`api_version`	Yes
`attorney_id`	Yes
`attribution`	Yes
`profile_url`	Yes
`availability`	Yes
`service_area`	Yes
`practice_areas`	Yes
`years_licensed`	Yes
`private_client_intake`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedNov 5, 2026

changedOutput schema / properties / contact / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "consent_text_to_show": {
-        "x-observed-types": [
-          "string",
-          "null"
-        ]
-      },
-      "consent_text_version": {
-        "x-observed-types": [
-          "string",
-          "null"
-        ]
-      },
-      "introduction": {
-        "x-observed-types": [
-          "string",
-          "null"
-        ]
-      },
-      "introduction_delivery": {
-        "x-observed-types": [
-          "string",
-          "null"
-        ]
-      },
-      "phone": {
-        "x-observed-types": [
-          "string",
-          "null"
-        ]
-      },
-      "website": {
-        "x-observed-types": [
-          "null",
-          "string"
-        ]
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "consent_text_to_show": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      },
+      "consent_text_version": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      },
+      "phone": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      },
+      "website": {
+        "x-observed-types": [
+          "null",
+          "string"
+        ]
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed26 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"
+]
```
removedOutput schema / properties / attorney_id / type
```
Removed value: -[
-  "string",
-  "null"
-]
```
addedOutput schema / properties / attorney_id / x-observed-types
```
Added value: +[
+  "string",
+  "null"
+]
```

changedOutput schema / properties / attribution / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "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"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "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"
+  }
+]

changedOutput schema / properties / availability / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "accepting_new_matters": {
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "appointment_types": {
-        "anyOf": [
-          {
-            "items": {},
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "certainty": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "last_checked": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "next_available_at": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "note": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "source": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "stale": {
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "status": {
-        "type": [
-          "string",
-          "null"
-        ]
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "accepting_new_matters": {
+        "x-observed-types": [
+          "boolean",
+          "null"
+        ]
+      },
+      "appointment_types": {
+        "anyOf": [
+          {
+            "items": {},
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "certainty": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      },
+      "last_checked": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      },
+      "next_available_at": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      },
+      "note": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      },
+      "source": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      },
+      "stale": {
+        "x-observed-types": [
+          "boolean",
+          "null"
+        ]
+      },
+      "status": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / contact / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "consent_text_to_show": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "consent_text_version": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "introduction": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "introduction_delivery": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "phone": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "website": {
-        "type": [
-          "null",
-          "string"
-        ]
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "consent_text_to_show": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      },
+      "consent_text_version": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      },
+      "introduction": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      },
+      "introduction_delivery": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      },
+      "phone": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      },
+      "website": {
+        "x-observed-types": [
+          "null",
+          "string"
+        ]
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / fees / anyOf

Previous value: -[
-  {
-    "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"
-  }
-]New value: +[
+  {
+    "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"
+  }
+]

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

changedOutput schema / properties / freshness / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "license_as_of": {
-        "type": [
-          "null",
-          "string"
-        ]
-      },
-      "license_check_status": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "license_last_authoritative_check": {
-        "type": "null"
-      },
-      "license_stale": {
-        "type": [
-          "null",
-          "boolean"
-        ]
-      },
-      "synced_to_esq_copilot": {
-        "type": [
-          "string",
-          "null"
-        ]
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "license_as_of": {
+        "x-observed-types": [
+          "null",
+          "string"
+        ]
+      },
+      "license_check_status": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      },
+      "license_last_authoritative_check": {
+        "x-observed-types": "null"
+      },
+      "license_stale": {
+        "x-observed-types": [
+          "null",
+          "boolean"
+        ]
+      },
+      "synced_to_esq_copilot": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

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

changedOutput schema / properties / license / anyOf

Previous value: -[
-  {
-    "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"
-  }
-]New value: +[
+  {
+    "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"
+  }
+]

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

changedOutput schema / properties / notices / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "no_paid_placement": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "no_relationship": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "not_advice": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "ranking": {
-        "type": [
-          "string",
-          "null"
-        ]
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "no_paid_placement": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      },
+      "no_relationship": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      },
+      "not_advice": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      },
+      "ranking": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / practice_areas / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "basis": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "values": {
-        "anyOf": [
-          {
-            "items": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "basis": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      },
+      "values": {
+        "anyOf": [
+          {
+            "items": {
+              "x-observed-types": [
+                "string",
+                "null"
+              ]
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / private_client_intake / anyOf

Previous value: -[
-  {
-    "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"
-  }
-]New value: +[
+  {
+    "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"
+  }
+]

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

changedOutput schema / properties / service_area / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "city": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "county": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "office_state": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "remote": {
-        "type": [
-          "string",
-          "null"
-        ]
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "city": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      },
+      "county": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      },
+      "office_state": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      },
+      "remote": {
+        "x-observed-types": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / test_data / type
```
Removed value: -[
-  "boolean",
-  "null"
-]
```
addedOutput schema / properties / test_data / x-observed-types
```
Added value: +[
+  "boolean",
+  "null"
+]
```
removedOutput schema / properties / years_licensed / type
```
Removed value: -[
-  "number",
-  "null"
-]
```
addedOutput schema / properties / years_licensed / x-observed-types
```
Added value: +[
+  "number",
+  "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"
+      ]
+    },
+    "attorney_id": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "attribution": {
+      "anyOf": [
+        {
+          "additionalProperties": {},
+          "properties": {
+            "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"
+        }
+      ]
+    },
+    "availability": {
+      "anyOf": [
+        {
+          "additionalProperties": {},
+          "properties": {
+            "accepting_new_matters": {
+              "type": [
+                "boolean",
+                "null"
+              ]
+            },
+            "appointment_types": {
+              "anyOf": [
+                {
+                  "items": {},
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "certainty": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "last_checked": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "next_available_at": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "note": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "source": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "stale": {
+              "type": [
+                "boolean",
+                "null"
+              ]
+            },
+            "status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "contact": {
+      "anyOf": [
+        {
+          "additionalProperties": {},
+          "properties": {
+            "consent_text_to_show": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "consent_text_version": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "introduction": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "introduction_delivery": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "phone": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "website": {
+              "type": [
+                "null",
+                "string"
+              ]
+            }
+          },
+          "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"
+        }
+      ]
+    },
+    "firm": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "freshness": {
+      "anyOf": [
+        {
+          "additionalProperties": {},
+          "properties": {
+            "license_as_of": {
+              "type": [
+                "null",
+                "string"
+              ]
+            },
+            "license_check_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "license_last_authoritative_check": {
+              "type": "null"
+            },
+            "license_stale": {
+              "type": [
+                "null",
+                "boolean"
+              ]
+            },
+            "synced_to_esq_copilot": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        {
+          "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"
+        }
+      ]
+    },
+    "name": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "notices": {
+      "anyOf": [
+        {
+          "additionalProperties": {},
+          "properties": {
+            "no_paid_placement": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "no_relationship": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "not_advice": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "ranking": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "practice_areas": {
+      "anyOf": [
+        {
+          "additionalProperties": {},
+          "properties": {
+            "basis": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "values": {
+              "anyOf": [
+                {
+                  "items": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "type": "object"
+        },
+        {
+          "type": "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"
+        }
+      ]
+    },
+    "profile_url": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "service_area": {
+      "anyOf": [
+        {
+          "additionalProperties": {},
+          "properties": {
+            "city": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "county": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "office_state": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "remote": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "test_data": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "years_licensed": {
+      "type": [
+        "number",
+        "null"
+      ]
+    }
+  },
+  "required": [
+    "api_version",
+    "attorney_id",
+    "name",
+    "firm",
+    "profile_url",
+    "license",
+    "years_licensed",
+    "private_client_intake",
+    "practice_areas",
+    "service_area",
+    "fees",
+    "availability",
+    "languages",
+    "contact",
+    "freshness",
+    "attribution",
+    "notices"
+  ],
+  "type": "object"
+}

First observedOct 17, 2026

TDQS

A3.9/5.0

Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false, and openWorldHint=false, so safety is covered. The description adds genuinely non-obvious context beyond that: it returns the exact consent text that must be shown before a message is sent, and it discloses the 'listing service, not referral service, no paid placement' posture — both material to how an agent should present results. It stops short of describing error behavior for unknown IDs.

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 sentence, then the payload, then the disclosure caveats — a sensible progression with no filler. The long comma-separated return enumeration is somewhat bulky and overlaps with the output schema, which keeps it from a 5.

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

Completeness4/5

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

An output schema exists, so return values need not be spelled out, and the annotations fully cover the safety profile; the description still completes the picture by covering consent text and the non-paid-placement disclosure. The remaining gap is practical rather than conceptual: no guidance on sourcing a valid attorney_id or handling a not-found response.

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

Parameters3/5

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

Schema description coverage is 0% and the single required parameter, attorney_id, is never mentioned in the description. The name and uuid format make its meaning largely self-evident, and 'one listed lawyer' implies the ID identifies that lawyer, but the description never says where to obtain a valid attorney_id (e.g., from find_attorneys or search_attorneys results), which is the one piece of guidance an agent actually needs.

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

Purpose4/5

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

The description names a specific verb-and-resource pair ('details on one listed lawyer') and enumerates the returned fields, including license status with source and check date. The word 'one' implicitly distinguishes it from the search/list siblings (find_attorneys, search_attorneys, compare_attorneys), but no sibling is named explicitly, so it falls short of a 5.

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 wants details on one listed lawyer' is a clear trigger condition tied to a single-record lookup. It gives no explicit exclusions and never names the alternative to use when the person wants multiple lawyers or a comparison, so it lacks the when-not/alternatives routing that would earn 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?