calls_get_calls

Retrieve call data filtered by parameters like agent ID, campaign ID, call duration, or date ranges. Use this tool to access and analyze call records within the ServiceTitan MCP Server.

Input Schema

Name	Required	Description
`activeOnly`	No
`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)
`campaignId`	No	Format - int64. Campaign ID
`createdAfter`	No	Format - date-time (as date-time in RFC3339).
`createdBefore`	No	Format - date-time (as date-time in RFC3339).
`createdOnOrAfter`	No	Format - date-time (as date-time in RFC3339). Created on or after a certain date/time (as date-time in RFC3339), inclusive
`ids`	No
`minDuration`	No	Format - int32. Minimum call duration (number)
`modifiedAfter`	No	Format - date-time (as date-time in RFC3339). Modified after a certain date/time (as date-time in RFC3339), not inclusive
`modifiedBefore`	No	Format - date-time (as date-time in RFC3339). Modified before a certain date/time (as date-time in RFC3339), not inclusive
`modifiedOnOrAfter`	No	Format - date-time (as date-time in RFC3339). Modified on or after a certain date/time (as date-time in RFC3339), inclusive
`orderBy`	No	Sorting (string with possible values Id (default), createdOn, or modifiedOn)
`orderByDirection`	No	Sorting direction (string with possible values asc (default) or desc)
`page`	No	Format - int32.
`pageSize`	No	Format - int32.
`phoneNumberCalled`	No	The phone number that was called (string)
`tenant`	Yes	Format - int64. Tenant ID

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "activeOnly": {
      "type": "boolean"
    },
    "agentExternalId": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "Format - int64. Agent external ID (number)"
    },
    "agentId": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "Format - int64. Agent ID (number)"
    },
    "agentIsExternal": {
      "description": "Is agent external flag (boolean)",
      "type": [
        "boolean",
        "null"
      ]
    },
    "agentName": {
      "description": "Agent name (string)",
      "type": "string"
    },
    "campaignId": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "Format - int64. Campaign ID"
    },
    "createdAfter": {
      "anyOf": [
        {
          "format": "date-time",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Format - date-time (as date-time in RFC3339)."
    },
    "createdBefore": {
      "anyOf": [
        {
          "format": "date-time",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Format - date-time (as date-time in RFC3339)."
    },
    "createdOnOrAfter": {
      "anyOf": [
        {
          "format": "date-time",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Format - date-time (as date-time in RFC3339). Created on or after a certain date/time (as date-time in RFC3339), inclusive"
    },
    "ids": {
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "minDuration": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "Format - int32. Minimum call duration (number)"
    },
    "modifiedAfter": {
      "anyOf": [
        {
          "format": "date-time",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Format - date-time (as date-time in RFC3339). Modified after a certain date/time (as date-time in RFC3339), not inclusive"
    },
    "modifiedBefore": {
      "anyOf": [
        {
          "format": "date-time",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Format - date-time (as date-time in RFC3339). Modified before a certain date/time (as date-time in RFC3339), not inclusive"
    },
    "modifiedOnOrAfter": {
      "anyOf": [
        {
          "format": "date-time",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Format - date-time (as date-time in RFC3339). Modified on or after a certain date/time (as date-time in RFC3339), inclusive"
    },
    "orderBy": {
      "description": "Sorting (string with possible values Id (default), createdOn, or modifiedOn)",
      "type": "string"
    },
    "orderByDirection": {
      "description": "Sorting direction (string with possible values asc (default) or desc)",
      "type": "string"
    },
    "page": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "Format - int32."
    },
    "pageSize": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "Format - int32."
    },
    "phoneNumberCalled": {
      "description": "The phone number that was called (string)",
      "type": "string"
    },
    "tenant": {
      "description": "Format - int64. Tenant ID",
      "type": "integer"
    }
  },
  "required": [
    "tenant"
  ],
  "type": "object"
}

Install Server

HTTP connection URL

ServiceTitan MCP Server

calls_get_calls

Input Schema

Input Schema (JSON Schema)

Other Tools from ServiceTitan MCP Server

Related Tools

MCP directory API