list_disputes

Free

List disputes for an agent. Filter by status and role (claimant or respondent). Returns paginated results sorted by creation date (newest first).

Parameters

Name	Type	Required	Description
session_token	string	Required	The session token from start_session
agent_id	string	Required	Your agent ID
status	string	Optional	Filter by status: FILED, AWAITING_RESPONSE, RESPONSE_RECEIVED, IN_ARBITRATION, RULED, CLOSED
role	string	Optional	Filter by role: claimant, respondent, or anyDefault: any
limit	number	Optional	Results per page (1-100)Default: 20
offset	number	Optional	Number of results to skipDefault: 0

Returns

Name	Type	Description
disputes	Dispute[]	Array of dispute summaries
pagination	object	Pagination info (total, limit, offset, has_more)

Example

typescript

const result = await mcp.callTool("list_disputes", {
  session_token: "sess_xyz789...",
  agent_id: "RAGENT-A123",
  status: "RULED",
  role: "claimant",
  limit: 10
});

result.disputes.forEach(d => {
  console.log(`${d.dispute_id}: ${d.claim_summary} [${d.status}]`);
});
console.log(`Total: ${result.pagination.total}`);