Lawmatics MCP Tool - Create Matter From Contact Match

Create Matter From Contact Match (lawmatics_create-matter-from-contact-match)

Create a matter (legal case) in Lawmatics by matching an existing contact on email, name, or phone. Creates the matter for the matched contact, or creates a new contact when no match is found.

Tool Input

matchContactBystring— Contact field to match on. 'name' matches on first name, first+last name, or full name(enum: "email", "name", "phone")

caseTitlestring— Title of the matter/case

firstNamestring— First name to match on and/or set on the matched contact

lastNamestring— Last name to match on and/or set on the matched contact

emailstring(email)— Email address to match on and/or set on the matched contact(pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$)

phonestring— Phone number to match on and/or set on the matched contact

notesarray— Notes to create inline with the matter (write-only; not returned)

[]object

namestring— Note title

bodystring— Note content

tagsarray— Tag names to attach to the matter; missing tags are created

[]string

customFieldsarray— Custom field values to set on the new matter; pass null as a value to clear

[]object

idstringnumber— Custom field ID (the API returns it as a number; either a string or number is accepted)

valuestringnumberbooleannull— Value to set (matches the field's type); pass null to clear the field

Tool Output

idstring— Lawmatics matter ID of the newly created matter

caseTitlestringnull— Title of the matter/case; null if unset

caseBlurbstringnull— Short description of the matter (read-only attribute); null if unset

statusstring— Matter status (e.g. "pnc", "hired", "lost"); new matters start as "pnc"

subStatusstringnull— Sub-status label within the status; null if unset

firstNamestringnull— First name of the matter's primary contact; null if unset

lastNamestringnull— Last name of the matter's primary contact; null if unset

emailstringnull— Primary email address of the matter's contact; null if unset

phonestringnull— Primary phone number of the matter's contact; null if unset

customFieldsarray— Account-defined custom fields on the matter; empty array if none

[]object

idstring— Custom field definition ID, as a numeric string

namestringnull— Custom field display name; null if unset

fieldTypestringnull— Custom field data type (e.g. text, date, select); null if unset

valueany— Raw custom field value; type varies by `fieldType`

formattedValueany— Display-formatted custom field value; type varies by `fieldType`

createdAtstring— When the matter was created, as an ISO 8601 timestamp

updatedAtstring— When the matter was last updated, as an ISO 8601 timestamp

relationshipsobject— JSON:API relationship pointers to related records as {id,type} stubs. Not materialized — follow a pointer by calling that resource's own get/find tool (e.g. type 'contact' -> get-contact, type 'company' -> get-company, type 'user' -> get-user).

sourceobjectnull— Lead source pointer; null when unset