LiveAgent × Metabase

How to build LiveAgent support dashboards in Metabase

LiveAgent is a multi-channel help desk that brings email, live chat, calls, and social messages into one ticketing system. Metabase is where you turn that activity into shared, trustworthy dashboards. This guide covers two complementary paths: a lightweight MCP + CLI routethat pulls live data with the LiveAgent MCP server and loads a CSV into Metabase with the Metabase CLI for quick analysis, and a durable pipeline route that syncs LiveAgent into a database so you can build dashboards anyone can read.

Heads up: Metabase connects to databases and warehouses — it does not ship a native LiveAgent connector. For dashboards that need history and reliability, you'll sync LiveAgent into a database first (covered below).

How do you connect LiveAgent to Metabase?

Most teams combine both routes: use the LiveAgent MCP server and Metabase CLI route to pull live data and stand up a quick analysis, and the pipeline route for the dashboards people depend on.

1 · MCP + CLI route (AI-assisted)

Live data in, quick analysis out

Pair LiveAgent's built-in MCP server (to read live ticket data across email, chat, and calls) with the Metabase CLI, whose upload command loads a CSV into Metabase as a ready-to-query table and model.

Best for
  • Quick lookups like "what's open in the support department?"
  • Loading a LiveAgent CSV export into Metabase in seconds
  • Spot-checks and one-off analyses without a warehouse
Trade-offs
  • Great for exploration, not governed reporting
  • MCP actions run as your agent identity and appear in ticket history
  • CSV uploads are snapshots — refresh or move to the pipeline for history
2 · Pipeline route (warehouse-backed)

Durable dashboards with history

Sync LiveAgent into a database or warehouse with dlt or the REST API, then point Metabase at it.

Best for
  • Volume, response-time, and channel-mix dashboards the team relies on
  • Trends over quarters and year-over-year comparisons
  • Joining support data with CRM or product data
Trade-offs
  • No first-party managed connector — plan on API or dlt-based sync
  • You own the data model and refresh schedule
  • Capture ticket events for accurate time-in-status

What can you analyze from LiveAgent data in Metabase?

  • Ticket volume — created vs. resolved by day and channel
  • First response time — how long customers wait for a reply
  • Channel mix — email vs. chat vs. call vs. social
  • Department health — backlog and load by department
  • Backlog and aging — open work and how long it's been waiting
  • Agent performance — workload distribution and handle time
  • Repeat contacts — customers writing in repeatedly

Which LiveAgent dashboards should you build in Metabase?

For: Support leads

Support overview

The daily pulse across channels.

  • Tickets created vs. resolved per day (dual line)
  • Median first response time (number + trend)
  • Open backlog by status (bar)
  • Volume by channel (email, chat, call, social) (bar)
For: Support ops

Response time & SLA

Are we replying within target?

  • First response time p50/p90 by week (line)
  • Open tickets by department (bar)
  • Aging open tickets by days-open bucket (table)
  • Reopened tickets by week (line)
For: Team managers

Agent performance

Balance workload across the team.

  • Resolved tickets by agent (bar)
  • Median handle time by agent (bar)
  • Open assigned tickets by agent (table)
  • Calls handled by agent (bar)
For: CX leadership

Channels & drivers

Understand what's driving contacts.

  • Volume by channel over time (line)
  • Volume by tag/topic (bar)
  • Volume by hour of day (bar)
  • Repeat-contact customers (table)

How do you use the LiveAgent MCP server with the Metabase CLI?

Pair the LiveAgent MCP server with the Metabase CLI for fast, hands-on analysis. LiveAgent exposes a built-in MCP server that reads current ticket data across channels; the Metabase CLI's upload command loads a CSV into Metabase and creates a ready-to-query table and model.

Example workflow

  • Ask the LiveAgent MCP for open tickets in the support department, or tickets with no agent reply in four hours.
  • Export the tickets or messages you want to keep as a CSV.
  • Run mb upload csv to load it into Metabase as a table and model, then build questions and dashboards on top.

Be honest about the limits

  • The LiveAgent MCP is great for live lookups — not for scheduled or audited reporting.
  • Actions run as your agent identity and appear in the ticket activity history.
  • A CSV upload is a point-in-time snapshot; refresh it with mb upload replace or move to the pipeline for real history.
  • mb upload csv needs an uploads database configured under Admin → Settings → Uploads.

How do you set up the LiveAgent MCP server and the Metabase CLI?

LiveAgent MCPofficial

Endpoint
https://YOUR_ACCOUNT.ladesk.com/public/api/mcp
Transport
Streamable HTTP
Auth
Bearer token or OAuth 2.1 + PKCE
Note
Generate an MCP access token in your agent profile.

Metabase CLIofficial

Install
npm install -g @metabase/cli
Auth
mb auth login (browser OAuth on v62+, or an API key)
Load data
mb upload csv --file data.csv
Requires
An uploads database (Admin → Settings → Uploads)
Cursor~/.cursor/mcp.json or .cursor/mcp.json
{
  "mcpServers": {
    "liveagent": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://YOUR_ACCOUNT.ladesk.com/public/api/mcp"
      ]
    }
  }
}
TerminalLoad a LiveAgent CSV with the Metabase CLI
# Install the Metabase CLI
npm install -g @metabase/cli

# Log in (opens your browser; requires Metabase v62+)
mb auth login --url https://your-metabase.example.com

# Load a LiveAgent CSV export — creates a table AND a model
mb upload csv --file liveagent-tickets.csv --collection root

# Refresh that same table later from a new export
mb upload replace <table-id> --file liveagent-tickets.csv

Replace YOUR_ACCOUNT with your LiveAgent subdomain. For Bearer auth, generate an MCP token in your agent profile and pass it in the Authorization header. The Metabase CLI stores its credentials securely after mb auth login.

Verify before shipping: confirm an uploads database is enabled under Admin → Settings → Uploads (Metabase docs) and the current LiveAgent MCP setup in the LiveAgent docs.

Can you generate a LiveAgent dashboard with AI?

Yes. Use the prompt below with any assistant that can run the LiveAgent MCP server and the Metabase CLI. It works end to end: if LiveAgent tables already exist in Metabase it analyzes those; otherwise it pulls the data over the LiveAgent MCP, loads it with mb upload csv, then builds the dashboard — using medians and skipping cards it has no data for.

Prompt for creating a LiveAgent Support Overview dashboard
Create a polished Metabase dashboard for LiveAgent support analytics.
Work end to end: get the data into Metabase if it isn't there yet, then build.

Goal: Help support leaders understand multi-channel volume, responsiveness,
department health, and agent workload from LiveAgent data.

Step 1 — Find or load the data:
- First, check what already exists in Metabase (search for LiveAgent tables and
  models). If durable LiveAgent data is already present — synced from a warehouse
  or uploaded earlier — use it and skip to Step 2.
- If nothing is there, pull it with the LiveAgent MCP server: tickets, messages,
  agents, contacts, and departments. Write each result to a CSV, then load it
  with the Metabase CLI — run "mb upload csv --file <export>.csv" so each upload
  creates a table and a ready-to-query model. Use "mb upload replace <table-id>
  --file <export>.csv" to refresh an existing table instead of creating
  duplicates.

Step 2 — Inspect before querying:
Do not assume exact table names. Map the available raw tables into these
analytical concepts where possible: Tickets, Messages, Agents, Contacts,
Departments, Tags, and Channels (email, chat, call, social). Inspect the actual
tables and column names first.

Important:
- Build on whatever data is present; don't claim Metabase connects natively to
  LiveAgent — it reads a database or CLI-uploaded tables.
- Use medians (p50) and p90 for response times, never averages.
- Define "first response" as the first outbound agent message, excluding internal
  notes and automated messages.
- If ticket event history is missing, do not calculate reopen rate or
  time-in-status. Use a caveat instead.
- Only build a card if its underlying column/metric exists in the data.
- A single CSV is a point-in-time snapshot: only build trend cards if there is a
  usable date column or multiple periods have been uploaded.

Dashboard title: LiveAgent Support Overview

Sections:
1. Executive summary (KPI cards): Tickets created last 7 days; Resolved last 7
   days; Open backlog; Median first response time; Volume by channel.
2. Volume & backlog: Created vs resolved by day; Open by status; Backlog aging;
   Volume by channel.
3. Response time & SLA: First response p50/p90 by week; Open by department;
   Reopened by week (only if history exists).
4. Agent performance: Resolved by agent; Median handle time by agent; Open
   assigned by agent; Calls by agent.
5. Channels & drivers: Volume by channel over time; Volume by tag; Volume by hour;
   Repeat contacts.

Filters: Department, Agent, Channel, Tag, Status, Date range.

Reuse the models Metabase auto-created from uploaded CSVs, or (for a warehouse)
create reusable models: modeled_liveagent_tickets, modeled_liveagent_messages,
modeled_liveagent_agents, modeled_liveagent_contacts, and
modeled_liveagent_departments.

Output: Build the dashboard if you have permission; otherwise provide the exact
questions, SQL, model definitions, and layout. Include caveats for any metric
that cannot be calculated from the available data. Keep it practical, dense,
and executive-readable. Avoid vanity metrics.

How do you build the LiveAgent → Metabase pipeline?

Every pipeline is the same four stages: extract from LiveAgent's API, load into a database, model the raw tables into clean ones, and visualize in Metabase. You can assemble this with a managed connector or a free script you host yourself.

No paid tool required. A fully free stack: a small dlt or hand-written script (extract) → a free Postgres database like Neon or Supabase (load) → a scheduler such as GitHub Actions cron (host) → Metabase (visualize). For hosting and scheduling details, see our data pipeline guide.

Connector options

  • dlt (free, code) — write a Python pipeline against the LiveAgent REST API (v3); the most reliable route since there's no first-party managed connector.
  • LiveAgent REST API (v3) (free, raw) — the source of truth; paginate tickets, messages, agents, and departments and upsert on a schedule.
  • Managed ETL (paid, managed) — check whether your ETL vendor offers a LiveAgent connector; availability varies, so confirm before relying on it.

Notes

  • Land raw tables first, then build clean models on top.
  • Sync messages so you can compute response times and channel mix accurately.
  • Capture ticket events if you want accurate reopen rate and time-in-status.

How should you model LiveAgent data in Metabase?

Core tables

TableGrainKey columns
ticketsone row per ticketid, status, channel, department_id, agent_id, contact_id, date_created, date_resolved
messagesone row per messageticket_id, type (agent/customer), is_note, date_created
agentsone row per agentid, name, online
contactsone row per contactid, email, name
departmentsone row per departmentid, name

Modeling advice

  • Map LiveAgent's coded statuses and channel types to readable labels in a model — raw API data is coded.
  • Define first response from the first outbound agent message, excluding notes.
  • Treat tags as a bridge table so a ticket can carry many tags.
  • Keep call tickets separate where handle time means talk time, not reply time.
  • Define "resolved" once and reuse it everywhere.

Which LiveAgent metrics should you track in Metabase?

MetricDefinitionNotes
First response timeCreated → first agent message.Report median and p90; exclude notes.
Ticket volumeCreated vs. resolved in a period.Segment by channel and department.
Channel mixShare of tickets by channel.Email, chat, call, and social behave differently.
BacklogOpen tickets right now.Pair with aging and department breakdowns.
Agent loadOpen and resolved tickets per agent.Frame as balance, not a leaderboard.
Repeat-contact rateCustomers with multiple tickets.A signal of unresolved root causes.

What SQL powers LiveAgent dashboards in Metabase?

These assume the modeled tables above (PostgreSQL dialect; LiveAgent uses coded statuses such as R for resolved). Adjust identifiers to match your warehouse.

Tickets created vs. resolved per dayPostgreSQL

The basic volume trend over the last 30 days.

SELECT
  date_trunc('day', t.date_created) AS day,
  COUNT(*)                                          AS created,
  COUNT(*) FILTER (WHERE t.status = 'R')            AS resolved
FROM tickets t
WHERE t.date_created >= CURRENT_DATE - INTERVAL '30 days'
GROUP BY 1
ORDER BY 1;
First response time by weekPostgreSQL

Median from the first outbound agent message per ticket.

WITH first_outbound AS (
  SELECT
    m.ticket_id,
    MIN(m.date_created) AS first_reply_at
  FROM messages m
  WHERE m.type = 'A'        -- agent message
    AND m.is_note = false
  GROUP BY m.ticket_id
)
SELECT
  date_trunc('week', t.date_created) AS week,
  percentile_cont(0.5) WITHIN GROUP (
    ORDER BY EXTRACT(EPOCH FROM (f.first_reply_at - t.date_created)) / 60.0
  ) AS median_first_reply_min
FROM tickets t
JOIN first_outbound f ON f.ticket_id = t.id
GROUP BY 1
ORDER BY 1;
Volume by channelPostgreSQL

Multi-channel mix over the last 30 days.

SELECT
  t.channel,
  COUNT(*)           AS tickets
FROM tickets t
WHERE t.date_created >= CURRENT_DATE - INTERVAL '30 days'
GROUP BY t.channel
ORDER BY tickets DESC;
Open backlog by departmentPostgreSQL

Where open tickets are piling up right now.

SELECT
  d.name             AS department,
  COUNT(*)           AS open_tickets
FROM tickets t
JOIN departments d ON d.id = t.department_id
WHERE t.status <> 'R'
GROUP BY d.name
ORDER BY open_tickets DESC;

What are common mistakes when analyzing LiveAgent in Metabase?

Treating a live MCP lookup or a one-off CSV as governed reporting.→ Use the LiveAgent MCP and CSV uploads for triage and exploration; build warehouse-backed Metabase dashboards for anything people depend on.
Leaving statuses and channels as raw codes.→ Map coded values to readable labels in a model.
Mixing call handle time with reply time.→ Calls measure talk time; email/chat measure reply time — keep them distinct.
Using averages for response time.→ Report medians and p90 — these durations are heavily right-skewed.
Counting internal notes as customer replies.→ Restrict first response to outbound agent messages.

Related analytics

Related integrations

FAQ

Does Metabase connect natively to LiveAgent?
No. Metabase reads SQL databases and warehouses. Sync LiveAgent into a database first (dlt or the REST API v3), then connect Metabase to that database.
Does LiveAgent have a built-in MCP server?
Yes. LiveAgent exposes a built-in MCP server at https://YOUR_ACCOUNT.ladesk.com/public/api/mcp over Streamable HTTP, with Bearer token or OAuth 2.1 + PKCE auth. Actions run as your agent identity.
How do I quickly analyze LiveAgent data without a warehouse?
Pull the tickets and messages you need with the LiveAgent MCP server, export them to CSV, and run `mb upload csv --file data.csv` with the Metabase CLI. It creates a table and a model you can build questions on right away. You'll need an uploads database enabled under Admin → Settings → Uploads. Refresh later with `mb upload replace`, or move to the pipeline route when you need history.
How do I handle call tickets in metrics?
Keep call tickets separate where it matters: for calls, handle time is talk time, while for email and chat it's reply time. Mixing them distorts both.