Crisp MCP

🚀 Crisp MCP Server

An MCP (Model Context Protocol) server that provides tools for interacting with the Crisp customer support platform.

🚀 Quick Start

The Crisp MCP Server is an MCP (Model Context Protocol) server designed to offer tools for interacting with the Crisp customer support platform.

📦 Installation

cd mcp-servers/crisp-mcp
npm install
npm run build

📚 Documentation

Configuration

The server requires the following environment variables:

You can get these credentials from the Crisp Marketplace by creating a plugin, or from your Crisp dashboard settings.

Usage with Claude Code

Add the following to your Claude Code MCP settings (.claude/settings.json or global settings):

{
  "mcpServers": {
    "crisp": {
      "command": "node",
      "args": ["/path/to/mcp-servers/crisp-mcp/dist/index.js"],
      "env": {
        "CRISP_IDENTIFIER": "your-identifier",
        "CRISP_KEY": "your-key",
        "CRISP_WEBSITE_ID": "your-website-id"
      }
    }
  }
}

Available Tools

Conversation Management

Messages

Conversation State

Conversation Actions

Team & Visitors

Available Resources

💻 Usage Examples

Basic Usage

List unresolved conversations

Use the list_conversations tool with unresolved_only: true

Get a support ticket with full context

Use the get_conversation_with_messages tool with the session_id

Reply to a customer

Use the send_message tool with session_id and content

Mark a ticket as resolved

Use the set_conversation_state tool with state: "resolved"

🔧 Technical Details

# Watch mode for development
npm run dev

# Build for production
npm run build

# Run the server
npm start

📄 License

MIT