Lawmatics MCP Tool - Update Company

Q: What does the Update Company tool do?

This page documents the Update Company tool (lawmatics_update-company). Update an existing company in Lawmatics by ID. The echo includes a relationships envelope of {id,type} pointers to related records (primary contact, contacts, prospects, tags, emails, phone numbers, addresses, notes, and the creating user). It is one of the Lawmatics Companies tools, invoked through your firm's Weave MCP connection and available to members whose access level permits it.

Update Company (lawmatics_update-company)

Update an existing company in Lawmatics by ID. The echo includes a `relationships` envelope of {id,type} pointers to related records (primary contact, contacts, prospects, tags, emails, phone numbers, addresses, notes, and the creating user).

Tool Input

companyIdstring— ID of the company to update; a numeric string(pattern: ^\d+$)

namestring— Company name

emailstring(email)— Primary email address(pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$)

phoneNumberstring— Primary phone number

streetstring— Primary address street

street2string— Primary address street line 2

citystring— Primary address city

statestring— Primary address state / province

countrystring— Primary address country

postalCodestring— Primary address ZIP / postal code

emailsAttributesarray— Additional email addresses to create inline (write-only; not returned)

[]object

infostring— The email address or phone number

labelstring— Label for this entry (e.g. Home, Work)

phoneNumbersAttributesarray— Additional phone numbers to create inline (write-only; not returned)

[]object

infostring— The email address or phone number

labelstring— Label for this entry (e.g. Home, Work)

addressesAttributesarray— Additional addresses to create inline (write-only; returned via `addresses`)

[]object

streetstring— Street address

street2string— Street address line 2

citystring— City

statestring— State / province

countrystring— Country

postalCodestring— ZIP / postal code

labelstring— Label for this address (e.g. Home, Work)

customFieldsarray— Custom field values to set; pass null as a value to clear that field

[]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 company ID

namestringnull— Company name; null if unset

emailstringnull— Primary email address; null if unset

addressstringnull— Computed, formatted full address string; read-only; null if unset

citystringnull— Primary address city; null if unset

statestringnull— Primary address state/province; null if unset

postalCodestringnull— Primary address ZIP/postal code; null if unset

countrystringnull— Primary address country; null if unset

phoneNumberstringnull— Primary phone number as stored; null if unset

addressesarray— All addresses associated with the company; empty array if none

[]object

idnumber— Address ID

streetstringnull— Street address line 1; null if unset

street2stringnull— Street address line 2; null if unset

citystringnull— Address city; null if unset

statestringnull— Address state/province; null if unset

postalCodestringnull— Address ZIP/postal code; null if unset

countrystringnull— Address country; null if unset

labelstringnull— Address label (e.g. Primary, Home, Work); null if unset

createdAtstringnull— When the address was created, as an ISO 8601 timestamp; null if unknown

updatedAtstringnull— When the address was last updated, as an ISO 8601 timestamp; null if unknown

customFieldsarray— Account-defined custom fields on the company; 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`

createdAtstringnull— When the company was created, as an ISO 8601 timestamp; null if unknown

updatedAtstringnull— When the company was last updated, as an ISO 8601 timestamp; null if unknown

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 'user' -> get-user, type 'address' -> get-address).

primaryContactobjectnull— Primary-contact pointer (live `type` "primary_contact"); null when unset