List cases
Support cases with status, priority, group, owner and contact.
MCP tool vtiger_read → list_cases
read
Lists one page of cases from Main Menu > Support > Cases. status is one of New, Assigned, Open, Wait for 3rd party, Wait for customer, Resolved or Closed, and priority one of Urgent, High, Medium or Low. group is the team the case is assigned to. Pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | New, Assigned, Open, Wait for 3rd party, Wait for customer, Resolved or Closed. |
| priority enum | enum | Urgent, High, Medium or Low. |
| group string | string | Only cases assigned to this group. |
| assigned_to string | string | Only cases assigned to this user. |
| limit integer | integer | Cases per page. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "vtiger_read",
"arguments": {
"operation": "list_cases",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"cases": [
{
"record_id": "3318",
"title": "Invoice 1042 charged twice",
"status": "New",
"priority": "Medium",
"group": "Support",
"assigned_to": null,
"contact": "Dana Whitfield",
"created_at": "2026-10-22 08:14"
},
{
"record_id": "3319",
"title": "Cannot log in to the customer portal",
"status": "New",
"priority": "Medium",
"group": "Support",
"assigned_to": null,
"contact": "Luis Ortega",
"created_at": "2026-10-22 08:31"
}
],
"next_cursor": null
},
"isError": false
}