add-custom-data
ChatGPTCreate a custom field, if necessary, and set its value on a Chatway visitor/contact. Use update-custom-data when the field already exists. Use list-custom-fields to see existing field names.
add-note
ChatGPTAdd a private internal note to a Chatway conversation. The note is visible to authorized teammates and is not sent to the customer. Use send-message instead when the customer should see the text.
add-tag
ChatGPTAttach a named tag to the visitor/contact associated with a Chatway conversation. If supported by Chatway, the tag may be created when it does not already exist. Use list-tags first to reuse an existing tag name, and remove-tag to undo.
assign-conversation
ChatGPTAssign or unassign an agent on one or more Chatway conversations. Identify the agent by UUID or an unambiguous name/email query, send all conversation UUIDs in one call, and obtain user confirmation before changing assignments. Use list-agents only when an agent_query match is ambiguous.
check-connection
ChatGPTCheck whether the current MCP session has an active Chatway connection. Use this when Chatway inbox tools are unavailable or authentication may have expired.
get-conversation
ChatGPTRetrieve one accessible Chatway conversation by UUID, including its status, contact, channel information, and assigned agents. This does not return the full message history. Use this when you already have a conversation UUID; use list-conversation-messages to read the messages.
get-installation-code
ChatGPTGet the JavaScript snippet that installs Chatway for the connected account. The installation ID is account-based, so no widget selection is needed. Check for an existing Chatway installation before adding script_html, and install it only once. The snippet can be placed inside <head> or <body>, preferably just before </body>, in a shared layout that loads across the website. For Shopify, Wix, WordPress and other supported platforms, you can use Chatway’s native app or plugin, or install the JavaScript snippet directly. This tool returns the code; the coding agent installs it using its available tools and access.
get-installation-status
ChatGPTCheck for evidence that Chatway is installed on a website for the connected account. widget_operational indicates recent visitor conversations on the domain. script_detected indicates that the account’s script was found in the page HTML or a Chatway store app is installed; it does not guarantee the widget is enabled or visible. Other statuses mean installation is not confirmed. For unverified_spa, the site may load the script dynamically. If browser access is available, open the website and verify that Chatway loads. Otherwise, ask the user to open the website and start a test chat, then check again.
get-visitor
ChatGPTRetrieve one Chatway visitor/contact profile by visitor UUID, including the profile data available to the authenticated connection. Use this when you already have the visitor UUID (for example contact.id from get-conversation); otherwise find the contact with search-contacts.
handoff-to-human
ChatGPTRequest human-agent handoff for a Chatway conversation that is currently handled by a Chatway AI assistant. Returns an error if no AI assistant is assigned to the conversation; in that case, assign a teammate with assign-conversation or add a private note instead. This records a handoff request but does not guarantee that a human has joined or replied. Use it when the customer asks for a person or the request cannot be handled with the available tools; after handoff, do not reply with send-message.
list-agents
ChatGPTList or search Chatway teammates by name or email. Use this to obtain an unambiguous agent UUID before assigning conversations. Not needed when assign-conversation can match the agent directly by name or email with agent_query.
list-conversation-messages
ChatGPTList messages from one accessible Chatway conversation, newest first. Supports pagination and optional inclusion of system messages and private/internal message types. Read the history before summarizing or replying; page back to older messages with before_sort_number.
list-conversations
ChatGPTList accessible Chatway conversations newest first, optionally filtered by resolved status. Returns conversation metadata and a latest-message preview; use list-conversation-messages to read full message history. Use search-conversations to find a specific conversation by subject, URL, or contact instead of paging through the list.
list-custom-fields
ChatGPTList the custom-field definitions available to the authenticated Chatway team. This does not return field values for a particular visitor. Use this before add-custom-data or update-custom-data to reuse existing field names.
list-tags
ChatGPTList the tags available to the authenticated Chatway team, including their names and colors. Use this before add-tag to reuse an existing tag name.
remove-custom-data
ChatGPTRemove a named custom-field value from a Chatway visitor/contact. This is destructive and requires user confirmation. Use update-custom-data instead when the value should change rather than be removed.
remove-tag
ChatGPTRemove a named tag from the visitor/contact associated with a Chatway conversation. This is destructive and requires user confirmation. Use list-tags to check the exact tag name.
resolve-conversation
ChatGPTMark one or more Chatway conversations as resolved. Send all target conversation UUIDs in one call. This is destructive and requires user confirmation. Use unresolve-conversation to reopen conversations.
search-contacts
ChatGPTSearch accessible Chatway contacts by name, email address, or phone number. Returns matching contact records but does not search conversation messages. Use get-visitor instead when you already have the contact's UUID.
search-conversations
ChatGPTSearch accessible Chatway conversations by email subject, origin URL, or contact name/email. This does not search message bodies; use returned conversation IDs to retrieve messages. Use list-conversations to browse recent conversations or filter them by status.
search-knowledge-base
ChatGPTSearch the authenticated team’s Chatway knowledge-base questions and answers. Use the returned content to answer or draft a response without inventing unsupported information. Use it before drafting a reply with send-message so answers match the team's own content.
send-message
ChatGPTSend a customer-visible reply to a Chatway conversation as the authenticated agent. This creates an external side effect; do not use it when the user only asks for a draft or after human handoff has been requested. Use add-note for internal comments.
unresolve-conversation
ChatGPTReopen one or more resolved Chatway conversations. Send all target conversation UUIDs in one call and obtain user confirmation before changing their status. Use resolve-conversation to close them again.
update-custom-data
ChatGPTReplace the value of an existing custom field on a Chatway visitor/contact. Use add-custom-data when the field does not exist. Use list-custom-fields to check the exact field name first.