MCP Server

Quickstart

Updated on May 27, 2026

Crisp runs a MCP server that allows you to access and manipulate data from your Crisp workspace, like a developer would do using the Crisp REST API.

Connecting to the Crisp MCP Server is very easy. If you already used the Crisp REST API, then the process will feel familiar to you.

The Crisp MCP Server is available at: https://api.crisp.chat/mcp/

⏰ 1 Minute Setup

Follow those steps to connect to the Crisp MCP Server in your favorite AI tool:

Add a new MCP server in your tool
Choose transport type: Streamable HTTP
In the URL, enter: https://api.crisp.chat/mcp/
Provide the following Authorization header: Authorization: Basic <CRISP_REST_API_TOKEN> — the Base64 of your REST API keypair
Provide the following Tier header: X-Crisp-Tier: <website|user|plugin> — your REST API authentication tier
Hit the connect to MCP server button
In the list of tools, you should now see tools like: get_website (more tools will be listed)
To verify your authentication token is valid, make a tool call and check for the response

How to connect to the Crisp MCP Server (here, in Le Chat from Mistral)

Authentication

How to obtain my authentication token?

👉 You can obtain your authentication token by following this guide from the REST API.

💡 Tip: you may use a tool like an online Base64 Encoder to generate your Basic Auth string. Paste your identifier:key string to the ASCII Plain Text input and get your encoded string in the Base64 input.

How to configure my authentication token?

The Crisp MCP Server uses the same token as the Crisp REST API. As such, depending on the type of token you will be using, the same ACLs enforced on the REST API apply (e.g. token scopes).

Authenticate to the MCP Server using those 2 headers

Make sure to pass your token tier (website, plugin or user) in your MCP authentication header using the HTTP header X-Crisp-Tier.

Which token tier is recommended for the MCP Server?

We recommend that you use a website tier token for the MCP Server. This is the simplest way to connect to your workspace.

If, however, you are looking to distribute authentication tokens to your teammates to perform mostly read-access operations on your workspace, we advise you instead use a plugin tier token with read-only ACLs and well-defined scopes to limit access to your workspace resources.

Usage

What can I do with the MCP Server?

The Crisp MCP Server offers tools to access data from your Crisp workspace, but also make write operations (such as changing a conversation state, sending messages, etc.).

Here are examples of things you can now ask your AI Agent:

1️⃣ "Send a survey to resolved conversations from yesterday, asking if they were satisfied with the support provided."
2️⃣ "Tell me which operators are online in my workspace."
3️⃣ "Suggest improvements to my helpdesk article about our refund policy, users said they were confused about the maximum delay after purchase."