SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

LiveChat MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with LiveChat MCP or direct API to manage conversations, query agents, configure groups, and handle webhooks through natural language.

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

Try LiveChat now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
LiveChat
Try asking
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.

SETUP GUIDE

Connect LiveChat MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["livechat"],
  mcp: true,
});
Create a session scoped to LiveChat and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List all active LiveChat agents",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a LiveChat request
SETUP GUIDE

Connect LiveChat API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["livechat"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to LiveChat
3

Run LiveChat tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List all active LiveChat agents" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the LiveChat tool calls through the session, and print the final answer

Why Use Composio?

AI Native LiveChat Integration

  • Supports both LiveChat MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your LiveChat data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke LiveChat access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access LiveChat
  • Scoped, least privilege access to LiveChat resources
  • Full audit trail of agent actions to support review and compliance
FRAMEWORKS

Use LiveChat with any AI Agent Framework

Choose a Framework you want to connect LiveChat with

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

Atomic Agent logo

Atomic Agent

Use LiveChat MCP with Atomic Agent

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

LiveChat requires connections to go through your own OAuth app. You register it once with LiveChat, add its client ID and secret in the Composio dashboard, and from then on everyone connects by signing in to LiveChat as usual. Composio handles the rest of the flow and the token refresh.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Yes. Composio is SOC 2 Type II compliant and is built to keep your LiveChat connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

When you connect a LiveChat account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in LiveChat as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Exactly the ones LiveChat lists on its consent screen when you connect. Review that screen before approving. If you connect a work account, your LiveChat administrator may need to approve the app first, and you can revoke the access inside LiveChat whenever you want.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each LiveChat connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

Composio refreshes LiveChat tokens automatically, so day to day you do nothing. If you revoke access inside LiveChat, or LiveChat invalidates the session, the connection shows as expired in Composio and the agent stops acting on that account until you reconnect it, which is a single sign-in.

Composio's free Hobby plan includes 100,000 tool calls per month with no credit card, which covers most personal LiveChat use. Paid plans add higher limits and team features. Your LiveChat plan and its API limits still apply as usual.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple LiveChat accounts).

With Composio, you connect LiveChat once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with LiveChat.It takes 30 seconds.

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

Start building