HelpCrunch MCP by usefulapi is an MCP server published by io.usefulapi, hosted at helpcrunch.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 12 tools, including helpcrunch_list_customers, helpcrunch_get_customer, helpcrunch_list_chats, helpcrunch_get_chat, helpcrunch_get_chat_messages.
Manage HelpCrunch chats, customers, agents and knowledge-base articles.
4,209 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | 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). |
{
"name": "helpcrunch_list_customers",
"title": "List customers",
"description": "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.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "List customers",
"readOnlyHint": true
}
}Get a single customer by id. HelpCrunch REST: GET /customers/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The customer id (numeric id, passed as a string). |
{
"name": "helpcrunch_get_customer",
"title": "Get customer",
"description": "Get a single customer by id. HelpCrunch REST: GET /customers/{id}.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Get customer",
"readOnlyHint": true
}
}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.
| Parameter | 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). |
{
"name": "helpcrunch_list_chats",
"title": "List chats",
"description": "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.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "List chats",
"readOnlyHint": true
}
}Get a single chat (conversation) by id. HelpCrunch REST: GET /chats/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The chat id (numeric id, passed as a string). |
{
"name": "helpcrunch_get_chat",
"title": "Get chat",
"description": "Get a single chat (conversation) by id. HelpCrunch REST: GET /chats/{id}.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Get chat",
"readOnlyHint": true
}
}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.
| Parameter | 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). |
{
"name": "helpcrunch_get_chat_messages",
"title": "Get chat messages",
"description": "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.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Get chat messages",
"readOnlyHint": true
}
}List agents (support staff / operators) in the account, with role and email. Paginate with limit/offset. HelpCrunch REST: GET /agents.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max records to return (pagination limit). |
| offset | integer | Records to skip (pagination offset). |
{
"name": "helpcrunch_list_agents",
"title": "List agents",
"description": "List agents (support staff / operators) in the account, with role and email. Paginate with limit/offset. HelpCrunch REST: GET /agents.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "List agents",
"readOnlyHint": true
}
}List departments (groups of agents that chats can be routed to), each with its agents. Paginate with limit/offset. HelpCrunch REST: GET /departments.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max records to return (pagination limit). |
| offset | integer | Records to skip (pagination offset). |
{
"name": "helpcrunch_list_departments",
"title": "List departments",
"description": "List departments (groups of agents that chats can be routed to), each with its agents. Paginate with limit/offset. HelpCrunch REST: GET /departments.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "List departments",
"readOnlyHint": true
}
}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 parameters.
{
"name": "helpcrunch_list_applications",
"title": "List applications",
"description": "List applications configured in the account — web chat widgets, iOS/Android apps, and social integrations (id, name, displayName, active, type). HelpCrunch REST: GET /applications.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List applications",
"readOnlyHint": true
}
}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 parameters.
{
"name": "helpcrunch_get_organization",
"title": "Get organization",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get organization",
"readOnlyHint": true
}
}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.
| Parameter | 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). |
{
"name": "helpcrunch_create_message",
"title": "Create message",
"description": "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.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Create message",
"destructiveHint": true
}
}CHANGES the status of a LIVE chat (e.g. mark it opened, pending, on hold, or closed). HelpCrunch REST: PUT /chats/status.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The chat id to update. |
| status * | string | The new chat status. |
{
"name": "helpcrunch_update_chat_status",
"title": "Update chat status",
"description": "CHANGES the status of a LIVE chat (e.g. mark it opened, pending, on hold, or closed). HelpCrunch REST: PUT /chats/status.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Update chat status",
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The chat id to (re)assign. |
| assignee | integer | Agent id to assign the chat to. Omit (or null) to unassign. |
{
"name": "helpcrunch_assign_chat",
"title": "Assign chat",
"description": "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.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Assign chat",
"destructiveHint": true
}
}Tools for HelpCrunch, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "How many live chats are open right now, and who is handling them?"; "Show me the messages in the most recent chat from a customer."; "Which agents and departments do we have set up?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes HelpCrunch data. Free plan: 50 tool calls per month. Run helpcrunch_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run helpcrunch_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run helpcrunch_upgrade without a plan: it returns both plans, each with a payment link for the user to open. helpcrunch_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.