Servers Playground How we check Add a server Log in

Asyntai

Working · 2.6 s

com.asyntai/support-agentv1.0.0 Domain verified

Run your website's AI support agent: knowledge, conversations, leads and live replies.

Sales & CRM

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://asyntai.com/mcp

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.

add_image

Add an image the chatbot may show. The description is what the AI reads to decide when the image answers the question, so describe what it shows and when it helps.

image_urlstring, required

Address of the image.

descriptionstring, required

What the image shows and when the chatbot should send it.

website_idinteger

Numeric id of the website, from list_websites. Omit to use the account's primary website.

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Asyntai MCP server | mcptry

Asyntai

Working · 2.6 s

com.asyntai/support-agentv1.0.0 Domain verified

Run your website's AI support agent: knowledge, conversations, leads and live replies.

Sales & CRM

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://asyntai.com/mcp

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.

add_image

Add an image the chatbot may show. The description is what the AI reads to decide when the image answers the question, so describe what it shows and when it helps.

image_urlstring, required

Address of the image.

descriptionstring, required

What the image shows and when the chatbot should send it.

website_idinteger

Numeric id of the website, from list_websites. Omit to use the account's primary website.

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (55)

add_image

Add an image the chatbot may show. The description is what the AI reads to decide when the image answers the question, so describe what it shows and when it helps.

Argument	Type	Description
image_url*	string	Address of the image.
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.
description*	string	What the image shows and when the chatbot should send it.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "image_url",
    "description"
  ],
  "properties": {
    "image_url": {
      "type": "string",
      "description": "Address of the image."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    },
    "description": {
      "type": "string",
      "description": "What the image shows and when the chatbot should send it."
    }
  },
  "additionalProperties": false
}

add_knowledge_text

Add a titled block of text to one website's knowledge base. The chatbot can use it in answers as soon as this returns. Adds a new entry; it never replaces an existing one.

Argument	Type	Description
title*	string	Short name for this entry, shown in the dashboard.
content*	string	The text itself. At least 10 characters.
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "title",
    "content"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Short name for this entry, shown in the dashboard."
    },
    "content": {
      "type": "string",
      "description": "The text itself. At least 10 characters."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

add_knowledge_url

Fetch one web page and add its text to the knowledge base. Use this for a single page. To take in a whole site, use start_crawl instead.

Argument	Type	Description
url*	string	Full address of the page, including https://.
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Full address of the page, including https://."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

add_product

Add a product the chatbot can show as a card. Needs the Standard plan or higher.

Argument	Type	Description
name*	string	Product name.
price	string	Price as text, for example 29 EUR.
image_url	string	Address of the product image.
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.
description	string	Short description shown on the card.
product_link	string	Address of the product page.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Product name."
    },
    "price": {
      "type": "string",
      "description": "Price as text, for example 29 EUR."
    },
    "image_url": {
      "type": "string",
      "description": "Address of the product image."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    },
    "description": {
      "type": "string",
      "description": "Short description shown on the card."
    },
    "product_link": {
      "type": "string",
      "description": "Address of the product page."
    }
  },
  "additionalProperties": false
}

add_webhook

Register a URL to receive events, for example every new message. Returns a signing secret once; store it, because it is never shown again. Needs a paid plan.

Argument	Type	Description
url*	string	HTTPS address that will receive the events.
events*	array	Event names to subscribe to.
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "url",
    "events"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "HTTPS address that will receive the events."
    },
    "events": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Event names to subscribe to."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

ask_ai

Ask one website's chatbot a question and get the answer a real visitor would receive. Use this to test the bot. It spends one message from the account's monthly allowance, and it calls an external model provider.

Argument	Type	Description
message*	string	The question to ask, as a visitor would type it.
session_id	string	Reuse the same value across calls to continue one test conversation. Omit to start a fresh one.
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "message"
  ],
  "properties": {
    "message": {
      "type": "string",
      "description": "The question to ask, as a visitor would type it."
    },
    "session_id": {
      "type": "string",
      "description": "Reuse the same value across calls to continue one test conversation. Omit to start a fresh one."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

create_website

Add a new website (a new AI agent) to the account and return its embed code. Each plan allows a limited number of websites, and this refuses once that limit is reached. By default it also starts a crawl of the site to build the knowledge base.

Argument	Type	Description
name	string	Display name for this agent. Optional.
crawl	boolean	Crawl the site after adding it. True by default.
domain*	string	The website address, for example shop.example.com.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domain"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Display name for this agent. Optional."
    },
    "crawl": {
      "type": "boolean",
      "description": "Crawl the site after adding it. True by default."
    },
    "domain": {
      "type": "string",
      "description": "The website address, for example shop.example.com."
    }
  },
  "additionalProperties": false
}

delete_image

Remove one image so the chatbot stops showing it.

destructive

Argument	Type	Description
image_id*	integer	Image id from list_images.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "image_id"
  ],
  "properties": {
    "image_id": {
      "type": "integer",
      "description": "Image id from list_images."
    }
  },
  "additionalProperties": false
}

delete_knowledge_entry

Permanently delete one knowledge base entry and every passage built from it. The chatbot stops using that content immediately. This cannot be undone.

destructive

Argument	Type	Description
entry_id*	string	The entry id from list_knowledge.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "entry_id"
  ],
  "properties": {
    "entry_id": {
      "type": "string",
      "description": "The entry id from list_knowledge."
    }
  },
  "additionalProperties": false
}

delete_product

Remove one product so the chatbot stops offering it.

destructive

Argument	Type	Description
product_id*	integer	Product id from list_products.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "product_id"
  ],
  "properties": {
    "product_id": {
      "type": "integer",
      "description": "Product id from list_products."
    }
  },
  "additionalProperties": false
}

delete_webhook

Delete one webhook. Events stop reaching that address at once.

destructive

Argument	Type	Description
webhook_id*	string	The webhook id from list_webhooks.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "webhook_id"
  ],
  "properties": {
    "webhook_id": {
      "type": "string",
      "description": "The webhook id from list_webhooks."
    }
  },
  "additionalProperties": false
}

get_account

Get the signed-in account's email, plan, and how many chat messages it has used against its monthly allowance.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_ai_instructions

Get the instructions that shape how one website's chatbot answers: its role, tone and rules.

read-only

Argument	Type	Description
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

get_analytics

Summarise one website's chat activity over a period: conversations, messages, leads captured, escalations, and the countries visitors came from.

read-only

Argument	Type	Description
days	integer	How many days back to measure (1-90, default 30).
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "days": {
      "type": "integer",
      "maximum": 90,
      "minimum": 1,
      "description": "How many days back to measure (1-90, default 30)."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

get_asyntai_doc

Read one page of Asyntai's documentation in full, given the url or slug from search_asyntai_docs, for example /documentation/mcp/ or just mcp.

read-only

Argument	Type	Description
page*	string	The url or slug of the page to read.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "page"
  ],
  "properties": {
    "page": {
      "type": "string",
      "description": "The url or slug of the page to read."
    }
  },
  "additionalProperties": false
}

get_conversation

Read the full message history of one conversation, in order, from its session id.

read-only

Argument	Type	Description
limit	integer	How many messages to return (1-200, default 100).
session_id*	string	Session id from list_conversations.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "session_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "How many messages to return (1-200, default 100)."
    },
    "session_id": {
      "type": "string",
      "description": "Session id from list_conversations."
    }
  },
  "additionalProperties": false
}

get_daily_report

Say whether the daily email summary is on for one website, and when the last one went out.

read-only

Argument	Type	Description
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

get_knowledge_entry

Read the stored text of one knowledge base entry. Works for the content you supplied: text, documents, spreadsheets, single pages and videos. A website crawl is listed but not exported, because the source is your own public site.

read-only

Argument	Type	Description
entry_id*	string	The entry id from list_knowledge.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "entry_id"
  ],
  "properties": {
    "entry_id": {
      "type": "string",
      "description": "The entry id from list_knowledge."
    }
  },
  "additionalProperties": false
}

get_website

Get the full record for one website: its name, domain, platform, widget id and the embed code to paste into the site.

read-only

Argument	Type	Description
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

get_website_features

Read the plan-gated features for one website: Real-Time Data Feed and its Max tier, Product Cards, Dynamic Images, User Context, Link Parameters, Chat Retention, Chat Categories, Access Tags, Widget Pinning, Zero Retention, PII Redaction and the Output Classifier. Shows current values, which features the plan allows, and the plan each locked feature needs.

read-only

Argument	Type	Description
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

get_widget_settings

Read all appearance and behaviour settings for one website's chat widget: colours, greeting, position, auto-trigger, data collection, bookings and the rest. Also returns which settings this account's plan cannot change, and the plan each of those needs.

read-only

Argument	Type	Description
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

list_active_sessions

List the visitors currently in a chat: which page they are on, their country, how long they have been there, and whether a human has taken the conversation over. Needs the Standard plan or higher.

read-only

Argument	Type	Description
limit	integer	How many sessions to return (1-100, default 25).
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "How many sessions to return (1-100, default 25)."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

list_audit_log

Read the record of what changed on this account: who did it, when, and from where. Recorded on the Enterprise plan only.

read-only

Argument	Type	Description
days	integer	How many days back to read (1-90, default 30).
limit	integer	How many entries to return (1-100, default 50).
category	string	Only entries in this category. Optional.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "days": {
      "type": "integer",
      "maximum": 90,
      "minimum": 1,
      "description": "How many days back to read (1-90, default 30)."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "How many entries to return (1-100, default 50)."
    },
    "category": {
      "type": "string",
      "description": "Only entries in this category. Optional."
    }
  },
  "additionalProperties": false
}

list_booking_types

List the appointment types visitors can book, with length, price and how many spots each has. Bookings needs the Standard plan or higher.

read-only

Argument	Type	Description
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

list_conversations

List recent visitor conversations for one website, newest first, with the session id, message count and any email or phone the visitor gave.

read-only

Argument	Type	Description
days	integer	How many days back to look (1-90, default 7).
limit	integer	How many conversations to return (1-100, default 20).
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.
with_leads_only	boolean	Only return conversations where the visitor left an email or phone.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "days": {
      "type": "integer",
      "maximum": 90,
      "minimum": 1,
      "description": "How many days back to look (1-90, default 7)."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "How many conversations to return (1-100, default 20)."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    },
    "with_leads_only": {
      "type": "boolean",
      "description": "Only return conversations where the visitor left an email or phone."
    }
  },
  "additionalProperties": false
}

list_crawls

List recent crawl jobs for one website with their status, how many pages they took, and why each one stopped.

read-only

Argument	Type	Description
limit	integer	How many jobs to return (1-50, default 10).
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "How many jobs to return (1-50, default 10)."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

list_embeds

List the third-party tools embedded in the chat, such as a booking calendar or a form. Embeds needs the Standard plan or higher.

read-only

Argument	Type	Description
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

list_images

List the images the chatbot may show a visitor, with the description that tells it when each one is relevant.

read-only

Argument	Type	Description
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

list_knowledge

List the sources in one website's knowledge base: uploaded text, documents, added pages and crawls.

read-only

Argument	Type	Description
limit	integer	How many entries to return (1-100, default 50).
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "How many entries to return (1-100, default 50)."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

list_knowledge_gaps

List the Knowledge Gaps Asyntai recorded: real visitor questions the chatbot could not answer. Use this to find what to fill in with add_knowledge_text. Needs the Standard plan or higher.

read-only

Argument	Type	Description
days	integer	How many days back to look (1-90, default 30).
limit	integer	How many gaps to return (1-100, default 25).
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.
include_resolved	boolean	Include gaps already marked as resolved. Off by default.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "days": {
      "type": "integer",
      "maximum": 90,
      "minimum": 1,
      "description": "How many days back to look (1-90, default 30)."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "How many gaps to return (1-100, default 25)."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    },
    "include_resolved": {
      "type": "boolean",
      "description": "Include gaps already marked as resolved. Off by default."
    }
  },
  "additionalProperties": false
}

list_leads

List the email addresses and phone numbers visitors left in chat, newest first, with the page they were on.

read-only

Argument	Type	Description
limit	integer	How many leads to return (1-100, default 50).
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "How many leads to return (1-100, default 50)."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

list_plans

List every Asyntai plan with its price, monthly message allowance and the features it includes, alongside the plan this account is on. Use it to explain which plan includes a feature the account asks about.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

list_products

List the products the chatbot can show as cards, with price and links. Product Cards needs the Standard plan or higher.

read-only

Argument	Type	Description
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

list_team_members

List the people who share this account, what each may reach, and how many seats the plan allows.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

list_tickets

List support tickets raised from chat, with status, priority and the visitor's details. Needs the Standard plan or higher.

read-only

Argument	Type	Description
limit	integer	How many tickets to return (1-100, default 25).
status	string	Only tickets with this status, for example open or resolved.
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "How many tickets to return (1-100, default 25)."
    },
    "status": {
      "type": "string",
      "description": "Only tickets with this status, for example open or resolved."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

list_visitor_questions

List what visitors asked the chatbot in a period: the first questions of each conversation, without the chatbot's answers. Use this to find what customers ask about most: group the questions by meaning and give examples. Counts you make by grouping are estimates; say so. When Chat Categories is on, the result also carries exact chat counts per category. To read one conversation in full, use get_conversation.

read-only

Argument	Type	Description
days	integer	How many days back to look (1-90, default 30).
limit	integer	Most questions to return (1-500, default 300).
per_chat	integer	Questions taken from each conversation (1-5, default 2).
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "days": {
      "type": "integer",
      "maximum": 90,
      "minimum": 1,
      "description": "How many days back to look (1-90, default 30)."
    },
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Most questions to return (1-500, default 300)."
    },
    "per_chat": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1,
      "description": "Questions taken from each conversation (1-5, default 2)."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

list_webhooks

List the webhooks registered on this account. The signing secret is never returned; it is shown once, when the webhook is created.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

list_websites

List the websites (AI agents) on this Asyntai account, with the id every other tool takes. Start here when the account may have more than one.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

list_widget_translations

List the languages the chat widget has its own wording for, with the greeting and agent name used in each.

read-only

Argument	Type	Description
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

release_conversation

Hand a taken-over conversation back to the AI, which answers the visitor again from the next message.

destructive

Argument	Type	Description
session_id*	string	Session id of the conversation.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "session_id"
  ],
  "properties": {
    "session_id": {
      "type": "string",
      "description": "Session id of the conversation."
    }
  },
  "additionalProperties": false
}

search_asyntai_docs

Search Asyntai's own product documentation and get back the pages that match, with a short excerpt from each. Use this to find out how a feature works before changing anything, rather than guessing. This searches Asyntai's documentation, NOT the customer's own content: for that, use search_knowledge_base. Matching is by keyword, so if the results look wrong, search again using Asyntai's own feature names, for example data feed, widget pinning, access tags, AI instructions.

read-only

Argument	Type	Description
limit	integer	How many pages to return, 1 to 20. Default 8.
query*	string	What to look for.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "description": "How many pages to return, 1 to 20. Default 8."
    },
    "query": {
      "type": "string",
      "description": "What to look for."
    }
  },
  "additionalProperties": false
}

search_knowledge_base

Search one website's knowledge base and return the passages the chatbot would retrieve for this question, with a relevance score. Use this to check what the chatbot knows about a topic. It does not generate an answer and does not use the message allowance.

read-only

Argument	Type	Description
limit	integer	How many passages to return (1-20, default 5).
query*	string	What to look for, in plain language.
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1,
      "description": "How many passages to return (1-20, default 5)."
    },
    "query": {
      "type": "string",
      "description": "What to look for, in plain language."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

send_agent_reply

Send a message, as a human agent, to a real visitor who is chatting right now. Take the conversation over first. The visitor sees this immediately, so show the user the exact wording and get their agreement before calling this.

Argument	Type	Description
message*	string	The text to send to the visitor.
agent_name	string	Name shown to the visitor. Defaults to the account's agent name.
session_id*	string	Session id of the conversation.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "session_id",
    "message"
  ],
  "properties": {
    "message": {
      "type": "string",
      "description": "The text to send to the visitor."
    },
    "agent_name": {
      "type": "string",
      "description": "Name shown to the visitor. Defaults to the account's agent name."
    },
    "session_id": {
      "type": "string",
      "description": "Session id of the conversation."
    }
  },
  "additionalProperties": false
}

set_access_tags

Switch Access Tags on or off for one website. Turning it on creates the signing secret your server needs to sign visitor entitlements. Needs the Enterprise plan.

destructive

Argument	Type	Description
enabled*	boolean	True to switch it on.
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "enabled"
  ],
  "properties": {
    "enabled": {
      "type": "boolean",
      "description": "True to switch it on."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

set_daily_report

Turn the daily email summary of chats on or off for one website. Needs the Standard plan or higher.

destructive

Argument	Type	Description
enabled*	boolean	True to switch it on.
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "enabled"
  ],
  "properties": {
    "enabled": {
      "type": "boolean",
      "description": "True to switch it on."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

set_data_feed

Point the chatbot at a product feed and index it. This fetches the feed, checks it really is a feed, clears whatever was indexed before, and rebuilds the index in the background. Send an empty url to remove the feed. Needs the Standard plan or higher.

destructive

Argument	Type	Description
url*	string	Address of the product feed. Empty removes it.
enabled	boolean	Whether the chatbot may use the feed.
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Address of the product feed. Empty removes it."
    },
    "enabled": {
      "type": "boolean",
      "description": "Whether the chatbot may use the feed."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

set_data_feed_max

Same as set_data_feed, for the Max tier, which indexes a larger catalogue. Fetches, validates, clears the old index and rebuilds it in the background. Needs the Pro plan or higher.

destructive

Argument	Type	Description
url*	string	Address of the product feed. Empty removes it.
enabled	boolean	Whether the chatbot may use the feed.
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Address of the product feed. Empty removes it."
    },
    "enabled": {
      "type": "boolean",
      "description": "Whether the chatbot may use the feed."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

set_knowledge_tags

Restrict who can retrieve one knowledge base entry. A visitor must present a matching tag, signed by your own server, before the chatbot will use the entry. Send an empty list to make it public again. Access Tags needs the Enterprise plan.

destructive

Argument	Type	Description
entry_id*	string	The entry id from list_knowledge.
access_tags*	array	Tag names. An empty list makes the entry public.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "entry_id",
    "access_tags"
  ],
  "properties": {
    "entry_id": {
      "type": "string",
      "description": "The entry id from list_knowledge."
    },
    "access_tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tag names. An empty list makes the entry public."
    }
  },
  "additionalProperties": false
}

set_widget_pinning

Freeze the chat widget at its current version, so the site always serves the same copy with an integrity hash. Turning it on builds that snapshot and changes the embed code. Needs the Enterprise plan.

destructive

Argument	Type	Description
enabled*	boolean	True to pin the widget.
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "enabled"
  ],
  "properties": {
    "enabled": {
      "type": "boolean",
      "description": "True to pin the widget."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

set_widget_translation

Set the chat widget's greeting, agent name and bubble text for one language. A visitor in that language sees this wording instead of the default.

destructive

Argument	Type	Description
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.
language_code*	string	Language code, for example de or fr.
ai_support_name	string	Agent name shown in the header.
initial_message	string	The greeting the visitor sees first.
notification_bubble_text	string	Text of the notification bubble.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "language_code"
  ],
  "properties": {
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    },
    "language_code": {
      "type": "string",
      "description": "Language code, for example de or fr."
    },
    "ai_support_name": {
      "type": "string",
      "description": "Agent name shown in the header."
    },
    "initial_message": {
      "type": "string",
      "description": "The greeting the visitor sees first."
    },
    "notification_bubble_text": {
      "type": "string",
      "description": "Text of the notification bubble."
    }
  },
  "additionalProperties": false
}

start_crawl

Crawl a website and add its pages to the knowledge base. Runs in the background; check on it with list_crawls. Each plan caps the pages per crawl, and asking for more than the cap is refused.

Argument	Type	Description
max_pages	integer	How many pages to take at most. Capped by the plan.
start_url	string	Where to start. Defaults to the website's own domain.
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "max_pages": {
      "type": "integer",
      "minimum": 1,
      "description": "How many pages to take at most. Capped by the plan."
    },
    "start_url": {
      "type": "string",
      "description": "Where to start. Defaults to the website's own domain."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

take_over_conversation

Stop the AI answering one conversation so a human can reply instead. The visitor is told a person has joined. Use send_agent_reply afterwards, and release_conversation when done. Needs the Standard plan or higher.

destructive

Argument	Type	Description
session_id*	string	Session id from list_active_sessions.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "session_id"
  ],
  "properties": {
    "session_id": {
      "type": "string",
      "description": "Session id from list_active_sessions."
    }
  },
  "additionalProperties": false
}

update_ai_instructions

Replace one website's AI instructions with new text. This overwrites the current instructions and changes how the live chatbot answers every visitor. Read them with get_ai_instructions first, and show the user what will change before calling this.

destructive

Argument	Type	Description
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.
instructions*	string	The full new instructions text.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "instructions"
  ],
  "properties": {
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    },
    "instructions": {
      "type": "string",
      "description": "The full new instructions text."
    }
  },
  "additionalProperties": false
}

update_website_features

Turn website features on or off and set their values, for example the Real-Time Data Feed URL or the PII Redaction rules. Pass an object of field name to value; read them with get_website_features first. A feature the plan does not include is refused with the plan it needs. These change how the live chatbot behaves for every visitor.

destructive

Argument	Type	Description
fields*	object	Field name to new value, for example real_time_products_enabled set to true.
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "fields"
  ],
  "properties": {
    "fields": {
      "type": "object",
      "description": "Field name to new value, for example real_time_products_enabled set to true."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}

update_widget_settings

Change one or more chat widget settings. Pass an object of setting name to new value; read them with get_widget_settings first. Changes are live for every visitor at once. Settings the plan does not include are refused with the plan they need, and nothing is written unless every value is valid.

destructive

Argument	Type	Description
settings*	object	Setting name to new value, for example widget_color set to #6366f1.
website_id	integer	Numeric id of the website, from list_websites. Omit to use the account's primary website.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "settings"
  ],
  "properties": {
    "settings": {
      "type": "object",
      "description": "Setting name to new value, for example widget_color set to #6366f1."
    },
    "website_id": {
      "type": "integer",
      "description": "Numeric id of the website, from list_websites. Omit to use the account's primary website."
    }
  },
  "additionalProperties": false
}