Mcp Typebot

Overview

What is MCP-typebot?

MCP-typebot is an innovative project hosted on GitHub, developed by the user osdeibi. This repository is designed to facilitate the creation and management of chatbots using the MCP (Multi-Channel Protocol) framework. The project aims to streamline the process of building bots that can operate across various messaging platforms, providing users with a versatile tool for enhancing communication and automation.

Features of MCP-typebot

Multi-Channel Support: MCP-typebot allows developers to create bots that can interact with users across multiple messaging platforms, ensuring a wider reach and better user engagement.
User-Friendly Interface: The project is designed with usability in mind, making it easier for developers of all skill levels to create and manage their chatbots.
Customizable Templates: Users can customize their bots with various templates, enabling them to tailor the bot's responses and functionalities to meet specific needs.
Open Source: Being a public repository, MCP-typebot is open for contributions, allowing developers to collaborate and enhance the project further.

How to Use MCP-typebot

Clone the Repository: Start by cloning the MCP-typebot repository from GitHub to your local machine using the command:
```
git clone https://github.com/osdeibi/MCP-typebot.git
```
Install Dependencies: Navigate to the project directory and install the necessary dependencies. This can typically be done using a package manager like npm or yarn:
```
cd MCP-typebot
npm install
```
Configure Your Bot: Modify the configuration files to set up your bot's parameters, including API keys, response templates, and channel settings.
Run Your Bot: Once everything is set up, you can start your bot using the command:
```
npm start
```
Test and Deploy: Test your bot in a development environment before deploying it to production. Ensure that it interacts correctly across all intended messaging platforms.

Frequently Asked Questions

What programming languages are used in MCP-typebot?

MCP-typebot primarily uses JavaScript, leveraging Node.js for server-side functionality.

Can I contribute to the MCP-typebot project?

Yes! As an open-source project, contributions are welcome. You can fork the repository, make your changes, and submit a pull request for review.

Is there documentation available for MCP-typebot?

Yes, detailed documentation is available in the repository's README file and additional markdown files that explain various functionalities and setup instructions.

How can I report issues or bugs?

You can report issues by navigating to the "Issues" tab in the MCP-typebot GitHub repository and submitting a new issue with a detailed description of the problem.

Is MCP-typebot suitable for beginners?

Absolutely! MCP-typebot is designed to be user-friendly, making it accessible for developers at all skill levels, including beginners.

Details

MCP-Typebot

A small MCP server that exposes Typebot’s REST API as callable tools in Claude Desktop (via STDIO). You can create, list, get, update, delete, publish/unpublish Typebots, list results, and start chats—using natural-language commands.

Features

createBot
Create a new Typebot in your workspace.
Required: name
Optional: workspaceId, description
listBots
List all Typebots in your workspace.
Optional: workspaceId
getBot
Fetch a Typebot by its ID.
Required: botId
updateBot
Patch an existing Typebot (e.g. rename).
Required: botId, typebot (object with fields to change)
Optional: overwrite
deleteBot
Delete a Typebot by its ID.
Required: botId
publishBot / unpublishBot
Toggle a Typebot’s published state.
Required: botId
listResults
Retrieve conversation results for a Typebot.
Required: botId
Optional: limit, cursor, timeFilter, timeZone
startChat
Begin a new chat session with a Typebot.
Required: botId
Optional: chat.context

Prerequisites

Node.js 18+
A valid Typebot API token and workspace ID
Claude Desktop connected to your local MCP server

Installation

git clone <repo-url>
cd mcp-typebot
npm install
npm run build

You can also install the published package directly via npm:

npm install mcp-typebot
npm start

Running

npm start

This starts the MCP server on STDIO. Claude Desktop (or any MCP client) will connect to it automatically.

Usage in Claude Desktop

Simply write natural commands like:

User: “Create me a new typebot”
Claude: “Sure—what name?”
User: “MyDemoBot”
Claude (internally invokes):
@createBot {"name":"MyDemoBot"}

Or, explicitly:

@updateBot {"botId":"<your_bot_id>","typebot":{"name":"NewName"},"overwrite":true}

You can also start a chat:

@startChat {"botId":"<your_bot_id>"}

Extending

Add new tools by implementing them in src/tools/bots.ts and registering them in src/index.ts.
Define a Zod schema for each tool to get automatic prompting and validation.

License

Configuring Claude Desktop

To connect Claude Desktop to this MCP server, add the following to your Claude configuration (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "mcp-typebot": {
      "command": "node",
      "args": [
        "path/to/project/dist/index.js"
      ],
      "env": {
        "TYPEBOT_TOKEN": "YOUR_TOKEN_HERE",
        "TYPEBOT_WORKSPACE_ID": "YOUR_WORKSPACE_ID"
      }
    }
  }
}

Make sure the command and args point to your local built index.js, and that your .env values match those in env.

{ "mcpServers": { "mcp-typebot": { "command": "node", "args": [ "path/to/project/dist/index.js" ], "env": { "TYPEBOT_TOKEN": "YOUR_TOKEN_HERE", "TYPEBOT_WORKSPACE_ID": "YOUR_WORKSPACE_ID" } } } }