LiveChat MCP server for your AI

Pull up a live chat and its threads, search the archive, close or reopen conversations, invite and suspend agents, and read per-agent good/bad ratings from your AI client.

PopMCPLiveChat

Which agents had the most bad ratings in the last 30 days?

Contact support Connect

Supported LiveChat tools

Every chat, agent, customer, group, tag and report operation the connection exposes, plus the webhook triggers your AI can watch for.

livechat_report_agent_performance

Reports/agents: per-agent totals (chats, good/bad rates, chatting/accepting/logged-in time).

livechat_report_ratings

Reports/chats: count of rated chats with a good/bad breakdown.

livechat_report_tag_chat_usage

Reports/tags: total chats per tag across the account.

livechat_report_total_chats

Reports/chats: number of chats over the period.

livechat_list_bots

List bots on the license.

livechat_create_agent

Create (invite) an agent on the license.

livechat_deactivate_chat

Deactivate (close) a chat by closing its open thread.

livechat_follow_chat

Follow a chat (receive its pushes).

livechat_get_agent

Get one agent by id (email).

livechat_get_chat

Get a chat (optionally a specific thread).

livechat_list_agents

List all agents on the license.

livechat_list_archives

Search archived (closed) chats.

livechat_list_chats

List chats the agent can access (active + recent).

livechat_list_threads

List the threads in a chat.

livechat_resume_chat

Restart an archived chat.

livechat_start_chat

Start a new chat.

livechat_suspend_agent

Suspend an agent.

livechat_unfollow_chat

Stop following a chat.

livechat_unsuspend_agent

Unsuspend an agent.

livechat_update_agent

Update an agent.

livechat_update_chat_properties

Set custom properties on a chat.

livechat_ban_customer

Ban a customer for a number of days.

livechat_create_customer

Create a customer record.

livechat_create_group

Create a group (team).

livechat_get_customer

Get a customer's details by id.

livechat_get_group

Get one group by id.

livechat_list_customers

List customers (paginated).

livechat_list_greetings

List greetings (paginated).

livechat_list_groups

List all groups.

livechat_mark_events_as_seen

Mark events seen up to a timestamp.

livechat_send_event

Send an event to a chat.

livechat_send_rich_message_postback

Trigger a rich-message button postback.

livechat_send_typing_indicator

Send a typing indicator to a chat.

livechat_update_customer

Update a customer.

livechat_update_group

Update a group.

livechat_create_tag

Create a chat tag scoped to a group.

livechat_delete_tag

Delete a tag.

livechat_list_channels

List the communication channels active on the license.

livechat_list_tags

List tags.

livechat_list_agents_for_transfer

List agents available as transfer targets for a chat, with their routing status and load.

livechat_list_routing_statuses

List the current routing status of agents/bots.

livechat_set_routing_status

Set an agent/bot routing status.

livechat_add_user_to_chat

Add an agent or customer to a chat.

livechat_list_customer_bans

List active customer bans.

livechat_remove_user_from_chat

Remove an user from a chat.

livechat_tag_thread

Add a tag to a thread.

livechat_unban_customer

Lift a customer ban.

livechat_untag_thread

Remove a tag from a thread.

livechat_get_license_info

Get basic info about the connected license.

livechat_transfer_chat

Transfer a chat to an agent or group.

livechat_report_agent_availability

Reports/agents: time agents were available, by timeframe.

livechat_report_chat_tags

Reports/chats: tag distribution across chats.

livechat_report_duration

Reports/chats: average chat duration.

livechat_report_engagement

Reports/chats: chat distribution by engagement source (greeting/direct/manual).

livechat_report_first_response_time

Reports/chats: average agent first-response time.

livechat_report_forms

Reports/chats: form submissions and answer frequency (distribution ignored).

livechat_report_greetings_conversion

Reports/chats: greetings sent vs.

livechat_report_ranking

Reports/chats: agent ranking by good/bad rating ratio (distribution ignored).

livechat_report_response_time

Reports/chats: average agent response time.

livechat_create_bot

Create a bot agent (can receive chats and webhooks).

livechat_create_bot_template

Create a bot template that auto-deploys bots when the app installs.

livechat_delete_bot

Delete a bot.

livechat_delete_bot_template

Delete a bot template.

livechat_get_bot

Get one bot by id.

livechat_issue_bot_token

Issue a 24h bot token for the Agent Chat API.

livechat_list_bot_templates

List bot templates for a Client ID.

livechat_reset_bot_secret

Reset a bot's secret.

livechat_reset_bot_template_secret

Reset a bot template's secret.

livechat_update_bot

Update a bot.

livechat_update_bot_template

Update a bot template.

livechat_delete_group_properties

Delete group-scoped property values.

livechat_delete_license_properties

Delete license-scoped property values.

livechat_list_groups_properties

Read group-scoped property values.

livechat_list_license_properties

Read license-scoped property values.

livechat_list_properties

List registered property definitions.

livechat_publish_property

Make a private property readable by all Client IDs.

livechat_register_property

livechat_unregister_property

Remove a registered property.

livechat_update_group_properties

Set group-scoped property values.

livechat_update_license_properties

Set license-scoped property values.

livechat_approve_agent

Approve an agent awaiting approval.

livechat_batch_approve_agents

Batch approve agents.

livechat_batch_create_agents

Batch create agents.

livechat_batch_create_bots

Batch create bots.

livechat_batch_delete_agents

Batch delete agents.

livechat_batch_delete_bots

Batch delete bots.

livechat_batch_suspend_agents

Batch suspend agents.

livechat_batch_unsuspend_agents

Batch unsuspend agents.

livechat_batch_update_agents

Batch update agents.

livechat_batch_update_bots

Batch update bots.

livechat_delete_agent

Delete an agent.

livechat_request_agent_unsuspension

As a suspended agent, request unsuspension from the license owner/vice owners.

livechat_disable_license_webhook

Disable the license's webhooks for a Client ID.

livechat_enable_license_webhook

Enable the license's webhooks for a Client ID.

livechat_get_license_webhooks_state

Get the enabled/disabled state of the license's webhooks for a Client ID.

livechat_list_webhook_names

List every subscribable webhook event name.

livechat_list_webhooks

List registered webhooks.

livechat_register_webhook

livechat_unregister_webhook

Delete a webhook.

livechat_delete_chat_properties

Delete custom properties from a chat.

livechat_delete_event_properties

Delete properties from an event.

livechat_delete_thread_properties

Delete properties from a thread.

livechat_update_event_properties

Set properties on an event.

livechat_update_thread_properties

Set properties on a thread.

livechat_create_greeting

Create a targeted greeting/announcement.

livechat_delete_greeting

Delete a greeting.

livechat_delete_group

Delete a group.

livechat_get_greeting

Get one greeting by id.

livechat_multicast

Send a transient, chat-unrelated message to selected recipients (not persisted).

livechat_update_greeting

Update a greeting (partial).

livechat_add_auto_access

Add an auto-access rule that routes customers to groups by URL/domain/geolocation.

livechat_check_product_limits_for_plan

Check product/feature limits for a plan.

livechat_delete_auto_access

Delete an auto-access rule.

livechat_list_auto_accesses

List auto-access rules in order.

livechat_reactivate_email

Re-enable a bounced/deactivated email address.

livechat_update_auto_access

Update an auto-access rule.

livechat_update_company_details

Update the license's company details.

livechat_update_tag

Update a tag (e.g.

Connect LiveChat to your AI

Credentials off one LiveChat screen, then an endpoint your client signs into. Nothing to deploy, and nothing to install.

In the LiveChat Developer Console (platform.text.com/console → Tools → Personal Access Tokens), create a token with all scopes, then paste the Account ID and Personal Access Token. Scoped to that one account.

Account IDb7eff798-f8df-4364-8059-649c35c9ed0c

Personal Access Token••••••••••••3f7a

ConnectionVerified

Drop the PopMCP URL into Claude, ChatGPT, Codex or any other supported client. It signs in through PopMCP with OAuth, so your LiveChat credential never leaves the server.

app.popmcp.com/mcp/…

Claude wants to connectApprove

Ask for something harmless before you turn writes on. Once it comes back clean, widen the tool set or switch the connection to full access.

Which agents had the most bad ratings in the last 30 days?

livechat_report_ratingsok

Then just ask for the work

“Which agents had the most bad ratings in the last 30 days?”
- report_ratings
- report_agent_performance
- list_agents
“Close every chat still sitting open from before Friday”
- list_chats
- list_threads
- deactivate_chat
“Spin up a Billing group, add a refunds tag to it, and invite Dana”
- create_group
- create_tag
- create_agent
“Who can take over customer 8fd2's chat right now?”
- get_customer
- list_chats
- list_agents_for_transfer

Contact support View docs

Use LiveChat from the assistant you already open

One hosted endpoint, registered once per client. The same tools and the same permissions, whichever window the request comes from.

Claude DesktopCustom connector

Add the PopMCP URL under Settings → Connectors and the tools appear in every chat.

Claude WebCustom connector

The same endpoint, registered in the browser. Nothing to install on the machine you are working from.

ChatGPTCustom connector

CodexDesktop & CLI

Wire the endpoint into Codex or the Codex CLI when a task needs live business context, not a fixture.

OpenCodeCoding agent

ZCodeDesktop app

Add PopMCP as an MCP server in Z.ai's desktop app and work the account from the same window.

Contact support View docs

FAQ

LiveChat MCP server questions

What teams ask before putting LiveChat behind an AI client.

Do I have to set up an OAuth app or a redirect URL?

No. LiveChat connects with a Personal Access Token, so there is no OAuth app, redirect URL or client secret to register, and nothing to re-authenticate later. You create the token in the LiveChat Developer Console and paste two values into the connect form: Account ID and Personal Access Token. PopMCP authenticates server-side over HTTPS using HTTP Basic.

Which scopes should I pick when I create the Personal Access Token?

Select all of them. The token you generate at platform.text.com/console under Tools → Personal Access Tokens carries whatever scopes you tick, and anything you leave unticked blocks the matching operations at call time. Selecting everything means nothing is silently unavailable; you narrow what the agent can actually do with PopMCP's access mode and approval settings instead.

Can it look at chats that have already been closed?

Yes. list_archives searches archived chats, and get_chat plus list_threads open a specific conversation and its threads. If someone needs to pick a closed conversation back up, resume_chat restarts an archived chat. Reporting on closed volume goes through report_total_chats and report_tag_chat_usage.

Why does creating a tag ask which group it belongs to?

Chat tags in LiveChat are scoped to a group rather than to the whole license, so create_tag needs the group it should apply to. Call list_groups first if you are not sure which team owns the tag, and list_tags to see what already exists before adding a near-duplicate. delete_tag removes one, which is a good candidate for approval-required writes.

Can the agent change agents, bots and groups, or only conversations?

Both. Alongside the chat and event operations, the connection covers the Configuration API: agents, bots, groups, custom properties, webhooks, auto-access rules, customer bans, greetings, tags, license and channels, plus batch agent and bot operations. That is 118 operations across 21 API modules in total, 42 read and 76 write. The 50 in the curated default set load into your client and the rest stay searchable, or you can turn on the full catalog.

Can it post into a conversation a visitor is currently in?

Yes, and that is worth thinking about before you allow it. send_event posts into a chat, send_typing_indicator and send_rich_message_postback drive the visitor-facing experience, and start_chat opens a new conversation outright. If you only want the agent reading and reporting, set the connection to read-only; if you want it to draft replies, keep writes on with approval required so a person sees the message before the visitor does.

Do I have to run or host the LiveChat MCP server myself?

No. PopMCP hosts it and gives you a Streamable HTTP MCP URL. There is nothing to deploy, no callback URL to register, and no infrastructure to keep running or patch.

Which AI clients can use this MCP server?

Any client that supports a remote Streamable HTTP MCP server — Claude Desktop, Claude Web, ChatGPT custom connectors, Codex and the Codex CLI, OpenCode and Z.ai's ZCode, as well as editors such as Cursor, Windsurf and Zed. Your client signs in to PopMCP with OAuth; the provider credential never leaves the server.

Why do only 50 of the 118 tools load by default?

Loading 118 tool definitions into every conversation burns context before the work starts. PopMCP loads a curated 50-tool set covering the everyday workflows and keeps the rest searchable, so your AI pulls a specialist tool only when a task needs it. You can switch a connection to the full catalog at any time.

What is the difference between a tool and a trigger?

A tool is something your AI calls — there are 118 here. A trigger is something PopMCP watches for you: 18 LiveChat events that can start work on the PopMCP side. Triggers never enter your AI client's context, and none of them ask you to paste a callback URL into LiveChat.

Connect LiveChat to your AI in minutes

Launch a hosted MCP endpoint for LiveChat, keep tool access under control, and start testing real workflow prompts right away.

Connect your first MCP