List events
Events by status, date range, room or location, with guest count and amount due.
MCP tool tripleseat_read → list_events
read
Lists events that overlap your date range, each with name, status, room, date, times, owner, contact and guest count, plus the grand total and amount due. Filter by one status: Prospect, Tentative, Definite, Closed or Lost. Results come 50 per page; use the cursor for the rest. Pass event_id to get_event for the full record.
Parameters
| Name | Type | Description |
|---|---|---|
| status string | string | Prospect, Tentative, Definite, Closed or Lost. |
| date_from date | date | Events that touch this date or later. |
| date_to date | date | Events that touch this date or earlier. |
| room_id integer | integer | Only events in this room, from list_rooms. |
| location_id integer | integer | Only this location. Needed if your account has more than one. |
| limit integer | integer | 1 to 50. Default: 50. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "tripleseat_read",
"arguments": {
"operation": "list_events",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"events": [
{
"event_id": 5528840,
"name": "Alvarez rehearsal dinner",
"status": "Definite",
"event_date": "2026-10-09",
"start": "18:00",
"end": "22:00",
"room": "Garden Room",
"owner": "Sam Reyes",
"guest_count": 36,
"grand_total": 4280,
"amount_due": 0
}
],
"next_cursor": null
},
"isError": false
}