Call this server's tools from your browser. Nothing to install.
https://lawcus.usefulapi.io/mcp
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
lawcus_create_contact
WRITE: create a new contact in Lawcus (a person or a company). It does not send anything to the contact. Person needs first_name and last_name; Company needs name. Check lawcus_list_contacts first to avoid duplicates.
Required for a Company.
Business title.
Required for a Person.
Required for a Person.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Tools (27)
lawcus_create_contact
WRITE: create a new contact in Lawcus (a person or a company). It does not send anything to the contact. Person needs first_name and last_name; Company needs name. Check lawcus_list_contacts first to avoid duplicates.
WRITE: create a task in Lawcus, optionally on a matter and assigned to team members. Lawcus may email or SMS the assignees if reminders are set; no reminders are set by this tool.
Argument
Type
Description
name*
string
due_date
string
A UTC date (yyyy-mm-dd) or timestamp (yyyy-mm-dd hh:mm:ss).
matter_id
integer
Numeric matter id (the `id` of a matter).
description
string
assignee_uuids
array
UUIDs of the users to assign (from lawcus_list_team_members).
Input schema (JSON)
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 300,
"minLength": 1
},
"due_date": {
"type": "string",
"description": "A UTC date (yyyy-mm-dd) or timestamp (yyyy-mm-dd hh:mm:ss)."
},
"matter_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Numeric matter id (the `id` of a matter).",
"exclusiveMinimum": 0
},
"description": {
"type": "string",
"maxLength": 5000
},
"assignee_uuids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
},
"maxItems": 20,
"description": "UUIDs of the users to assign (from lawcus_list_team_members)."
}
}
}
lawcus_get_contact
Lawcus: one contact by UUID, with addresses, phones, emails and custom fields.
Lawcus: the user the API token belongs to (id, uuid, name, timezone, role such as OWNER/ADMIN/MEMBER).
read-only
No arguments.
Input schema (JSON)
{
"type": "object",
"properties": {}
}
lawcus_list_billing_items
Lawcus: billable activity (time entries, expenses and flat fees) with payment details, filterable by date range, user, practice area, matter, client and invoiced state. Also returns time totals for today/week/month/year.
read-only
Argument
Type
Description
end
string
Period end, UTC: yyyy-mm-dd (through 23:59:59) or yyyy-mm-dd hh:mm:ss.
kind
string
Only this kind of item (default: all three).
limit
integer
Return at most this many records (default 100, max 500). The reply says when the list was cut.
start
string
Period start, UTC: yyyy-mm-dd (from 00:00:00) or yyyy-mm-dd hh:mm:ss.
user_id
integer
client_id
integer
matter_id
integer
is_invoiced
boolean
practice_id
integer
lawcus_list_contacts
Lawcus: list contacts (people and companies; clients are contacts), filterable by name, email, type or update date. Paged with skip/take.
read-only
Argument
Type
Description
skip
integer
Records to skip (default 0). Pass the previous reply's next_skip.
take
integer
Records per page (default 25, max 100).
type
string
filters
array
Advanced: extra Lawcus v2 filter objects {field, operator, value}, ANDed with the other filters. Dates are 'yyyy-mm-dd hh:mm:ss' UTC.
sort_by
string
sort_order
string
name_contains
string
Substring of the contact's full name.
updated_after
string
A UTC date (yyyy-mm-dd) or timestamp (yyyy-mm-dd hh:mm:ss).
email_contains
string
Input schema (JSON)
lawcus_list_expenses
Lawcus: expenses logged against matters. The API returns all expenses; filter here by matter and date range, reply cut to `limit`.
read-only
Argument
Type
Description
limit
integer
Return at most this many records (default 100, max 500). The reply says when the list was cut.
date_to
string
A date, yyyy-mm-dd.
date_from
string
A date, yyyy-mm-dd.
matter_id
integer
Input schema (JSON)
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"description": "Return at most this many records (default 100, max 500). The reply says when the list was cut.",
"exclusiveMinimum": 0
},
"date_to": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "A date, yyyy-mm-dd."
},
"date_from": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "A date, yyyy-mm-dd."
},
"matter_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
}
lawcus_list_interactions
Lawcus: logged client interactions (emails, calls, secure messages) with subject, matter and contact. Paged with skip/paginate.
Lawcus: the firm's lead sources (Website, Referral, Google, ...). Ids go into lead and contact filters.
read-only
No arguments.
Input schema (JSON)
{
"type": "object",
"properties": {}
}
lawcus_list_leads
Lawcus: list leads (prospective matters) with client contact details and pipeline stage. Paged with skip/take.
read-only
Argument
Type
Description
skip
integer
Records to skip (default 0). Pass the previous reply's next_skip.
take
integer
Records per page (default 25, max 100).
filters
array
Advanced: extra Lawcus v2 filter objects {field, operator, value}, ANDed with the other filters. Dates are 'yyyy-mm-dd hh:mm:ss' UTC.
sort_by
string
stage_id
integer
Pipeline stage id (see lawcus_list_workflow_stages).
sort_order
string
created_after
string
Only leads created after this UTC time.
name_contains
string
lead_source_id
integer
Lead source id (see lawcus_list_lead_sources).
lawcus_list_matters
Lawcus: list matters (cases) with status, client, billing type, trust and retainer balances. Filter by status, name, number, client or dates. Paged with skip/take; the reply also carries opened/closed counts.
read-only
Argument
Type
Description
skip
integer
Records to skip (default 0). Pass the previous reply's next_skip.
take
integer
Records per page (default 25, max 100).
number
string
Matter number (exact).
status
string
Matter status, e.g. "OPEN" or "CLOSED".
filters
array
Advanced: extra Lawcus v2 filter objects {field, operator, value}, ANDed with the other filters. Dates are 'yyyy-mm-dd hh:mm:ss' UTC.
sort_by
string
client_id
integer
Numeric id of the client contact.
sort_order
string
opened_after
string
A UTC date (yyyy-mm-dd) or timestamp (yyyy-mm-dd hh:mm:ss).
lawcus_list_tasks
Lawcus: list tasks, optionally by completion, assignee, matter or tag. The API returns the whole list; the reply is cut to `limit`.
read-only
Argument
Type
Description
tags
string
Tag name, e.g. "San Diego Branch".
limit
integer
Return at most this many records (default 100, max 500). The reply says when the list was cut.
user_id
string
UUID of the assignee (the `uuid` from lawcus_list_team_members).
completed
boolean
true = completed tasks, false = open tasks.
delegated
boolean
true = tasks delegated to others.
matter_id
integer
Numeric matter id.
Input schema (JSON)
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"tags": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Tag name, e.g. \"San Diego Branch\"."
},
"limit": {
"type": "integer",
"maximum": 500,
"description": "Return at most this many records (default 100, max 500). The reply says when the list was cut.",
"exclusiveMinimum": 0
},
"user_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "UUID of the assignee (the `uuid` from lawcus_list_team_members)."
},
"completed": {
"type": "boolean",
"description": "true = completed tasks, false = open tasks."
},
"delegated": {
"type": "boolean",
"description": "true = tasks delegated to others."
},
"matter_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Numeric matter id.",
"exclusiveMinimum": 0
}
}
}
lawcus_list_team_members
Lawcus: the people on the firm's team with id, uuid, name, role and hourly rate. Ids are used in matter, task and report filters.
read-only
No arguments.
Input schema (JSON)
{
"type": "object",
"properties": {}
}
lawcus_list_time_entries
Lawcus: time entries (hours worked, rate, total, matter, invoiced or not). The API returns all entries; filter here by matter and date range, reply cut to `limit`.
read-only
Argument
Type
Description
limit
integer
Return at most this many records (default 100, max 500). The reply says when the list was cut.
date_to
string
A date, yyyy-mm-dd.
user_id
integer
date_from
string
A date, yyyy-mm-dd.
matter_id
integer
Input schema (JSON)
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"description": "Return at most this many records (default 100, max 500). The reply says when the list was cut.",
"exclusiveMinimum": 0
},
"date_to": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "A date, yyyy-mm-dd."
},
"user_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"date_from": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "A date, yyyy-mm-dd."
},
"matter_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
}
