Lawmatics MCP Tool - Create Matter From Company

Q: What does the Create Matter From Company tool do?

This page documents the Create Matter From Company tool (lawmatics_create-matter-from-company). Create a matter (legal case) in Lawmatics linked to a company, by company ID or by company name (found or created). Contact fields create or update the matter's point-of-contact. It is one of the Lawmatics Matters tools, invoked through your firm's Weave MCP connection and available to members whose access level permits it.

Create Matter From Company (lawmatics_create-matter-from-company)

Create a matter (legal case) in Lawmatics linked to a company, by company ID or by company name (found or created). Contact fields create or update the matter's point-of-contact.

Tool Input

companyIdstring— ID of an existing company to link; a numeric string. Mutually exclusive with companyName(pattern: ^\d+$)

companyNamestring— Company name to find or create and link. Mutually exclusive with companyId

caseTitlestring— Title of the matter/case

firstNamestring— First name of the matter's point-of-contact (created or updated)

lastNamestring— Last name of the matter's point-of-contact (created or updated)

emailstring(email)— Email address of the matter's point-of-contact (created or updated)(pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$)

phonestring— Phone number of the matter's point-of-contact (created or updated)

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 point-of-contact; null if unset

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

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

phonestringnull— Primary phone number of the matter's point-of-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