Call Management Tools

10 tools for managing incoming calls, outgoing calls, voicemails, transcripts, and call routing.

frontdesk_list_calls

Retrieve a paginated list of calls with filtering and sorting options. Returns call metadata including caller information, duration, status, and AI-generated summaries.

POSTtools/frontdesk_list_calls

Parameter	Type	Description
`date`	`string`	Filter by date (ISO 8601 format, e.g. 2025-01-15).
`date_from`	`string`	Start of date range filter.
`date_to`	`string`	End of date range filter.
`status`	`string`	Filter by call status: completed, missed, voicemail, in_progress.Default: `all`
`direction`	`string`	Filter by direction: inbound or outbound.Default: `all`
`caller_phone`	`string`	Filter by caller phone number.
`limit`	`number`	Maximum number of results to return.Default: `20`
`offset`	`number`	Number of results to skip for pagination.Default: `0`
`sort`	`string`	Sort order: newest or oldest.Default: `newest`

Exampletypescript

const result = await mcp.callTool("frontdesk_list_calls", {
  date: "2025-01-15",
  status: "completed",
  direction: "inbound",
  limit: 5
});

Response

200 OK

{
  "calls": [
    {
      "id": "call_01abc",
      "direction": "inbound",
      "caller_name": "John Smith",
      "caller_phone": "+1-555-0123",
      "duration_seconds": 142,
      "status": "completed",
      "summary": "Scheduled annual check-up for Jan 22nd at 2pm",
      "sentiment": "positive",
      "tags": ["appointment", "new-patient"],
      "staff_member": "Dr. Sarah Johnson",
      "created_at": "2025-01-15T09:30:00Z"
    }
  ],
  "total": 1,
  "has_more": false
}

frontdesk_get_call

Get detailed information about a specific call including the full transcript, recording URL, and any actions taken during the call.

POSTtools/frontdesk_get_call

Parameter	Type	Description
`call_id`required	`string`	The unique identifier of the call.
`include_transcript`	`boolean`	Include the full call transcript.Default: `true`
`include_recording_url`	`boolean`	Include a signed URL for the call recording.Default: `false`

frontdesk_transfer_call

Transfer an active call to another staff member or department. Supports warm transfers (with announcement) and cold transfers (direct handoff).

POSTtools/frontdesk_transfer_call

Parameter	Type	Description
`call_id`required	`string`	The active call to transfer.
`target`required	`string`	Staff member ID or department name to transfer to.
`transfer_type`	`string`	Type of transfer: warm or cold.Default: `warm`
`announcement`	`string`	Message to announce to the target before connecting (warm transfer only).

frontdesk_create_callback

Schedule a callback for a missed call or a caller who requests one. The callback is assigned to the appropriate staff member and tracked in the system.

POSTtools/frontdesk_create_callback

Parameter	Type	Description
`phone`required	`string`	Phone number to call back.
`caller_name`	`string`	Name of the person to call back.
`reason`required	`string`	Reason for the callback.
`priority`	`string`	Priority level: low, normal, high, urgent.Default: `normal`
`assigned_to`	`string`	Staff member ID to assign the callback to.
`preferred_time`	`string`	Preferred callback time (ISO 8601).

Additional Call Tools

The call management category also includes frontdesk_search_transcripts, frontdesk_list_voicemails, frontdesk_tag_call, frontdesk_get_call_recording, frontdesk_update_call_notes, and frontdesk_get_active_calls. These tools follow the same patterns shown above.

frontdesk_search_transcripts

Search across all call transcripts using natural language queries. Powered by semantic search, this tool finds relevant conversations even when the exact words differ.

POSTtools/frontdesk_search_transcripts

Parameter	Type	Description
`query`required	`string`	Natural language search query.
`date_from`	`string`	Start of date range.
`date_to`	`string`	End of date range.
`limit`	`number`	Maximum results.Default: `10`