SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate LiveChat MCP with Atomic Agent

Connect Atomic Agent to LiveChat MCP. List all active livechat agents, show open customer conversations needing replies, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
LiveChat logoLiveChat
Oauth2

LiveChat is a customer messaging platform for managing support conversations, agents, groups, and bots. It helps teams deliver faster, more organized customer support across live chat.

111 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including LiveChat.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a LiveChat account. See the Atomic Agent documentation for installation instructions.

Also integrate LiveChat with

ChatGPTClaude CoworkHermes

How Atomic Agent connects to LiveChat

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect LiveChat to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in LiveChat. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your LiveChat account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the LiveChat MCP server, and what's possible with it?

The LiveChat MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your LiveChat account. It provides structured and secure access to agents, groups, bots, webhooks, properties, greetings, tags, canned responses, and customer conversations, so your agent can manage support staff, handle customer chats, configure support workflows, and maintain LiveChat settings on your behalf.

  • Customer conversation management: Have your agent accept or cancel incoming greetings, retrieve customer chats, and close active conversations.
  • Agent and group administration: Let the agent create, approve, update, and delete agents, assign elevated roles, and create or remove routing groups.
  • Bot and greeting configuration: Direct your agent to create, inspect, and delete bots, bot templates, and customer greetings for automated support experiences.
  • Support content and tagging: Instruct your agent to create or delete canned responses and tags so agents can organize and reuse support content.
  • LiveChat settings and properties: Have your agent enable or disable license webhooks, manage custom properties for chats, threads, events, groups, and licenses, and retrieve customer forms, configurations, and localization settings.

Use LiveChat from Atomic Agent

With your account connected, ask Atomic Agent to work with LiveChat in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every LiveChat action and event your agent gets out of the box.

Accept Greeting

Accept an incoming LiveChat greeting for an existing customer and mark that greeting as seen in the customer's live session.

Approve Agent

Approve a licensed LiveChat agent so they can use the application.

Cancel Greeting

Cancel an incoming LiveChat invitation for an existing customer.

Check Product Limits for Plan

Read which current organization resources exceed a selected LiveChat plan's limits.

Create Agent

Create a normal-role licensed LiveChat user who must await approval.

Create Auto Access

Add an ordered LiveChat auto-access rule.

Create Bot

Create a LiveChat bot and return its write-once secret.

Create Bot Template

Create a bot template for an application client ID and return its write-once secret.

Create Bot Template Across Installations

Create a LiveChat bot template and also create a bot from it on every license where the app is already installed.

Create Canned Response

Create a group-owned LiveChat canned response.

Create Greeting

Create a LiveChat greeting with trigger rules and optional rich content.

Create Group

Create a LiveChat routing group with its initial language and agent-priority map.

Create Privileged Agent

Create a licensed LiveChat agent while explicitly bypassing approval and/or assigning an elevated administrator or viceowner role.

Create Tag

Create a LiveChat tag and optionally assign it to groups.

Deactivate Chat

Deactivate a LiveChat chat by closing its currently open thread.

Delete Agent

Permanently delete a licensed LiveChat agent.

Delete Auto Access

Permanently delete an auto-access rule.

Delete Bot

Permanently delete a LiveChat bot.

Delete Bot Template

Permanently delete only a bot template.

Delete Bot Template And Installed Bots

Permanently delete a LiveChat bot template and every bot installed from it across all licenses.

Delete Canned Response

Permanently delete one canned response by ID, removing it from agent use.

Delete Chat Properties

Permanently delete selected registered property values from a live customer chat.

Delete Event

Delete one event from a specified LiveChat chat and thread.

Delete Event Properties

Permanently delete selected registered property values from a live customer-chat event.

Delete Greeting

Permanently delete a greeting, immediately stopping it from appearing to new matching visitors.

Delete Group

Permanently delete one LiveChat group by ID.

Delete Group Properties

Delete selected custom property values from one LiveChat group without unregistering their definitions.

Delete License Properties

Delete selected license-level custom property values without unregistering their definitions.

Delete Tag

Permanently delete the exact case-sensitive LiveChat tag, removing it from workflows that rely on that tag.

Delete Thread Properties

Permanently delete selected registered property values from a live customer-chat thread.

Disable License Webhooks

Disable all webhooks across the connected LiveChat license.

Enable License Webhooks

Enable webhooks across the connected LiveChat license after they were explicitly disabled.

Evaluate Goals

Trigger LiveChat goal evaluation for an offline customer.

Get Agent

Return one LiveChat agent by ID, including any explicitly requested optional fields.

Get Bot

Return one LiveChat bot by ID with explicitly requested optional fields.

Get Customer

Return the customer profile for an explicit existing LiveChat entity through the server-side customer authorization bridge.

Get Customer Chat

Return one existing customer's LiveChat chat and either its latest thread or a specified thread.

Get Customer Configuration

Return versioned forms, buttons, integrations, and readable properties for a LiveChat customer group.

Get Customer Form

Return the enabled pre-chat or post-chat form for one LiveChat group.

Get Customer Localization

Return versioned customer-facing localization phrases for a LiveChat group and language through LiveChat's public Customer Chat endpoint.

Get Dynamic Customer Configuration

Return current customer-facing widget availability and the version identifiers needed for detailed configuration and localization reads.

Get Greeting

Get one LiveChat greeting, including its rules and rich-message structure.

Get Group

Return one LiveChat group by ID, including any explicitly requested optional fields.

Get License Webhooks State

Return whether webhook delivery is enabled for the connected LiveChat license.

Get Predicted Agent

Return whether a new chat for an existing customer is predicted to queue and the agent predicted to receive it, when available.

Get Product Source

Return the source parameters supplied when the Text product was activated.

Get URL Preview

Return LiveChat-hosted preview image URLs for a public webpage without changing chat state.

Issue Bot Token

Issue a sensitive, non-revocable bot bearer token valid for 24 hours.

List Agents

List LiveChat agents, optionally filtering by group membership or suspension state.

List All Bots

List every bot in the LiveChat license, including bots not owned by the connected app.

List All Private Canned Responses

Return one page including every private canned response across the requested LiveChat groups.

List Auto Accesses

List all LiveChat auto-access rules in their evaluation order.

List Bots

List only bots owned by the connected LiveChat app.

List Bot Templates

List bot templates owned by a specified OAuth application client ID.

List Canned Responses

Return one page of canned responses accessible to the caller and a next_page_id for explicit continuation.

List Channels

List summaries of communication channels used by the connected Text product.

List Customer Bans

List all active customer bans.

List Customer Chats

List one existing customer's chat summaries through LiveChat's server-side customer authorization bridge, returning one page at a time.

List Customer Chat Threads

List threads from one existing customer's chat through LiveChat's server-side customer authorization bridge, returning one page at a time.

List Customer Group Properties

Read the custom property values a customer may access for one LiveChat group.

List Customer Group Statuses

Return chat availability statuses for selected LiveChat groups or all groups visible to an existing customer.

List Customer License Properties

Read the license property values visible to a LiveChat customer.

List Greetings

List a bounded page of LiveChat greetings, optionally filtered by group.

List Group Properties

Read group-level property values for selected LiveChat groups or a property namespace.

List Groups

List all LiveChat groups, optionally requesting additional fields for each group.

List License Properties

Read license-level property values, optionally narrowed to a namespace and property-name prefix.

List Property Definitions

List private and public LiveChat property definitions owned by a specified OAuth application client ID.

List Tags

List LiveChat tags, optionally filtering by nested group IDs.

List Webhook Names

List webhook actions supported by LiveChat Configuration API version 3.

List Webhooks

List webhooks registered for a specified OAuth application client ID.

Mark Events as Seen

Advance an existing customer's seen state in a LiveChat chat through an RFC 3339 timestamp.

Publish Property

Publish a private property for access by tokens belonging to any Client ID.

Reactivate Email

Reactivate a bounced external email address for one LiveChat agent.

Register Property

Register one private custom property definition for a LiveChat OAuth application.

Register Webhook

Register one LiveChat webhook endpoint for an OAuth application and action.

Request Agent Unsuspension

Request unsuspension for the connected suspended agent.

Request Email Verification

Send a verification email to an existing LiveChat customer.

Request Welcome Message

Request an asynchronous welcome message for an existing logged-in customer.

Reset Bot Secret

Irreversibly rotate a bot secret and return the sensitive replacement.

Reset Bot Template And Installed Bot Secrets

Irreversibly rotate a LiveChat bot template secret and set the replacement on every installed bot based on it across all licenses.

Reset Bot Template Secret

Irreversibly rotate only a bot template secret and return the sensitive replacement.

Resume Chat

Resume an archived LiveChat chat for an existing customer entity.

Send Event

Send one event into a real LiveChat chat for an existing customer.

Send File Event

Upload one non-executable file of at most 10,000,000 bytes and irreversibly deliver it as a file event in an existing LiveChat chat.

Send Greeting Button Clicked

Record that an existing customer clicked a specific button in an incoming LiveChat greeting.

Send Rich Message Postback

Send a button postback for an existing rich-message event.

Send Sneak Peek

Send transient typed content into a real LiveChat chat before the customer submits it as a message.

Set Customer Session Fields

Replace an existing LiveChat customer's ordered session fields.

Start Chat

Start a new LiveChat chat for an existing customer entity.

Suspend Agent

Suspend a licensed LiveChat agent.

Unban Customer

Lift a customer ban by IP address or customer ID.

Unregister Property

Permanently remove one custom property definition owned by an OAuth application.

Unregister Webhook

Permanently remove one webhook registration owned by a LiveChat OAuth application.

Unsuspend Agent

Unsuspend a licensed LiveChat agent.

Update Agent

Update a licensed LiveChat agent.

Update Auto Access

Update or reorder an auto-access rule.

Update Bot

Update a LiveChat bot.

Update Bot Template

Fully replace a LiveChat bot template for future installations.

Update Canned Response

Update an existing canned response while preserving omitted fields.

Update Chat Properties

Set registered custom property values on a live customer chat.

Update Company Details

Update license-level company details.

Update Customer

Partially update an existing LiveChat customer profile.

Update Event Properties

Set registered custom property values on a live customer-chat event.

Update Greeting

Update a greeting while preserving omitted fields.

Update Group

Update the name, language, or complete agent-priority map of an existing LiveChat group.

Update Group Properties

Set one or more custom property values on a LiveChat group.

Update Installed Bots From Template

Fully replace a LiveChat bot template and propagate the replacement to every bot installed from it across all licenses.

Update License Properties

Set one or more license-level custom property values grouped by namespace.

Update Tag

Update a LiveChat tag identified by its exact case-sensitive name.

Update Thread Properties

Set registered custom property values on a live customer-chat thread.

Upload File

Upload one non-executable file of at most 10,000,000 bytes for later use in a Customer Chat event.

FRAMEWORKS

How to build LiveChat MCP Agent with another framework

ChatGPT logo

ChatGPT

Use LiveChat MCP with ChatGPT

Claude Cowork logo

Claude Cowork

Use LiveChat MCP with Claude Cowork

Hermes logo

Hermes

Use LiveChat MCP with Hermes

FAQ

Frequently asked questions

With a standalone LiveChat MCP server, the agents and LLMs can only access a fixed set of LiveChat tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from LiveChat and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right LiveChat tools.

Yes, absolutely. You can configure which LiveChat scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your LiveChat data and credentials are handled as safely as possible.

Start with LiveChat.It takes 30 seconds.

Managed auth, hosted MCP servers, and every LiveChat tool your agent needs.Free to start.

Start building