calls_calls
Retrieve, filter, and sort call records by tenant, date, duration, agent, or campaign using specific search parameters for precise querying within the ServiceTitan MCP Server.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"tenant": "<tenant>"
},
"name": "calls_calls"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| active | No | What kind of items should be returned (only active items will be returned by default) Values: [True, Any, False] | |
| agentExternalId | No | Format - int64. Agent external ID (number) | |
| agentId | No | Format - int64. Agent ID (number) | |
| agentIsExternal | No | Is agent external flag (boolean) | |
| agentName | No | Agent name (string) | |
| callerPhoneNumber | No | The caller's phone number (string) | |
| campaignId | No | Format - int64. Campaign ID | |
| createdAfter | No | Format - date-time (as date-time in RFC3339). Return items created after certain date/time (in UTC) | |
| createdBefore | No | Format - date-time (as date-time in RFC3339). Return items created before certain date/time (in UTC) | |
| createdOnOrAfter | No | Format - date-time (as date-time in RFC3339). Return items created on or after certain date/time (in UTC) | |
| ids | No | Perform lookup by multiple IDs (maximum 50) | |
| includeTotal | No | Whether total count should be returned | |
| minDuration | No | Format - int32. Minimum call duration (number of seconds) | |
| modifiedAfter | No | Format - date-time (as date-time in RFC3339). Return items modified after certain date/time (in UTC) | |
| modifiedBefore | No | Format - date-time (as date-time in RFC3339). Return items modified before certain date/time (in UTC) | |
| modifiedOnOrAfter | No | Format - date-time (as date-time in RFC3339). Return items modified on or after certain date/time (in UTC) | |
| page | No | Format - int32. The logical number of page to return, starting from 1 | |
| pageSize | No | Format - int32. How many records to return (50 by default) | |
| phoneNumberCalled | No | The phone number that was called (string) | |
| sort | No | The Sorting field, possible values: Id, CreatedOn, ModifiedOn. The Sorting is ascending by default, add the '-' character to use descending (for example -Id) | |
| tenant | Yes | Format - int64. Tenant ID |