list_matters

Free

Returns a paginated list of all matters associated with the current session's operator account. Can be filtered by status.

Parameters

Name	Type	Required	Description
session_token	string	Required	The session token from start_session
status	string	Optional	Filter by status (pending_retainer, active, completed, archived)
limit	number	Optional	Maximum results to returnDefault: 20
offset	number	Optional	Number of results to skipDefault: 0

Returns

Name	Type	Description
matters	Matter[]	Array of matters
total	number	Total number of matters
has_more	boolean	Whether more results exist

Example

typescript

const result = await mcp.callTool("list_matters", {
  session_token: "sess_xyz789...",
  status: "active",
  limit: 10
});
 
result.matters.forEach(matter => {
  console.log(`${matter.title}: ${matter.status}`);
});