FlowCastle

Plantillas de bots de Telegram + servidor MCP para desarrollo de bots con IA

Plantillas de bots de Telegram listas para usar y un servidor MCP: crea, edita e implementa bots de Telegram desde Claude Code, Codex, Cursor o cualquier agente de IA compatible con MCP. Sin código repetitivo de SDK: describe el bot y tu agente ensambla el flujo.

FlowCastle es un constructor visual de flujos de trabajo para bots de Telegram y chat web: flujos, disparadores, condiciones, pasos de IA, pagos (Stripe / YooKassa / Telegram Stars), transmisiones, secuencias de goteo e integraciones (Gmail, Google Sheets, Notion, OpenAI, …) — con una API REST y un servidor MCP, para que el desarrollo de bots funcione directamente desde tu agente de codificación con IA. Cada bloque que un agente crea a través de MCP es el mismo bloque que puedes arrastrar, conectar y editar visualmente.

Este repositorio es para desarrolladores. Contiene:

Ruta	Qué es
templates/	23 plantillas de bots de producción en JSON — la misma fuente que impulsa la galería de plantillas y la herramienta get_flow_example de MCP
mcp/	Referencia del servidor MCP: endpoint, autenticación, las 16 herramientas y una instantánea del esquema de acciones de flujo utilizado por apply_actions

Crea un bot desde tu agente de IA (MCP)

FlowCastle expone un servidor MCP a través de Streamable HTTP:

POST https://api.flowcastle.ai/api/mcp
Authorization: Bearer <your-application-api-key>   # starts with app_

Obtén una clave: regístrate → crea una aplicación → página API → pestaña MCP.

Claude Code

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

codex mcp add flowcastle \
  --url https://api.flowcastle.ai/api/mcp \
  --bearer-token-env-var FLOWCASTLE_MCP_TOKEN

Cursor / cualquier cliente MCP (configuración JSON)

{
  "mcpServers": {
    "flowcastle": {
      "type": "http",
      "url": "https://api.flowcastle.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-application-api-key>"
      }
    }
  }
}

Luego simplemente pídele a tu agente cosas como:

"Mira mi espacio de trabajo de FlowCastle y agrega un flujo de calificación de clientes potenciales: saluda con /start, haz tres preguntas con botones, guarda las respuestas en variables de contacto y notifícame."

El agente lee tu espacio de trabajo con get_workspace_summary / get_flow_context, redacta un lote de acciones del constructor de flujos, lo verifica con validate_actions y lo aplica con apply_actions. Consulta mcp/README.md para la referencia completa de herramientas.

Plantillas

Cada archivo JSON en templates/ es un bot completo: metadatos (título, resumen, casos de uso, variables sugeridas, módulos requeridos) más un array schemaExample.actions — un lote ordenado de operaciones create_flow / create_block / create_link / create_variable en el formato exacto que acepta apply_actions.

Tres formas de usarlas:

1. Instalación con un clic desde la galería: flowcastle.ai/templates
2. A través de MCP — pídele a tu agente search_flow_examples / get_flow_example y aplica una (opcionalmente personalizada) a tu espacio de trabajo
3. Como referencia — estudia cómo los flujos reales conectan disparadores, condiciones, pasos de espera de respuesta, pagos y bloques de IA

Índice completo y descripción del formato: templates/README.md.

API REST pública

API REST con ámbito de aplicación para contactos, variables de contacto, eventos de objetivo, envíos de flujos y transmisiones:

• URL base: https://api.flowcastle.ai/api/public/v1
• Documentación interactiva (Swagger): https://api.flowcastle.ai/api/public/docs
• Especificación OpenAPI: https://api.flowcastle.ai/api/public/openapi.json

La autenticación utiliza la misma clave de aplicación app_… (Authorization: Bearer o X-API-Key).

Guías

Construcciones paso a paso en el blog de FlowCastle:

• Crea un Bot de Leads en Telegram en 10 Minutos
• Crea un Bot de Soporte con IA para Telegram
• Reemplacé Mis Aplicaciones Matutinas con un Solo Bot de Telegram

Enlaces

• Producto: https://flowcastle.ai
• Panel de control: https://dashboard.flowcastle.ai
• Galería de plantillas: https://flowcastle.ai/templates
• Documentación de API: https://api.flowcastle.ai/api/public/docs

Contribuciones

¿Encontraste un error en una plantilla o creaste un flujo que valga la pena compartir? Abre un issue o PR — las plantillas son JSON simple y validate_actions (a través de MCP) te dirá si un lote está bien formado.

Licencia

El contenido de este repositorio está licenciado bajo la Licencia MIT.