FlowCastle — Claude Code MCP server: setup and features
FlowCastle lets an AI agent build and edit Telegram bot flows in a visual workspace. Connect the MCP server to turn a written request into flow changes.
claude mcp add --transport http flowcastle https://api.flowcastle.ai/api/mcpWhat FlowCastle does
The agent can inspect a FlowCastle workspace, prepare editor actions, validate them, and apply them. For instance, a request can add a /start greeting, button questions, contact variables, or a notification. You can also view and edit the resulting blocks in FlowCastle’s visual builder.
The repository includes bot templates in JSON. An agent can search for an example, retrieve it, and apply it to a workspace; the files also show how flow steps are arranged. The MCP server uses HTTP. You need a FlowCastle application key beginning with app_ for authorization, so the workspace cannot be connected without that credential.
In Claude Code, add the server with claude mcp add --transport http flowcastle https://api.flowcastle.ai/api/mcp. Codex uses a separate command. FlowCastle is also listed for Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, and Gemini CLI.
What it helps with
- create a Telegram bot flow from a written brief
- store answers to button questions in contact variables
- validate flow actions before applying them
- find a bot template and adapt it to a workspace
Example prompts for the agent
- Add a
/startgreeting and button questions to my FlowCastle workspace; save the replies in contact variables. - Find a Telegram support bot template and apply it to my workspace.
- Validate the actions for this flow, then apply them if they pass.
How to install FlowCastle
Platform CLI: remote server
claude mcp add --transport http flowcastle https://api.flowcastle.ai/api/mcpPlatform CLI: remote server
codex mcp add flowcastle --url https://api.flowcastle.ai/api/mcpConfig file
{
"mcpServers": {
"flowcastle": {
"url": "https://api.flowcastle.ai/api/mcp"
}
}
}Config file
{
"servers": {
"flowcastle": {
"type": "http",
"url": "https://api.flowcastle.ai/api/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http flowcastle https://api.flowcastle.ai/api/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about FlowCastle
How do I install FlowCastle in Claude Code?
Add the MCP server with claude mcp add --transport http flowcastle https://api.flowcastle.ai/api/mcp. You’ll also need a FlowCastle application key that starts with app_.
What does FlowCastle do?
It lets an AI agent inspect a FlowCastle workspace, prepare and validate flow changes, then apply them. The agent can also search for bot template examples.
Does FlowCastle require an API key?
Yes. Authorization uses a FlowCastle application key beginning with app_.
