Manage HelpCrunch chats, customers, agents and knowledge-base articles.
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.
ASSIGNS (or unassigns) a LIVE chat to an agent. Pass `assignee` (agent id) to assign; omit it (or pass null) to unassign. HelpCrunch REST: PUT /chats/assignee.
The chat id to (re)assign.
Agent id to assign the chat to. Omit (or null) to unassign.
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
ASSIGNS (or unassigns) a LIVE chat to an agent. Pass `assignee` (agent id) to assign; omit it (or pass null) to unassign. HelpCrunch REST: PUT /chats/assignee.
| Argument | Type | Description |
|---|---|---|
| id* | integer | The chat id to (re)assign. |
| assignee | integer | Agent id to assign the chat to. Omit (or null) to unassign. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The chat id to (re)assign."
},
"assignee": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Agent id to assign the chat to. Omit (or null) to unassign."
}
}
}POSTS a message into a LIVE chat — a customer-visible reply (type "message") or an internal private note (type "private"). Set `agent` (agent id) for agent messages; omit it for customer messages. HelpCrunch REST: POST /messages.
| Argument | Type | Description |
|---|---|---|
| chat* | integer | The chat id to post the message into. |
| text* | string | The message text. |
| type | string | "message" = customer-visible reply; "private" = internal note. |
| agent | integer | Agent id — required for agent messages; omit for customer messages. |
| markdown_text | string | Optional markdown version of the message (→ markdownText). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"chat",
"text"
],
"properties": {
"chat": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The chat id to post the message into."
},
"text": {
"type": "string",
"description": "The message text."
},
"type": {
"enum": [
"message",
"private"
],
"type": "string",
"default": "message",
"description": "\"message\" = customer-visible reply; \"private\" = internal note."
},
"agent": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Agent id — required for agent messages; omit for customer messages."
},
"markdown_text": {
"type": "string",
"description": "Optional markdown version of the message (→ markdownText)."
}
}
}Get a single chat (conversation) by id. HelpCrunch REST: GET /chats/{id}.
| Argument | Type | Description |
|---|---|---|
| id* | string | The chat id (numeric id, passed as a string). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The chat id (numeric id, passed as a string)."
}
}
}Get the messages of a chat (conversation), newest first (sorted by createdAt DESC). Paginate with limit (max 100) / offset. HelpCrunch REST: GET /chats/{id}/messages.
| Argument | Type | Description |
|---|---|---|
| id* | string | The chat id (numeric id, passed as a string). |
| limit | integer | Max messages to return (max 100). |
| offset | integer | Records to skip (pagination offset). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The chat id (numeric id, passed as a string)."
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Max messages to return (max 100)."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Records to skip (pagination offset)."
}
}
}Get a single customer by id. HelpCrunch REST: GET /customers/{id}.
| Argument | Type | Description |
|---|---|---|
| id* | string | The customer id (numeric id, passed as a string). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The customer id (numeric id, passed as a string)."
}
}
}Get the organization's live-chat availability status — domain, whether the team is online (teamOnline), and whether chat is enabled (chatEnabled). HelpCrunch REST: GET /organization.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}List agents (support staff / operators) in the account, with role and email. Paginate with limit/offset. HelpCrunch REST: GET /agents.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max records to return (pagination limit). |
| offset | integer | Records to skip (pagination offset). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Max records to return (pagination limit)."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Records to skip (pagination offset)."
}
}
}List applications configured in the account — web chat widgets, iOS/Android apps, and social integrations (id, name, displayName, active, type). HelpCrunch REST: GET /applications.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}List / search chats (conversations). Optionally filter with a single field/operator/value clause (comparison AND), sort (e.g. chats.createdAt) with order, and paginate with limit/offset. HelpCrunch REST: POST /chats/search.
| Argument | Type | Description |
|---|---|---|
| sort | string | Field to sort by, e.g. chats.createdAt. |
| field | string | Field to filter on (e.g. customers.email, chats.status). |
| limit | integer | Max records to return (pagination limit). |
| order | string | Sort direction. |
| value | string | Value to compare the field against (used with field + operator). |
| offset | integer | Records to skip (pagination offset). |
| operator | string | Filter comparison operator (used with field + value). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"sort": {
"type": "string",
"description": "Field to sort by, e.g. chats.createdAt."
},
"field": {
"type": "string",
"description": "Field to filter on (e.g. customers.email, chats.status)."
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Max records to return (pagination limit)."
},
"order": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort direction."
},
"value": {
"type": "string",
"description": "Value to compare the field against (used with field + operator)."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Records to skip (pagination offset)."
},
"operator": {
"enum": [
"=",
"!=",
">",
"<",
">=",
"<=",
"~",
"!~"
],
"type": "string",
"description": "Filter comparison operator (used with field + value)."
}
}
}List / search customers (people who chatted in). Optionally filter with a single field/operator/value clause (comparison AND), sort (e.g. customers.firstSeen, customers.lastSeen) with order, and paginate with limit/offset. HelpCrunch REST: POST /customers/search.
| Argument | Type | Description |
|---|---|---|
| sort | string | Field to sort by, e.g. customers.firstSeen / customers.lastSeen. |
| field | string | Field to filter on (e.g. customers.email, chats.status). |
| limit | integer | Max records to return (pagination limit). |
| order | string | Sort direction. |
| value | string | Value to compare the field against (used with field + operator). |
| offset | integer | Records to skip (pagination offset). |
| operator | string | Filter comparison operator (used with field + value). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"sort": {
"type": "string",
"description": "Field to sort by, e.g. customers.firstSeen / customers.lastSeen."
},
"field": {
"type": "string",
"description": "Field to filter on (e.g. customers.email, chats.status)."
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Max records to return (pagination limit)."
},
"order": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort direction."
},
"value": {
"type": "string",
"description": "Value to compare the field against (used with field + operator)."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Records to skip (pagination offset)."
},
"operator": {
"enum": [
"=",
"!=",
">",
"<",
">=",
"<=",
"~",
"!~"
],
"type": "string",
"description": "Filter comparison operator (used with field + value)."
}
}
}List departments (groups of agents that chats can be routed to), each with its agents. Paginate with limit/offset. HelpCrunch REST: GET /departments.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max records to return (pagination limit). |
| offset | integer | Records to skip (pagination offset). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Max records to return (pagination limit)."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Records to skip (pagination offset)."
}
}
}CHANGES the status of a LIVE chat (e.g. mark it opened, pending, on hold, or closed). HelpCrunch REST: PUT /chats/status.
| Argument | Type | Description |
|---|---|---|
| id* | integer | The chat id to update. |
| status* | string | The new chat status. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id",
"status"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The chat id to update."
},
"status": {
"enum": [
"new",
"opened",
"pending",
"on hold",
"no communication",
"closed"
],
"type": "string",
"description": "The new chat status."
}
}
}