Manage Re:amaze conversations, messages, contacts and help articles.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Create a new contact (customer). Re:amaze REST: POST /contacts.
The contact's display name (required).
The contact's email (required).
Arbitrary key/value custom attributes for the contact.
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Create a new contact (customer). Re:amaze REST: POST /contacts.
| Argument | Type | Description |
|---|---|---|
| data | object | Arbitrary key/value custom attributes for the contact. |
| name* | string | The contact's display name (required). |
| email* | string | The contact's email (required). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"email"
],
"properties": {
"data": {
"type": "object",
"description": "Arbitrary key/value custom attributes for the contact.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"name": {
"type": "string",
"description": "The contact's display name (required)."
},
"email": {
"type": "string",
"description": "The contact's email (required)."
}
}
}Create a new conversation (support ticket) with its first message. Re:amaze REST: POST /conversations.
| Argument | Type | Description |
|---|---|---|
| status | integer | Initial status. Status integer: 0=Open, 1=Responded, 2=Done, 3=Spam, 4=Archived, 5=On Hold, 6=Auto-Done, 7=AI Agent Assigned, 8=AI Agent Done, 9=Spam (AI). |
| subject* | string | The conversation subject (required). |
| assignee | string | Staff email to assign the conversation to. |
| category* | string | The channel slug to open the conversation in (required). |
| tag_list | array | Tags to apply to the conversation. |
| user_name* | string | The customer's display name (required). |
| recipients | array | Additional recipients (emails/phones) for the message. |
| user_email* | string | The customer's email (required). |
| message_body* | string | The first message body — markdown ok (required). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subject",
"category",
"message_body",
"user_name",
"user_email"
],
"properties": {
"status": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Initial status. Status integer: 0=Open, 1=Responded, 2=Done, 3=Spam, 4=Archived, 5=On Hold, 6=Auto-Done, 7=AI Agent Assigned, 8=AI Agent Done, 9=Spam (AI)."
},
"subject": {
"type": "string",
"description": "The conversation subject (required)."
},
"assignee": {
"type": "string",
"description": "Staff email to assign the conversation to."
},
"category": {
"type": "string",
"description": "The channel slug to open the conversation in (required)."
},
"tag_list": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags to apply to the conversation."
},
"user_name": {
"type": "string",
"description": "The customer's display name (required)."
},
"recipients": {
"type": "array",
"items": {
"type": "string"
},
"description": "Additional recipients (emails/phones) for the message."
},
"user_email": {
"type": "string",
"description": "The customer's email (required)."
},
"message_body": {
"type": "string",
"description": "The first message body — markdown ok (required)."
}
}
}Get a single help-center article by its slug. Re:amaze REST: GET /articles/{slug}.
| Argument | Type | Description |
|---|---|---|
| slug* | string | The article slug. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "The article slug."
}
}
}Get a single channel by its slug. Re:amaze REST: GET /channels/{slug}.
| Argument | Type | Description |
|---|---|---|
| slug* | string | The channel slug. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "The channel slug."
}
}
}Get a single contact (customer) by identifier (email or id). Re:amaze REST: GET /contacts/{identifier}.
| Argument | Type | Description |
|---|---|---|
| identifier* | string | A contact email or id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"identifier"
],
"properties": {
"identifier": {
"type": "string",
"description": "A contact email or id."
}
}
}Get a single conversation by its slug. Re:amaze REST: GET /conversations/{slug}.
| Argument | Type | Description |
|---|---|---|
| slug* | string | The conversation slug. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "The conversation slug."
}
}
}List/search help-center (knowledge-base) articles. All filters optional. Re:amaze REST: GET /articles.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number to fetch (responses report page_size/page_count/total_count). |
| filter | string | Free-text filter, e.g. a title/body substring. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number to fetch (responses report page_size/page_count/total_count)."
},
"filter": {
"type": "string",
"description": "Free-text filter, e.g. a title/body substring."
}
}
}List channels (inboxes: email, chat, social, etc.). Channel slugs are used as `category` filters. Re:amaze REST: GET /channels.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number to fetch (responses report page_size/page_count/total_count). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number to fetch (responses report page_size/page_count/total_count)."
}
}
}List/search contacts (customers). All filters optional; returns a page of contacts. Re:amaze REST: GET /contacts.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number to fetch (responses report page_size/page_count/total_count). |
| filter | string | Free-text filter, e.g. an email or name substring. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number to fetch (responses report page_size/page_count/total_count)."
},
"filter": {
"type": "string",
"description": "Free-text filter, e.g. an email or name substring."
}
}
}List/search conversations (support tickets). All filters optional; returns a page of conversations. Re:amaze REST: GET /conversations.
| Argument | Type | Description |
|---|---|---|
| for | string | Filter to conversations for this customer email. |
| tag | string | Filter by tag(s) — comma-separated. |
| page | integer | 1-based page number to fetch (responses report page_size/page_count/total_count). |
| sort | string | Sort order. |
| filter | string | Restrict to a set of conversations. |
| for_id | string | Filter to conversations for this SSO user id. |
| origin | string | Filter by conversation origin/channel type. |
| category | string | Filter by channel slug. |
| end_date | string | Filter to items on/before this ISO8601 date, e.g. 2026-01-31. |
List messages. If `conversation` (a slug) is given, list that conversation's messages (GET /conversations/{slug}/messages); otherwise list messages across the brand (GET /messages). All other filters optional. Re:amaze REST.
| Argument | Type | Description |
|---|---|---|
| tag | string | Filter by tag(s) — comma-separated. |
| page | integer | 1-based page number to fetch (responses report page_size/page_count/total_count). |
| filter | string | Restrict to staff or customer messages. |
| origin | integer | Filter by numeric message origin. |
| include | string | Include extra fields, e.g. 'original_body'. |
| sent_by | string | Filter to messages sent by this email. |
| category | string | Filter by channel slug. |
| end_date | string | Filter to items on/before this ISO8601 date, e.g. 2026-01-31. |
| start_date | string |
List staff (agent) accounts on the brand. Re:amaze REST: GET /staff.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number to fetch (responses report page_size/page_count/total_count). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number to fetch (responses report page_size/page_count/total_count)."
}
}
}Add a message to an existing conversation — a customer-facing reply or an internal note. Re:amaze REST: POST /conversations/{slug}/messages.
| Argument | Type | Description |
|---|---|---|
| body* | string | The message body — markdown ok (required). |
| slug* | string | The conversation slug to reply to. |
| user_name | string | Display name of the author. |
| attachment | string | URL of a file to attach. |
| recipients | array | Additional recipients (emails/phones). |
| user_email | string | Email of the author (customer or staff). |
| visibility | integer | 0 = Regular reply (customer-facing), 1 = Internal Note. Default 0. |
| suppress_notifications | boolean | If true, do not send notification emails for this message. |
Get the response-time report (how quickly conversations were answered). Both dates optional. Re:amaze REST: GET /reports/response_time.
| Argument | Type | Description |
|---|---|---|
| end_date | string | Filter to items on/before this ISO8601 date, e.g. 2026-01-31. |
| start_date | string | Filter to items on/after this ISO8601 date, e.g. 2026-01-31. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"end_date": {
"type": "string",
"description": "Filter to items on/before this ISO8601 date, e.g. 2026-01-31."
},
"start_date": {
"type": "string",
"description": "Filter to items on/after this ISO8601 date, e.g. 2026-01-31."
}
}
}Get the conversation-volume report (counts over time). Both dates optional. Re:amaze REST: GET /reports/volume.
| Argument | Type | Description |
|---|---|---|
| end_date | string | Filter to items on/before this ISO8601 date, e.g. 2026-01-31. |
| start_date | string | Filter to items on/after this ISO8601 date, e.g. 2026-01-31. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"end_date": {
"type": "string",
"description": "Filter to items on/before this ISO8601 date, e.g. 2026-01-31."
},
"start_date": {
"type": "string",
"description": "Filter to items on/after this ISO8601 date, e.g. 2026-01-31."
}
}
}Update fields on an existing contact. Only provided fields change. Re:amaze REST: PUT /contacts/{id}.
| Argument | Type | Description |
|---|---|---|
| id* | string | The contact id to update (goes in the path, never the body). |
| data | object | Arbitrary key/value custom attributes for the contact. |
| name | string | New display name. |
| string | New email. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The contact id to update (goes in the path, never the body)."
},
"data": {
"type": "object",
"description": "Arbitrary key/value custom attributes for the contact.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"name": {
"type": "string",
"description": "New display name."
},
"email": {
"type": "string",
"description": "New email."
}
}
}Update fields on an existing conversation (subject, status, tags, assignee). Only provided fields change. Re:amaze REST: PUT /conversations/{slug}.
| Argument | Type | Description |
|---|---|---|
| slug* | string | The conversation slug to update. |
| status | integer | New status. Status integer: 0=Open, 1=Responded, 2=Done, 3=Spam, 4=Archived, 5=On Hold, 6=Auto-Done, 7=AI Agent Assigned, 8=AI Agent Done, 9=Spam (AI). |
| subject | string | New subject. |
| assignee | string | Staff email to assign the conversation to. |
| tag_list | array | Replace the conversation's tags. |
| hold_until | string | ISO8601 DateTime to hold the conversation until (used when status=5 On Hold). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "The conversation slug to update."
},
"status": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "New status. Status integer: 0=Open, 1=Responded, 2=Done, 3=Spam, 4=Archived, 5=On Hold, 6=Auto-Done, 7=AI Agent Assigned, 8=AI Agent Done, 9=Spam (AI)."
},
"subject": {
"type": "string",
"description": "New subject."
},
"assignee": {
"type": "string",
"description": "Staff email to assign the conversation to."
},
"tag_list": {
"type": "array",
"items": {
"type": "string"
},
"description": "Replace the conversation's tags."
},
"hold_until": {
"type": "string",
"description": "ISO8601 DateTime to hold the conversation until (used when status=5 On Hold)."
}
}
}| start_date |
| string |
| Filter to items on/after this ISO8601 date, e.g. 2026-01-31. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"for": {
"type": "string",
"description": "Filter to conversations for this customer email."
},
"tag": {
"type": "string",
"description": "Filter by tag(s) — comma-separated."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number to fetch (responses report page_size/page_count/total_count)."
},
"sort": {
"enum": [
"updated",
"changed"
],
"type": "string",
"description": "Sort order."
},
"filter": {
"enum": [
"open",
"unassigned",
"archived",
"all"
],
"type": "string",
"description": "Restrict to a set of conversations."
},
"for_id": {
"type": "string",
"description": "Filter to conversations for this SSO user id."
},
"origin": {
"enum": [
"native",
"email",
"twitter",
"facebook",
"chat",
"api",
"instagram",
"sms",
"voice",
"custom",
"staff",
"form",
"instagram_dm"
],
"type": "string",
"description": "Filter by conversation origin/channel type."
},
"category": {
"type": "string",
"description": "Filter by channel slug."
},
"end_date": {
"type": "string",
"description": "Filter to items on/before this ISO8601 date, e.g. 2026-01-31."
},
"start_date": {
"type": "string",
"description": "Filter to items on/after this ISO8601 date, e.g. 2026-01-31."
}
}
}| Filter to items on/after this ISO8601 date, e.g. 2026-01-31. |
| conversation | string | Conversation slug — scopes to GET /conversations/{slug}/messages (goes in the PATH, not the query). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"tag": {
"type": "string",
"description": "Filter by tag(s) — comma-separated."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number to fetch (responses report page_size/page_count/total_count)."
},
"filter": {
"enum": [
"staff",
"customer"
],
"type": "string",
"description": "Restrict to staff or customer messages."
},
"origin": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter by numeric message origin."
},
"include": {
"enum": [
"original_body"
],
"type": "string",
"description": "Include extra fields, e.g. 'original_body'."
},
"sent_by": {
"type": "string",
"description": "Filter to messages sent by this email."
},
"category": {
"type": "string",
"description": "Filter by channel slug."
},
"end_date": {
"type": "string",
"description": "Filter to items on/before this ISO8601 date, e.g. 2026-01-31."
},
"start_date": {
"type": "string",
"description": "Filter to items on/after this ISO8601 date, e.g. 2026-01-31."
},
"conversation": {
"type": "string",
"description": "Conversation slug — scopes to GET /conversations/{slug}/messages (goes in the PATH, not the query)."
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"slug",
"body"
],
"properties": {
"body": {
"type": "string",
"description": "The message body — markdown ok (required)."
},
"slug": {
"type": "string",
"description": "The conversation slug to reply to."
},
"user_name": {
"type": "string",
"description": "Display name of the author."
},
"attachment": {
"type": "string",
"description": "URL of a file to attach."
},
"recipients": {
"type": "array",
"items": {
"type": "string"
},
"description": "Additional recipients (emails/phones)."
},
"user_email": {
"type": "string",
"description": "Email of the author (customer or staff)."
},
"visibility": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "0 = Regular reply (customer-facing), 1 = Internal Note. Default 0."
},
"suppress_notifications": {
"type": "boolean",
"description": "If true, do not send notification emails for this message."
}
}
}