Configuration Tools

7 tools for managing business hours, call routing, greetings, and notification settings.

frontdesk_get_config

Retrieve the current workspace configuration including business hours, timezone, greeting messages, and routing rules.

POSTtools/frontdesk_get_config
ParameterTypeDescription
sectionstringSpecific config section: hours, routing, greetings, notifications, all.Default: all
Response
200 OK
{
  "workspace_id": "ws_abc123",
  "business_name": "Riverside Family Dental",
  "timezone": "America/New_York",
  "hours": {
    "monday": { "open": "08:00", "close": "17:00" },
    "tuesday": { "open": "08:00", "close": "17:00" },
    "wednesday": { "open": "08:00", "close": "17:00" },
    "thursday": { "open": "08:00", "close": "19:00" },
    "friday": { "open": "08:00", "close": "15:00" },
    "saturday": { "open": "09:00", "close": "13:00" },
    "sunday": null
  },
  "routing": {
    "default_action": "ai_receptionist",
    "after_hours_action": "voicemail",
    "overflow_action": "queue"
  }
}

frontdesk_update_hours

Update business hours for one or more days of the week. Changes take effect immediately.

POSTtools/frontdesk_update_hours
ParameterTypeDescription
hoursrequiredobjectObject mapping day names to { open, close } or null for closed.
Exampletypescript
const result = await mcp.callTool("frontdesk_update_hours", {
  hours: {
    saturday: { open: "10:00", close: "14:00" },
    sunday: null // closed
  }
});

frontdesk_set_greeting

Configure the AI receptionist greeting message. You can set different greetings for business hours and after hours, and customize the tone and style.

POSTtools/frontdesk_set_greeting
ParameterTypeDescription
typerequiredstringGreeting type: business_hours, after_hours, holiday.
messagerequiredstringThe greeting message text.
voice_idstringVoice to use for the greeting (from Retell AI voices).

frontdesk_set_routing_rules

Configure how incoming calls are routed. Define rules based on caller information, time of day, staff availability, and call purpose.

POSTtools/frontdesk_set_routing_rules
ParameterTypeDescription
rulesrequiredRoutingRule[]Array of routing rules in priority order.
Exampletypescript
const result = await mcp.callTool("frontdesk_set_routing_rules", {
  rules: [
    {
      condition: "caller_is_vip",
      action: "transfer",
      target: "staff_manager",
      priority: 1
    },
    {
      condition: "purpose_is_emergency",
      action: "transfer",
      target: "on_call_staff",
      priority: 2
    },
    {
      condition: "default",
      action: "ai_receptionist",
      priority: 99
    }
  ]
});
Routing Changes Are Immediate
Changes to routing rules take effect immediately for all new incoming calls. Test changes during low-traffic periods when possible.

Search Documentation

Search for pages, tools, and guides