# Find Matter By Phone

`lawmatics_find-matter-by-phone` · Lawmatics MCP tool · Lookups

Fuzzy-find a single matter (legal case) in Lawmatics by the client's phone number; use get-matter for full details. Returns `{ match: <entity> }` on a hit and `{ match: null }` when no record matches. `match: null` is a normal empty result, not an error — do not retry.

## Input

- **phoneNumber** `string` (required, min length: 1) — Phone number to search for. The server normalizes it before matching (strips all non-digits and tries with and without a leading 1 for US country codes), so any common phone format is accepted.

## Output

- **match** `object | null` (required) — The single best matching matter, or null if nothing matched. Returns `{ match: <entity> }` on a hit and `{ match: null }` when no record matches. `match: null` is a normal empty result, not an error — do not retry.
  - **id** `string` (required) — Lawmatics matter ID; pass to get-matter for full case details
  - **firstName** `string | null` (required) — Client's first/given name; null if unset
  - **lastName** `string | null` (required) — Client's last/family name; null if unset
  - **email** `string | null` (required) — Client's primary email address; null if unset
  - **phone** `string | null` (required) — Client's primary phone number as stored; null if unset
  - **createdAt** `string | null` (required) — When the matter was created, as an ISO 8601 timestamp; null if unknown
  - **updatedAt** `string | null` (required) — When the matter was last updated, as an ISO 8601 timestamp; null if unknown