FlowCastle
About
Build, edit, and deploy Telegram bots on FlowCastle's hosted visual flow platform.
Details
- Author
- flowcastle
- Categories
- Communication, Other, Productivity
Jump to
Setup
Install FlowCastle in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/flowcastle/telegram-bot-templates
Follow the installation instructions in the repository README, then restart your MCP client.
Telegram bot templates + MCP server for AI bot development
Ready-to-useTelegram bot templatesand anMCP server— build, edit, and deploy Telegram bots from Claude Code, Codex, Cursor, or any MCP-capable AI agent. No SDK boilerplate: describe the bot, and your agent assembles the flow.
This repo is for developers. It contains:
FlowCastle exposes an MCP server overStreamable HTTP:
POST https://api.flowcastle.ai/api/mcp Authorization: Bearer <your-application-api-key> # starts with app_
Get a key:sign up→ create an application →APIpage →MCPtab.
export FLOWCASTLE_MCP_TOKEN='<your-application-api-key>' claude mcp add --transport http flowcastle https://api.flowcastle.ai/api/mcp \ --header "Authorization: Bearer $FLOWCASTLE_MCP_TOKEN"
codex mcp add flowcastle \ --url https://api.flowcastle.ai/api/mcp \ --bearer-token-env-var FLOWCASTLE_MCP_TOKEN
{ "mcpServers": { "flowcastle": { "type": "http", "url": "https://api.flowcastle.ai/api/mcp", "headers": { "Authorization": "Bearer <your-application-api-key>" } } } }
"Look at my FlowCastle workspace and add a lead-qualification flow: greet on /start, ask three button questions, save answers to contact variables, and notify me."
The agent reads your workspace withget_workspace_summary/get_flow_context, drafts a batch of flow-builder actions, checks it withvalidate_actions, and applies it withapply_actions. Seemcp/README.mdfor the full tool reference.
Each JSON file intemplates/is a complete bot: metadata (title, summary, use-cases, suggested variables, required modules) plus aschemaExample.actionsarray — an ordered batch ofcreate_flow/create_block/create_link/create_variableoperations in the exact formatapply_actionsaccepts.
- One-click installfrom the gallery:flowcastle.ai/templates
- Via MCP— ask your agent tosearch_flow_examples/get_flow_exampleand apply one (optionally customized) to your workspace
- As reference— study how real flows wire triggers, conditions, wait-for-reply steps, payments, and AI blocks
Full index and format description:templates/README.md.
Application-scoped REST API for contacts, contact variables, goal events, flow sends, and broadcasts:
- Base URL:https://api.flowcastle.ai/api/public/v1
- Interactive docs (Swagger):https://api.flowcastle.ai/api/public/docs
- OpenAPI spec:https://api.flowcastle.ai/api/public/openapi.json
Auth uses the sameapp_…application key (Authorization: BearerorX-API-Key).
Step-by-step builds on theFlowCastle blog:
- Build a Lead Bot in Telegram in 10 Minutes
- Build an AI Support Bot for Telegram
- I Replaced My Morning Apps With One Telegram Bot
- Product:https://flowcastle.ai
- Dashboard:https://dashboard.flowcastle.ai
- Template gallery:https://flowcastle.ai/templates
- API docs:https://api.flowcastle.ai/api/public/docs
Found a bug in a template, or built a flow worth sharing? Open an issue or PR — templates are plain JSON, andvalidate_actions(via MCP) will tell you if a batch is well-formed.
The contents of this repository are licensed under theMIT License.
MCP server for Telegram bots built with aiogram. 30 tools, 7 resources, 3 prompts — messaging, rich media, moderation, interactive keyboards, real-time event streaming, rate limiting, permissions, and audit logging.
Production-grade MCP server for Telegram with dual-mode Bot API + MTProto, 6 composite tools
Read-only public stats for Telegram groups tracked by Limzo — activity, engagement, mood and leaderboards, no API key required.
Telegram MCP server with 20 tools — read chats, search messages, download media via MTProto
A simple gateway to interact with Telegram bots using MCP and a REST API, enabling integration with LLMs.
MCTL for Telegram lets users access and manage their own Telegram account from ChatGPT after explicit user authorization. It supports reading recent chats, summarizing messages, drafting replies, preview-only sending by default, confirmed pin actions, audit review, and account disconnect/delete controls. It is not an official Telegram app or Telegram API partner, and Telegram message content is treated as untrusted user-generated data.
Manage your WhatsApp, SMS and Phone Calls using a single MCP connector
Connect to any function, any language, across network boundaries using AgentRPC.
Access your meeting transcripts, summaries, and action items from any AI assistant.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
