# Helpwise — how to use (mcp.ai)

Connect your Helpwise account and use 37 tools for customer support straight from your AI agent. Connect with your own API key. Helpwise is an easy-to-use customer service platform that helps you manage all customer communication from a single place.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_helpwise?ms=1787291460000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `helpwise_create_attachment`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/helpwise`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/helpwise/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/helpwise/create/attachment` — Tool to upload a new attachment. Use when you need to send a file to Helpwise and receive its attachment metadata.
  - body: { file: object, conversation_id?: string }
- `POST https://api.mcp.ai/api/helpwise/create/note` — Tool to add a note to a conversation. Use after obtaining the conversation_id to provide context.
  - body: { body: string, private?: boolean, conversation_id: string }
- `POST https://api.mcp.ai/api/helpwise/create/team` — Creates a new team in Helpwise to group users for collaboration and assignment purposes. Use this tool when you need to: - Create a new team with a unique name - Optionally add a description for the t
  - body: { name: string, member_ids?: string[], description?: string }
- `POST https://api.mcp.ai/api/helpwise/create/webhook` — Creates a new webhook subscription in Helpwise to receive real-time event notifications. Use this action to programmatically subscribe to Helpwise events like conversation creation, message replies, c
  - body: { url: string, events: string[], secret?: string, is_active?: boolean }
- `POST https://api.mcp.ai/api/helpwise/delete/contact` — Deletes a contact from Helpwise by its unique identifier (ID). Use this action when you need to permanently remove a contact from your Helpwise account. Returns an empty response (HTTP 204 No Content)
  - body: { contact_id: string }
- `POST https://api.mcp.ai/api/helpwise/delete/conversation` — Attempts to delete a conversation by ID from Helpwise. Note: The Helpwise API may not support conversation deletion via the REST API. If deletion is not supported, this action will return an error ind
  - body: { conversation_id: string }
- `POST https://api.mcp.ai/api/helpwise/delete/mailbox` — Tool to delete a mailbox by its unique identifier. NOTE: As of 2026, the Helpwise API may not support mailbox deletion via API. This action attempts deletion but will fail if the endpoint is not avail
  - body: { mailbox_id: string }
- `POST https://api.mcp.ai/api/helpwise/delete/message` — Attempts to delete a message from Helpwise. Note: The Helpwise API may not support message deletion via the REST API. If deletion is not supported, this action will return an error indicating that the
  - body: { message_id: string }
- `POST https://api.mcp.ai/api/helpwise/delete/note` — Tool to delete a note from a conversation. Use when you need to permanently remove a note by its ID from a specific conversation after confirming the IDs.
  - body: { note_id: string, conversation_id: string }
- `POST https://api.mcp.ai/api/helpwise/delete/signature` — Deletes an email signature from Helpwise. Email signatures are text/HTML templates that automatically append to outgoing emails from specific mailboxes or users. This action permanently removes the si
  - body: { signature_id: string }
- `POST https://api.mcp.ai/api/helpwise/delete/tag` — Permanently deletes a tag from Helpwise. This action removes the tag from all conversations where it was applied and cannot be undone. Use this when you need to permanently remove a tag that is no lon
  - body: { tag_id: string }
- `POST https://api.mcp.ai/api/helpwise/delete/team` — Tool to delete a team. Use when you need to remove an existing team by its unique identifier after confirming the ID and dependencies.
  - body: { team_id: string }
- `POST https://api.mcp.ai/api/helpwise/delete/template` — Deletes a Helpwise email template (saved reply) by its ID. Returns empty response on success (HTTP 204). Use this tool when you need to permanently remove a template that is no longer needed. Ensure t
  - body: { template_id: string }
- `POST https://api.mcp.ai/api/helpwise/delete/webhook` — Delete a Helpwise webhook by its ID. Use this tool when you need to permanently remove a webhook configuration. Returns an empty response on successful deletion (HTTP 204 No Content).
  - body: { webhook_id: string }
- `POST https://api.mcp.ai/api/helpwise/get/attachment` — Retrieves a specific attachment by its unique identifier. Use this after obtaining an attachment ID from conversations, messages, or attachment listings to get detailed attachment metadata including d
  - body: { attachment_id: string }
- `POST https://api.mcp.ai/api/helpwise/get/attachments` — Retrieves attachments from messages in a specific conversation. **Important**: Helpwise does not provide a dedicated attachments endpoint. This action retrieves attachments by fetching messages from t
  - body: { conversation_id: string }
- `POST https://api.mcp.ai/api/helpwise/get/contact` — Retrieves detailed information for a specific contact by ID. Use this when you need to fetch complete contact details including name, email, phone, company, and timestamps for a known contact ID.
  - body: { contact_id: string }
- `POST https://api.mcp.ai/api/helpwise/get/conversation` — Retrieves complete details of a specific conversation by ID from Helpwise. Returns the conversation metadata including subject, status, participants, and timestamps. Use this action when you need to v
  - body: { conversation_id: string }
- `POST https://api.mcp.ai/api/helpwise/get/conversations` — Tool to retrieve a list of conversations. Use when you need to list and paginate support conversations for display or analysis.
  - body: { page?: integer, search?: string, status?: string, sort_by?: string, team_id?: string, per_page?: integer, mailbox_id?: string, sort_order?: string, assignee_id?: string, requester_id?: string }
- `POST https://api.mcp.ai/api/helpwise/get/custom/field` — Retrieves details of a specific custom field by its ID. Use this when you need to fetch custom field properties such as name, description, value, associated inboxes, and creator information.
  - body: { custom_field_id: integer }
- `POST https://api.mcp.ai/api/helpwise/get/mailbox` — Tool to retrieve details of a specific mailbox by its ID. Use when you know the mailbox ID and need full mailbox information.
  - body: { mailbox_id: string }
- `POST https://api.mcp.ai/api/helpwise/get/mailboxes` — Tool to retrieve mailboxes. Use when you need to list and paginate mailboxes after authenticating.
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/helpwise/get/note` — Tool to retrieve details of a specific note. Use when you know the conversation and note IDs and need full note information.
  - body: { note_id: string, conversation_id: string }
- `POST https://api.mcp.ai/api/helpwise/get/notes` — Retrieves all notes associated with a specific conversation. Notes are internal comments or annotations that team members add to conversations for collaboration and context.
  - body: { conversation_id: string }
- `POST https://api.mcp.ai/api/helpwise/get/tag` — Retrieves detailed information about a specific tag in Helpwise. Use this action when you need to: - Get the full properties of a tag including its name, color, and timestamps - Verify that a tag exis
  - body: { tag_id: string }
- `POST https://api.mcp.ai/api/helpwise/get/team` — Retrieves details of a specific Helpwise team by its ID. Note: Team endpoints may not be available in all Helpwise API plans. If this action returns a 404 error, teams may need to be managed through t
  - body: { team_id: string }
- `POST https://api.mcp.ai/api/helpwise/get/teams` — Tool to retrieve Helpwise teams. Use when you need to list and paginate all teams for assignment or management.
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/helpwise/get/templates` — Tool to retrieve Helpwise WhatsApp message templates. Use when you need to list WhatsApp templates for a mailbox or account.
  - body: { mailbox_id?: integer }
- `POST https://api.mcp.ai/api/helpwise/get/users` — Tool to retrieve Helpwise users list. Use when you need to fetch and paginate agents for assignment.
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/helpwise/get/webhook` — Retrieve detailed configuration for a specific Helpwise webhook by its ID. Use this action when you: - Need to inspect the configuration of an existing webhook - Want to verify webhook settings (URL, 
  - body: { webhook_id: string }
- `POST https://api.mcp.ai/api/helpwise/get/webhooks` — Tool to retrieve Helpwise webhooks. Use when you need to list and paginate all webhook configurations.
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/helpwise/search/contacts` — Tool to search contacts by term with pagination. Use when you need to find contacts by name, email, phone, or other contact attributes.
  - body: { term: string, limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/helpwise/update/contact` — Tool to update an existing Helpwise contact. Use when you need to modify contact details or custom attributes.
  - body: { name?: string, email?: string, phone?: string, contact_id: string, organization?: string, custom_attributes?: object }
- `POST https://api.mcp.ai/api/helpwise/update/mailbox` — Updates an existing Helpwise mailbox. Use this action to modify mailbox settings such as display name, email address, team assignment, email signature, or default status. At least one field must be pr
  - body: { name?: string, address?: string, team_id?: string, signature?: string, is_default?: boolean, mailbox_id: string }
- `POST https://api.mcp.ai/api/helpwise/update/message` — Tool to update an existing message. Use when you need to modify message content by its ID.
  - body: { body: string, message_id: string }
- `POST https://api.mcp.ai/api/helpwise/update/tag` — Updates an existing tag's name and/or color in Helpwise. Use this action when you need to rename a tag or change its visual appearance. You must have the tag's ID before calling this action - obtain i
  - body: { name: string, color?: string, tag_id: string }
- `POST https://api.mcp.ai/api/helpwise/update/template` — Updates an existing Helpwise email template by modifying its name, subject, and/or HTML content. Use this action when you need to: - Change the display name of a template - Update the subject line (in
  - body: { html?: string, name?: string, subject?: string, template_id: string }

## Example prompts
- "What can I do in Helpwise?"
- "Show me a summary of my Helpwise account"

## More
- Page: https://mcp.ai/helpwise
- Agent spec (llms.txt): https://mcp.ai/helpwise/llms.txt
- Postman collection: https://mcp.ai/helpwise/postman.json