TeleBotBuilder

Build and edit Telegram bots by chatting: flows, buttons, templates and Telegram Stars payments, with a check before every save and one-step undo.

Hosted MCP Server

npx add-mcp 'https://api.telebotbuilder.com/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

TeleBotBuilder MCP Server

Build and edit Telegram bots by chatting with your AI assistant.

TeleBotBuilder is a no-code Telegram bot builder. This is its official remote MCP server: connect it to Claude, ChatGPT, Cursor, VS Code or any MCP client, describe what your bot should do, and the assistant builds the conversation flow (messages, buttons, menus, conditions, saved data, Telegram Stars payment steps), checks it for problems first, and saves it to your bot.

This repository holds documentation only. The server is hosted and maintained by TeleBotBuilder; there is nothing to install or run.

What you need

  1. A free TeleBotBuilder account (sign in with Google at telebotbuilder.com).
  2. A Telegram bot connected to it (create one with @BotFather).

Some block types depend on your TeleBotBuilder account; the assistant tells you when that applies.

Connect

Claude (web, desktop, mobile)

Find TeleBotBuilder in Claude's connector directory, or add it yourself: Settings > Connectors > Add custom connector, then:

  • Name: TeleBotBuilder
  • URL: https://api.telebotbuilder.com/mcp

Sign in to TeleBotBuilder in the window that opens and press Allow.

Claude Code

claude mcp add --transport http telebotbuilder https://api.telebotbuilder.com/mcp

ChatGPT

  1. Open Plugins and choose Add.
  2. Choose Add custom MCP server.
  3. Enter a name (for example TeleBotBuilder) and the URL https://api.telebotbuilder.com/mcp.
  4. Accept and connect, then sign in to TeleBotBuilder and press Allow.

Cursor

Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "telebotbuilder": {
      "url": "https://api.telebotbuilder.com/mcp"
    }
  }
}

VS Code

Add to your settings.json:

{
  "mcp": {
    "servers": {
      "telebotbuilder": {
        "type": "http",
        "url": "https://api.telebotbuilder.com/mcp"
      }
    }
  }
}

Other clients

Any client that supports remote MCP servers over Streamable HTTP with OAuth works. Use the server URL above; the client discovers the sign-in details from the server.

Try it

  • "List my TeleBotBuilder bots and the flows on my main bot."
  • "Build a FAQ flow for my bakery bot with buttons for opening hours, delivery and contact. Check it first, then save it."
  • "In my /faq flow, add a Buy now button under the prices answer that sells it for 50 Telegram Stars."
  • "Undo the last change to my /faq flow."
  • "Add the Tip jar template to my bot."

Tools

ToolTitleType
list_botsList botsRead
list_flowsList flowsRead
get_flowRead a flowRead
get_blueprint_specGet blueprint formatRead
list_templatesList templatesRead
get_bot_statsGet bot statsRead
create_flow_from_blueprintCreate flow from blueprintWrite
import_templateAdd a templateWrite
update_flowUpdate a flowWrite (replaces a flow)
restore_snapshotUndo a changeWrite (restores a saved copy)

Every write can be checked first with a dry run, and every update saves a copy of the flow before changing it, so any change can be undone.

What it can never do

  • Delete bots or flows
  • Send messages or broadcasts
  • See your contacts or their messages
  • See bot tokens (secret values in a flow show as placeholders such as <<YOUR_API_KEY>> and are kept)
  • See or move money (it can add a Telegram Stars payment step to a flow, which your own bot runs; it has no access to payment records or payouts)

Privacy and security

  • OAuth 2.1 with PKCE; access tokens last 1 hour, refresh tokens rotate and are stored only as hashes.
  • Each tool call writes an audit row (tool name, ids, outcome, size, duration) with no flow text, prompts or message content. Audit rows are deleted after 90 days.
  • You can disconnect at any time in TeleBotBuilder under Settings > Connected AI apps.
  • Full policy: telebotbuilder.com/privacy.html (section 11, Connected AI apps).

Support

License

The documentation in this repository is available under the MIT License. TeleBotBuilder itself is a hosted service and is not open source.