Reply to and resolve customer chats, search your help docs and see which conversations need you.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Use this when someone asks about one customer conversation's status, such as whether it is resolved or unread and how many messages the customer, staff and AI agent sent. Returns its channel, status, unread count, times and sender counts from the latest 50 public messages (no message text or internal notes). Not for reading or quoting what was said.
Conversation id, up to 200 characters
Use this when someone asks about one customer conversation's status, such as whether it is resolved or unread and how many messages the customer, staff and AI agent sent. Returns its channel, status, unread count, times and sender counts from the latest 50 public messages (no message text or internal notes). Not for reading or quoting what was said.
| Argument | Type | Description |
|---|---|---|
| conversationId* | string | Conversation id, up to 200 characters |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"conversationId"
],
"properties": {
"conversationId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Conversation id, up to 200 characters"
}
},
"additionalProperties": false
}Use this when someone needs the text of one help-center article, to quote it or answer a customer from it. Returns the article's title, slug, language, published flag and text up to 20000 characters, with the text's format (html, markdown, plain-text). Not for finding articles on a topic.
| Argument | Type | Description |
|---|---|---|
| slug | string | Article slug, used only when documentId is omitted |
| locale | string | Language code for the slug lookup, e.g. en, it or fr; defaults to en |
| documentId | string | Article id; takes precedence over slug |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"slug": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Article slug, used only when documentId is omitted"
},
"locale": {
"type": "string",
"maxLength": 20,
"minLength": 1,
"description": "Language code for the slug lookup, e.g. en, it or fr; defaults to en"
},
"documentId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Article id; takes precedence over slug"
}
},
"additionalProperties": false
}Use this when someone asks how many customer conversations are still open or unresolved, in total or per website. Returns the total plus a per-website count, largest first, listing up to 100 websites (no customer or message data). Not for finding which conversations are open.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}Use this when someone asks about one of their Supovia websites by name or id, such as whether its AI customer agent is on. Returns the website's id, name, domain, AI-agent status and created and edited times, or not-found. Not for the help articles published on it.
| Argument | Type | Description |
|---|---|---|
| idOrName* | string | Website id, exact vanity id (its lowercase public address) or exact display name |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"idOrName"
],
"properties": {
"idOrName": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Website id, exact vanity id (its lowercase public address) or exact display name"
}
},
"additionalProperties": false
}Use this when someone asks which email campaigns one of their websites has. Returns each campaign's id, name and created and edited times, 20 per page by default (no recipients, subject or content). Not for sending a campaign.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Campaigns per page, from 1 to 50; defaults to 20 |
| cursor | string | The page.nextCursor of the previous page for the same website; absent for the first page |
| websiteId* | string | Website whose campaigns to list |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"websiteId"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"description": "Campaigns per page, from 1 to 50; defaults to 20",
"exclusiveMinimum": 0
},
"cursor": {
"type": "string",
"maxLength": 4096,
"description": "The page.nextCursor of the previous page for the same website; absent for the first page"
},
"websiteId": {
"type": "string",
"pattern": "^[0-9a-f]{24}$",
"description": "Website whose campaigns to list"
}
},
"additionalProperties": false
}Use this when someone asks which customer conversations are open, unread or recently active, optionally for one website. Returns conversation ids with website, channel, resolved flag, unread count and times, most recent activity first, 20 per page by default (no message text or customer details). Not for open-conversation totals.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Conversations per page, from 1 to 50; defaults to 20 |
| cursor | string | The page.nextCursor of the previous page with the same filters; absent for the first page |
| resolved | boolean | true for resolved conversations, false for open ones; omit for both |
| websiteId | string | Only conversations on this website; every website when absent |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"description": "Conversations per page, from 1 to 50; defaults to 20",
"exclusiveMinimum": 0
},
"cursor": {
"type": "string",
"maxLength": 2048,
"description": "The page.nextCursor of the previous page with the same filters; absent for the first page"
},
"resolved": {
"type": "boolean",
"description": "true for resolved conversations, false for open ones; omit for both"
},
"websiteId": {
"type": "string",
"maxLength": 200,
"description": "Only conversations on this website; every website when absent"
}
},
"additionalProperties": false
}Use this when someone asks which help articles or support docs exist, optionally for one website, language or article. Returns each article's id, title, slug, language, website and published flag, most recently edited first, 20 per page by default, without the article text. Not for finding articles about a topic.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Articles per page, from 1 to 50; defaults to 20 |
| cursor | string | The page.nextCursor of the previous page with the same filters; absent for the first page |
| locale | string | Only articles in this language code, e.g. en, it or fr; every language when absent |
| websiteId | string | Only articles on this website; every website when absent |
| slugOriginal | string | Only the language versions of one article: its original slug before translation |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"description": "Articles per page, from 1 to 50; defaults to 20",
"exclusiveMinimum": 0
},
"cursor": {
"type": "string",
"maxLength": 4096,
"description": "The page.nextCursor of the previous page with the same filters; absent for the first page"
},
"locale": {
"type": "string",
"maxLength": 20,
"minLength": 1,
"description": "Only articles in this language code, e.g. en, it or fr; every language when absent"
},
"websiteId": {
"type": "string",
"pattern": "^[0-9a-f]{24}$",
"description": "Only articles on this website; every website when absent"
},
"slugOriginal": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Only the language versions of one article: its original slug before translation"
}
},
"additionalProperties": false
}Use this when someone asks which websites their Supovia support chat runs on, or a website's id is needed. Returns each website's id, name, domain and whether its AI customer agent is on, most recently edited first, 20 per page by default. Not for customer conversations.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Websites per page, from 1 to 50; defaults to 20 |
| cursor | string | The page.nextCursor of the previous page; absent for the first page |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"description": "Websites per page, from 1 to 50; defaults to 20",
"exclusiveMinimum": 0
},
"cursor": {
"type": "string",
"maxLength": 4096,
"description": "The page.nextCursor of the previous page; absent for the first page"
}
},
"additionalProperties": false
}Use this when the embedded Supovia inbox opens a conversation the user selected. Returns whether it was found and gives the view its channel, status, unread count and times (no message text or customer details). Not for questions asked in chat.
| Argument | Type | Description |
|---|---|---|
| conversationId* | string | Conversation id the user selected in the inbox view |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversationId"
],
"properties": {
"conversationId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Conversation id the user selected in the inbox view"
}
}
}Use this when someone wants to open Supovia and browse their workspace interactively. Support websites, conversation activity and help articles. Starts with up to 100 items. Not for changing data.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Use this when someone wants to mark a customer conversation resolved or done, or reopen it. Returns the conversation id, resolved state and last edit time, and the operator dashboard updates live. Repeating the same state has no further effect. Not for replying to the customer.
| Argument | Type | Description |
|---|---|---|
| resolved | boolean | true to mark it resolved (the default), false to reopen it |
| conversationId* | string | Conversation to update |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"conversationId"
],
"properties": {
"resolved": {
"type": "boolean",
"description": "true to mark it resolved (the default), false to reopen it"
},
"conversationId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Conversation to update"
}
},
"additionalProperties": false
}Use this when someone asks which help article covers a topic or question on one of their websites. Returns up to 5 matching published articles with id, title, slug and language, matched by meaning in one language (English by default). Not for reading an article's text.
| Argument | Type | Description |
|---|---|---|
| query* | string | What the article should cover, in natural language, up to 500 characters |
| locale | string | Language code to search in, e.g. en, it or fr; defaults to en |
| websiteId* | string | Website whose help center to search |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query",
"websiteId"
],
"properties": {
"query": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "What the article should cover, in natural language, up to 500 characters"
},
"locale": {
"type": "string",
"maxLength": 20,
"minLength": 1,
"description": "Language code to search in, e.g. en, it or fr; defaults to en"
},
"websiteId": {
"type": "string",
"pattern": "^[0-9a-f]{24}$",
"description": "Website whose help center to search"
}
},
"additionalProperties": false
}Use this when the user approves an exact reply to send to a customer in one Supovia conversation. Returns the conversation id and send time. The reply reaches the customer on the conversation's own channels (chat, email, WhatsApp or Messenger); replies to app-store reviews are public. Not for internal notes or closing the conversation.
| Argument | Type | Description |
|---|---|---|
| content* | string | Exact reply text the user approved, 1 to 4,000 characters |
| conversationId* | string | Conversation to reply in |
| idempotencyKey* | string | Unique key you generate for this conversation and text, up to 255 characters; reuse it only to retry the same send |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"conversationId",
"content",
"idempotencyKey"
],
"properties": {
"content": {
"type": "string",
"maxLength": 4000,
"minLength": 1,
"description": "Exact reply text the user approved, 1 to 4,000 characters"
},
"conversationId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Conversation to reply in"
},
"idempotencyKey": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Unique key you generate for this conversation and text, up to 255 characters; reuse it only to retry the same send"
}
},
"additionalProperties": false
}Use this when someone wants to see their unread customer conversations in an inbox view. Returns how many of the 50 most recently active conversations have unread messages; the view lists up to 20 with channel, status, unread count and times (no message text or customer details). Not for complete open-conversation totals.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Use this when someone wants a quick visual summary of their customer support. Returns a card with up to 20 websites (name, domain, AI agent on or off) and the 20 most recently active conversations (channel, open or resolved, times), optionally for one website. Not for complete open-conversation totals.
| Argument | Type | Description |
|---|---|---|
| websiteId | string | Only this website; every website when absent |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"websiteId": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only this website; every website when absent"
}
}
}