SupportWire API
MCP Server

Tools

Every tool the SupportWire MCP server exposes.

Tools require the matching scope, granted when you connected. Each maps to the same operations as the REST API.

Conversations

ToolDescription
list_conversationsList conversations, with filters (status, users, assignees, email domains) and cursor paging.
get_conversationFull details of one conversation.
create_conversationStart a conversation with a customer (customer_email, initial_message).
update_conversationSet status, is_spam, or pinned.
filter_conversationsAvailable filter options (submitters, assignees, email domains).
assign_conversationAssign a team member (user_id).
unassign_conversationRemove the assignee.

Messages

ToolDescription
list_messagesList messages in a conversation (most recent first).
create_messageReply in a conversation (body_html).
update_messageEdit a message (message_id, body_html).
delete_messageDelete a message.

Customers

ToolDescription
list_customersList all contacts in the organization.
get_customerFull details of one contact (user_id).
create_customerCreate a contact (name, email).
update_customerUpdate a contact's blocked status.

Team members

ToolDescription
list_team_membersList team members.
get_team_memberDetails of one member (member_id).
invite_team_memberInvite a member (name, email, role).
update_team_memberChange a member's role or archived status.
remove_team_memberRemove a member.

Organization

ToolDescription
get_organizationOrganization details + the authenticated user.
update_organizationUpdate the display_name.
get_organization_settingsRead settings (locale, feature flags).
update_organization_settingsUpdate allow_guest_submission, enable_ai_assistant, bot_configuration, locale.

UI widgets

In clients that support MCP UI, several tools render interactive HTML cards (ui://widget/…): conversations list, conversation detail, customers list, customer detail, and team members.

On this page