List agents and groups

Agents and groups a chat can be transferred to, with their current availability.

MCP tool livechat_read → list_agents

read

Returns the agents and groups shown in the Transfer to... dialog, with each agent's group and availability. Use the agent_id or group from here in transfer_chat. Transferring to a group lands on the first free agent in it, so no agent is chosen for a group.

Parameters

No parameters.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "livechat_read",
    "arguments": {
      "operation": "list_agents",
      "arguments": {}
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "agents": [
      {
        "agent_id": "maria@example.com",
        "name": "Maria Silva",
        "groups": [
          "Support"
        ],
        "available": true
      }
    ],
    "groups": [
      {
        "group": "Billing"
      },
      {
        "group": "Support"
      }
    ]
  },
  "isError": false
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.