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
| Tool | Description |
|---|---|
list_conversations | List conversations, with filters (status, users, assignees, email domains) and cursor paging. |
get_conversation | Full details of one conversation. |
create_conversation | Start a conversation with a customer (customer_email, initial_message). |
update_conversation | Set status, is_spam, or pinned. |
filter_conversations | Available filter options (submitters, assignees, email domains). |
assign_conversation | Assign a team member (user_id). |
unassign_conversation | Remove the assignee. |
Messages
| Tool | Description |
|---|---|
list_messages | List messages in a conversation (most recent first). |
create_message | Reply in a conversation (body_html). |
update_message | Edit a message (message_id, body_html). |
delete_message | Delete a message. |
Customers
| Tool | Description |
|---|---|
list_customers | List all contacts in the organization. |
get_customer | Full details of one contact (user_id). |
create_customer | Create a contact (name, email). |
update_customer | Update a contact's blocked status. |
Team members
| Tool | Description |
|---|---|
list_team_members | List team members. |
get_team_member | Details of one member (member_id). |
invite_team_member | Invite a member (name, email, role). |
update_team_member | Change a member's role or archived status. |
remove_team_member | Remove a member. |
Organization
| Tool | Description |
|---|---|
get_organization | Organization details + the authenticated user. |
update_organization | Update the display_name. |
get_organization_settings | Read settings (locale, feature flags). |
update_organization_settings | Update 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.
MCP Server
Connect Claude, ChatGPT, and other AI clients to your SupportWire workspace over MCP.
Authorize request
Validate an authorization request and return consent metadata (app details, requested scopes, and the organizations the signed-in user may connect). Requires an authenticated user session.