Helpwise MCP by usefulapi
Read Helpwise conversations, contacts, tags and reports; note, tag, assign, close; send one email.
使うべきか
品質と安全性
検出事項（1）
- LOWTool 'helpwise_get_current_user' description lacks action verbhelpwise_get_current_user 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"helpwise": {
"url": "https://helpwise.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://helpwise.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール（21）
🟢helpwise_list_conversations(inbox_ids, folder, limit, page_token)
List conversations (threads) of one or more inboxes, newest first, with subject, snippet, tags, assignee, read/starred/closed flags and contact. Pick the folder with `folder` (default: all). Page with `next_page_token`. Inbox ids come from helpwise_list_inboxes. GET /conversations.
入力スキーマ
{
"type": "object",
"properties": {
"inbox_ids": {
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"description": "Inbox (mailbox) ids to list (1-20)."
},
"folder": {
"description": "Folder: all, assigned, unassigned, starred, snoozed, draft, sent, closed, spam, trash, scheduled.",
"type": "string",
"enum": [
"all",
"assigned",
"unassigned",
"starred",
"snoozed",
"draft",
"sent",
"closed",
"spam",
"trash",
"scheduled"
]
},
"limit": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"page_token": {
"description": "The previous reply's next_page_token.",
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"required": [
"inbox_ids"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢helpwise_get_conversation(inbox_id, conversation_id, folder, limit, page_token)
One conversation with its messages, notes, drafts, assignment and contacts. Page long conversations with `page_token` from the previous reply. GET /inboxes/{inbox_id}/conversations/{conversation_id}.
入力スキーマ
{
"type": "object",
"properties": {
"inbox_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Inbox (mailbox) id the conversation lives in."
},
"conversation_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Conversation (thread) id."
},
"folder": {
"description": "Folder context (optional).",
"type": "string",
"enum": [
"all",
"assigned",
"unassigned",
"starred",
"snoozed",
"draft",
"sent",
"closed",
"spam",
"trash",
"scheduled"
]
},
"limit": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"page_token": {
"description": "Page token from the previous reply, for older messages.",
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"required": [
"inbox_id",
"conversation_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢helpwise_list_contacts(limit, offset)
List contacts (name, company, job title, emails, phones, id). Page with limit and offset. GET /contacts.
入力スキーマ
{
"type": "object",
"properties": {
"limit": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "How many results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢helpwise_search_contacts(term, limit, offset)
Search contacts by a name, email or phone term. Page with limit and offset. GET /contacts/search.
入力スキーマ
{
"type": "object",
"properties": {
"term": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Search term (name, email or phone)."
},
"limit": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "How many results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"required": [
"term"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢helpwise_get_contact(contact_id)
One contact with emails, phones, company, custom fields and recent conversations. GET /contacts/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"contact_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Helpwise contact id."
}
},
"required": [
"contact_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢helpwise_list_tags
All tags (id, name, colour, parent, inbox). Use the ids with helpwise_apply_tags. GET /tags.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢helpwise_get_tag(tag_id)
One tag by id. GET /tags/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"tag_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Helpwise tag id."
}
},
"required": [
"tag_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢helpwise_get_report(start, end, business_hours_only, inbox_id, tag_ids)
Overall and team-performance report for a date range: new/closed/assigned conversations (with change vs the previous period), inbound/outbound messages per day, busiest hour/day, average first response, response and resolution time, CSAT and per-agent performance. Optional inbox and tag filters. GET /reports.
入力スキーマ
{
"type": "object",
"properties": {
"start": {
"type": "string",
"description": "Start, yyyy-mm-dd or yyyy-mm-dd hh:mm:ss (a date alone means 00:00:00)."
},
"end": {
"type": "string",
"description": "End, yyyy-mm-dd or yyyy-mm-dd hh:mm:ss (a date alone means 23:59:59)."
},
"business_hours_only": {
"description": "Count business hours only (default false).",
"type": "boolean"
},
"inbox_id": {
"description": "Only this inbox (default: all inboxes).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"tag_ids": {
"description": "Only conversations with these tag ids.",
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
}
},
"required": [
"start",
"end"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢helpwise_get_tags_report(inbox_id, start, end, business_hours_only, tag_ids)
Per-tag report for one inbox and a date range: conversations per tag (and share), open conversations, average response, first-response and resolution time. GET /inboxes/{inbox_id}/reports/tags.
入力スキーマ
{
"type": "object",
"properties": {
"inbox_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Inbox (mailbox) id."
},
"start": {
"type": "string",
"description": "Start, yyyy-mm-dd or yyyy-mm-dd hh:mm:ss (a date alone means 00:00:00)."
},
"end": {
"type": "string",
"description": "End, yyyy-mm-dd or yyyy-mm-dd hh:mm:ss (a date alone means 23:59:59)."
},
"business_hours_only": {
"description": "Count business hours only (default false).",
"type": "boolean"
},
"tag_ids": {
"description": "Only these tag ids.",
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
}
},
"required": [
"inbox_id",
"start",
"end"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢helpwise_list_inboxes(page, limit)
List the account's inboxes (mailboxes) with id, name, address and type. Use the ids in the other tools. POST /mailboxes/list (V0).
入力スキーマ
{
"type": "object",
"properties": {
"page": {
"description": "Page number, from 1 (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"limit": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢helpwise_list_users(inbox_id)
List the team members (agents) with access to an inbox: id, name, email. Use the ids with helpwise_assign_conversation. POST /users/list (V0).
入力スキーマ
{
"type": "object",
"properties": {
"inbox_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Inbox (mailbox) id."
}
},
"required": [
"inbox_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢helpwise_get_current_user
The Helpwise user the API key belongs to (name, email, id). POST /users/me (V0).
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴helpwise_create_contact(firstname, lastname, company, job_title, emails, ...)
WRITE: create a new contact in Helpwise (name, company, job title, emails, phones, custom fields). Nothing is sent to the person. Creating the same email twice may create a duplicate. POST /contacts.
入力スキーマ
{
"type": "object",
"properties": {
"firstname": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "First name."
},
"lastname": {
"description": "Last name.",
"type": "string",
"maxLength": 200
},
"company": {
"description": "Company name.",
"type": "string",
"maxLength": 200
},
"job_title": {
"description": "Job title.",
"type": "string",
"maxLength": 200
},
"emails": {
"description": "Email addresses (1-10).",
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"maxLength": 254,
"pattern": "^[^\\s@<>\",;:\\\\]+@[^\\s@<>\",;:\\\\]+\\.[^\\s@<>\",;:\\\\]+$"
}
},
"phones": {
"description": "Phone numbers (up to 10).",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"phone": {
"type": "string",
"minLength": 3,
"maxLength": 40,
"description": "Phone number with country code, e.g. +14155550123."
},
"type": {
"description": "Helpwise phone type code, as a string (default \"0\").",
"type": "string",
"maxLength": 10
}
},
"required": [
"phone"
]
}
},
"custom_fields": {
"description": "Custom field values.",
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Custom field id (from the Helpwise custom fields settings)."
},
"value": {
"type": "string",
"maxLength": 2000,
"description": "Value to store."
},
"name": {
"description": "Custom field name (optional).",
"type": "string",
"maxLength": 200
}
},
"required": [
"id",
"value"
]
}
}
},
"required": [
"firstname"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴helpwise_update_contact(contact_id, firstname, lastname, company, job_title, ...)
WRITE: change a contact's name, company, job title, emails, phones or custom fields. Helpwise updates with PUT, so this tool first reads the contact and sends the current values together with your changes; a list you pass (emails, phones, custom_fields) REPLACES the old list. Nothing is sent to the person. PUT /contacts/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"contact_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Helpwise contact id."
},
"firstname": {
"description": "New first name.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"lastname": {
"description": "New last name.",
"type": "string",
"maxLength": 200
},
"company": {
"description": "New company.",
"type": "string",
"maxLength": 200
},
"job_title": {
"description": "New job title.",
"type": "string",
"maxLength": 200
},
"emails": {
"description": "The full list of email addresses (replaces the current list).",
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"maxLength": 254,
"pattern": "^[^\\s@<>\",;:\\\\]+@[^\\s@<>\",;:\\\\]+\\.[^\\s@<>\",;:\\\\]+$"
}
},
"phones": {
"description": "The full list of phone numbers (replaces the current list).",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"phone": {
"type": "string",
"minLength": 3,
"maxLength": 40,
"description": "Phone number with country code, e.g. +14155550123."
},
"type": {
"description": "Helpwise phone type code, as a string (default \"0\").",
"type": "string",
"maxLength": 10
}
},
"required": [
"phone"
]
}
},
"custom_fields": {
"description": "Custom field values to set (replaces the current list).",
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Custom field id (from the Helpwise custom fields settings)."
},
"value": {
"type": "string",
"maxLength": 2000,
"description": "Value to store."
},
"name": {
"description": "Custom field name (optional).",
"type": "string",
"maxLength": 200
}
},
"required": [
"id",
"value"
]
}
}
},
"required": [
"contact_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴helpwise_add_note(inbox_id, conversation_id, message)
WRITE: add an internal note to a conversation. Visible to your Helpwise team only; it is not sent to the customer. Notes cannot be deleted through this API. POST /notes/add (V0).
入力スキーマ
{
"type": "object",
"properties": {
"inbox_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Inbox (mailbox) id of the conversation."
},
"conversation_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Conversation (thread) id."
},
"message": {
"type": "string",
"minLength": 1,
"maxLength": 10000,
"description": "The note text."
}
},
"required": [
"inbox_id",
"conversation_id",
"message"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴helpwise_assign_conversation(inbox_id, conversation_id, assigned_to)
WRITE: assign a conversation to a team member (user id from helpwise_list_users), or pass assigned_to 0 to unassign it. The assignee may be notified by Helpwise. POST /threads/assign (V0).
入力スキーマ
{
"type": "object",
"properties": {
"inbox_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Inbox (mailbox) id of the conversation."
},
"conversation_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Conversation (thread) id."
},
"assigned_to": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "User id to assign to, or 0 to unassign."
}
},
"required": [
"inbox_id",
"conversation_id",
"assigned_to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴helpwise_close_conversations(conversation_ids)
WRITE: close up to 25 conversations (mark them done). They can be reopened with helpwise_reopen_conversations. Nothing is sent to customers. PUT /conversations/action/close.
入力スキーマ
{
"type": "object",
"properties": {
"conversation_ids": {
"minItems": 1,
"maxItems": 25,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"description": "Conversation (thread) ids to close (1-25)."
}
},
"required": [
"conversation_ids"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴helpwise_reopen_conversations(conversation_ids)
WRITE: move up to 25 conversations back to the inbox (reopen closed ones). Nothing is sent to customers. PUT /conversations/action/moveToInbox.
入力スキーマ
{
"type": "object",
"properties": {
"conversation_ids": {
"minItems": 1,
"maxItems": 25,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"description": "Conversation (thread) ids to reopen (1-25)."
}
},
"required": [
"conversation_ids"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴helpwise_apply_tags(conversation_ids, tag_ids)
WRITE: apply existing tags (ids from helpwise_list_tags) to up to 25 conversations. Tags can drive Helpwise automations. Applying a tag already present changes nothing. POST /tags/apply.
入力スキーマ
{
"type": "object",
"properties": {
"conversation_ids": {
"minItems": 1,
"maxItems": 25,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"description": "Conversation (thread) ids (1-25)."
},
"tag_ids": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"description": "Tag ids to apply (1-10)."
}
},
"required": [
"conversation_ids",
"tag_ids"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴helpwise_remove_tags(conversation_ids, tag_ids)
WRITE: take tags off up to 25 conversations. The tags themselves are not deleted. POST /tags/remove.
入力スキーマ
{
"type": "object",
"properties": {
"conversation_ids": {
"minItems": 1,
"maxItems": 25,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"description": "Conversation (thread) ids (1-25)."
},
"tag_ids": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"description": "Tag ids to remove from them (1-10)."
}
},
"required": [
"conversation_ids",
"tag_ids"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴helpwise_send_email(inbox_id, to, cc, subject, body, ...)
WRITE: SEND A REAL EMAIL from a Helpwise inbox to the given customer address(es). Irreversible; once sent it cannot be recalled. At most 10 recipients in total (to + cc), one message per call; never use it for lists or campaigns. This starts a new message (it is not a reply on an existing conversation). The body is plain text (blank line = new paragraph); it is sent as HTML. POST /emails/send_mail (V0).
入力スキーマ
{
"type": "object",
"properties": {
"inbox_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Inbox (mailbox) id to send from (see helpwise_list_inboxes)."
},
"to": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"maxLength": 254,
"pattern": "^[^\\s@<>\",;:\\\\]+@[^\\s@<>\",;:\\\\]+\\.[^\\s@<>\",;:\\\\]+$"
},
"description": "Recipient addresses (1-10 with cc together)."
},
"cc": {
"description": "Cc addresses.",
"maxItems": 9,
"type": "array",
"items": {
"type": "string",
"maxLength": 254,
"pattern": "^[^\\s@<>\",;:\\\\]+@[^\\s@<>\",;:\\\\]+\\.[^\\s@<>\",;:\\\\]+$"
}
},
"subject": {
"type": "string",
"minLength": 1,
"maxLength": 300,
"description": "Subject line."
},
"body": {
"type": "string",
"minLength": 1,
"maxLength": 50000,
"description": "Plain-text message body."
},
"reply_to": {
"description": "Reply-to address (optional).",
"type": "string",
"maxLength": 254,
"pattern": "^[^\\s@<>\",;:\\\\]+@[^\\s@<>\",;:\\\\]+\\.[^\\s@<>\",;:\\\\]+$"
}
},
"required": [
"inbox_id",
"to",
"subject",
"body"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}コミュニティ
エビデンス