SingChat

Official17 tools

by singchat

Free live chat and AI support agent. Auto-create a workspace and embed from your AI editor.

🛠️ Key Features

Real-time live chat with integrated AI support agent
Auto-createable workspace upon setup
Embeddable from your AI editor for seamless integration

🚀 Use Cases

Customer support channels with AI-assisted replies
Quick AI-powered helpdesk within a workspace
Embedding chat AI into editor-driven workflows

⚡ Developer Benefits

Simple onboarding for AI-enabled chat capabilities
Flexible embedding for editor-based deployment
Clear description and through-line with descriptive readme excerpt

⚠️ Limitations

Data and capabilities constrained to described features
Limited details beyond name, description, and basic workflow
No additional configuration or API surface described in provided data

Captured live from the server via tools/list.

ping

Health check for the SingChat MCP server. Returns 'pong' and whether this request is authenticated to a workspace.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

singchat_setup

Get the user up and running with SingChat live-chat. Call this FIRST. If no workspace API key is configured, this creates a brand-new free workspace and returns a workspace API key, the website embed snippet, and dashboard/claim links. If a workspace API key is already configured, it returns THIS workspace's embed snippet and dashboard link (it never creates a duplicate workspace).

Parameters1

name

string

optional

Optional workspace/brand name for a newly created workspace. Ignored if a key is already set.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Optional workspace/brand name for a newly created workspace. Ignored if a key is already set.",
      "type": "string",
      "maxLength": 120
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_embed_snippet

Return the SingChat chat-widget embed code for this workspace's web inbox, in three flavors: plain HTML, React (useEffect), and Next.js (next/script). Requires a workspace API key. Optionally pass `platform` to get just one flavor.

Parameters1

platform

string

optional

Which snippet to return. Omit to get all three.

Raw schema

{
  "type": "object",
  "properties": {
    "platform": {
      "description": "Which snippet to return. Omit to get all three.",
      "type": "string",
      "enum": [
        "html",
        "react",
        "next"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

claim_account

Return the link to claim (permanently secure) this SingChat workspace by setting an email and password. Use this for workspaces that were auto-created via MCP so the user does not lose access. Requires a workspace API key.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

list_conversations

List the workspace's support conversations (agent/inbox view), newest activity first. Optionally filter by status or a free-text search over the contact name/email and last message. Returns a compact list: id, contact name, status, unreadCount, last message preview, updatedAt.

Parameters3

status	string	optional	Only conversations with this status.
search	string	optional	Free-text match on contact name/email and the last message preview.
limit	integer	optional	Max conversations to return (default 100).

Raw schema

{
  "type": "object",
  "properties": {
    "status": {
      "description": "Only conversations with this status.",
      "type": "string",
      "enum": [
        "OPEN",
        "PENDING",
        "RESOLVED",
        "SNOOZED"
      ]
    },
    "search": {
      "description": "Free-text match on contact name/email and the last message preview.",
      "type": "string"
    },
    "limit": {
      "description": "Max conversations to return (default 100).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 200
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_conversation

Fetch a single conversation with its contact details and the most recent messages (oldest→newest).

Parameters1

conversationId

string

required

The conversation id (from list_conversations).

Raw schema

{
  "type": "object",
  "properties": {
    "conversationId": {
      "type": "string",
      "minLength": 1,
      "description": "The conversation id (from list_conversations)."
    }
  },
  "required": [
    "conversationId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

reply_to_conversation

Send an agent reply to a conversation. This takes the conversation over from the AI (turns off automated AI handling) and broadcasts the message live to the visitor and the agent inbox. The reply is attributed to a workspace owner/admin.

Parameters2

conversationId	string	required	The conversation id to reply in.
content	string	required	The reply text to send to the visitor.

Raw schema

{
  "type": "object",
  "properties": {
    "conversationId": {
      "type": "string",
      "minLength": 1,
      "description": "The conversation id to reply in."
    },
    "content": {
      "type": "string",
      "minLength": 1,
      "description": "The reply text to send to the visitor."
    }
  },
  "required": [
    "conversationId",
    "content"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

resolve_conversation

Mark a conversation as RESOLVED (closes it). The visitor's widget will no longer show it as active.

Parameters1

conversationId

string

required

The conversation id to resolve.

Raw schema

{
  "type": "object",
  "properties": {
    "conversationId": {
      "type": "string",
      "minLength": 1,
      "description": "The conversation id to resolve."
    }
  },
  "required": [
    "conversationId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

add_knowledge

Train the AI agent by adding a knowledge source. type='url' crawls a website (up to 50 pages); type='qa' stores a single question/answer pair. Ingestion is asynchronous, the source starts as PENDING; poll `list_knowledge` for READY status.

Parameters4

type	string	required	'url' to crawl a website, or 'qa' to add a question/answer pair.
url	string	optional	Website root URL to crawl. Required when type='url'.
question	string	optional	The question. Required when type='qa'.
answer	string	optional	The answer. Required when type='qa'.

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "url",
        "qa"
      ],
      "description": "'url' to crawl a website, or 'qa' to add a question/answer pair."
    },
    "url": {
      "description": "Website root URL to crawl. Required when type='url'.",
      "type": "string",
      "format": "uri"
    },
    "question": {
      "description": "The question. Required when type='qa'.",
      "type": "string"
    },
    "answer": {
      "description": "The answer. Required when type='qa'.",
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_knowledge

List all knowledge documents for this workspace with their processing status (PENDING | PROCESSING | READY | FAILED) and chunk counts. Use this to check whether items added via add_knowledge have finished training.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

search_knowledge

Semantic search over the workspace knowledge base. Returns the most relevant chunks (with source document title and similarity score) for a query. Only searches documents that have finished training (status READY).

Parameters2

query	string	required	The search query / user question.
topK	integer	optional	Max number of chunks to return (default 5).

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "The search query / user question."
    },
    "topK": {
      "description": "Max number of chunks to return (default 5).",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

configure_agent

Configure this workspace's AI support agent. All fields are optional, only the fields you pass are updated; the rest keep their current values. Call with no fields to just read back the current configuration. Does not touch or return any API keys.

Parameters5

enabled	boolean	optional	Turn the automated AI agent on (true) or off (false).
systemPrompt	string	optional	The agent's system prompt / persona and answering rules.
greetingMessage	string	optional	First message visitors see when they open the chat. Pass an empty string to clear it.
model	string	optional	Chat model id, e.g. gpt-4o-mini.
providerMode	string	optional	'platform' = platform-hosted keys (billed via AI credits); 'byok' = bring your own key.

Raw schema

{
  "type": "object",
  "properties": {
    "enabled": {
      "description": "Turn the automated AI agent on (true) or off (false).",
      "type": "boolean"
    },
    "systemPrompt": {
      "description": "The agent's system prompt / persona and answering rules.",
      "type": "string",
      "minLength": 1,
      "maxLength": 8000
    },
    "greetingMessage": {
      "description": "First message visitors see when they open the chat. Pass an empty string to clear it.",
      "type": "string",
      "maxLength": 2000
    },
    "model": {
      "description": "Chat model id, e.g. gpt-4o-mini.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "providerMode": {
      "description": "'platform' = platform-hosted keys (billed via AI credits); 'byok' = bring your own key.",
      "type": "string",
      "enum": [
        "platform",
        "byok"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

set_keywords

Add a keyword auto-reply rule: when an inbound message matches any of the keywords, the bot replies with the given text. Good for canned FAQ-style triggers (e.g. keyword 'invoice' -> 'Download it from the billing page').

Parameters3

keywords	array	required	Trigger words/phrases (case-insensitive).
reply	string	required	The reply text to send.
matchType	string	optional	CONTAINS (default) = keyword appears anywhere in the message; EXACT = whole message equals the keyword.

Raw schema

{
  "type": "object",
  "properties": {
    "keywords": {
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 80
      },
      "description": "Trigger words/phrases (case-insensitive)."
    },
    "reply": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "The reply text to send."
    },
    "matchType": {
      "description": "CONTAINS (default) = keyword appears anywhere in the message; EXACT = whole message equals the keyword.",
      "type": "string",
      "enum": [
        "CONTAINS",
        "EXACT"
      ]
    }
  },
  "required": [
    "keywords",
    "reply"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

manage_faq

List, create, update, or delete this workspace's FAQ items (shown in the chat widget and usable by the AI agent). Set `action` to 'list' | 'create' | 'update' | 'delete'. 'create' needs `question` + `answer`; 'update' and 'delete' need `id`.

Parameters5

action	string	required	Which FAQ operation to run.
id	string	optional	FAQ item id. Required for 'update' and 'delete'.
question	string	optional	Question text. Required for 'create'; optional for 'update'.
answer	string	optional	Answer text. Required for 'create'; optional for 'update'.
enabled	boolean	optional	Whether the FAQ item is visible/active. Optional for 'create' and 'update'.

Raw schema

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "list",
        "create",
        "update",
        "delete"
      ],
      "description": "Which FAQ operation to run."
    },
    "id": {
      "description": "FAQ item id. Required for 'update' and 'delete'.",
      "type": "string"
    },
    "question": {
      "description": "Question text. Required for 'create'; optional for 'update'.",
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "answer": {
      "description": "Answer text. Required for 'create'; optional for 'update'.",
      "type": "string",
      "minLength": 1,
      "maxLength": 4000
    },
    "enabled": {
      "description": "Whether the FAQ item is visible/active. Optional for 'create' and 'update'.",
      "type": "boolean"
    }
  },
  "required": [
    "action"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_analytics

Return a compact analytics summary for this workspace over the last `days` days (default 30): conversation counts + resolution rate, message volume + AI share, plus a live snapshot of today (UTC).

Parameters1

days

integer

optional

Look-back window in days for the conversation/message stats (default 30).

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "default": 30,
      "description": "Look-back window in days for the conversation/message stats (default 30).",
      "type": "integer",
      "minimum": 1,
      "maximum": 365
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search

Search SingChat for relevant documents. When called with a workspace API key, this searches that workspace knowledge base; without a key it searches SingChat's own help content (what SingChat is, adding the chat widget, MCP setup, free tier, AI training, channels, white label, pricing). Returns a list of results with id, title, and url. Use the fetch tool with a result id to read the full text.

Parameters1

query

string

required

The search query or user question.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The search query or user question."
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

fetch

Fetch the full text of a single document by id, using an id returned by the search tool. With a workspace API key this reads a knowledge document from that workspace; without a key it reads a SingChat help article. Returns id, title, text, url, and optional metadata.

Parameters1

id

string

required

The document id returned by the search tool.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The document id returned by the search tool."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Install

Tools (17)

pingsingchat_setupget_embed_snippetclaim_accountlist_conversationsget_conversationreply_to_conversationresolve_conversation

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://singchat.org/api/mcp/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "singchat": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://singchat.org/api/mcp/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

SingChat - agentage MCP Catalog