FlowDot MCP Server

The FlowDot MCP Server (@flowdot.ai/mcp-server) provides 80+ tools for integrating FlowDot with AI clients like Claude Desktop, Cursor IDE, and any MCP-compatible application.

TL;DR - Quick Summary

FlowDot MCP Server brings FlowDot to your AI client:

  • Install: npx "@flowdot.ai/mcp-server"
  • Package: npmjs.com/package/@flowdot.ai/mcp-server
  • 80+ Tools: Workflows, apps, custom nodes, recipes, knowledge base, toolkits
  • Clients: Claude Desktop, Cursor IDE, Claude Code, any MCP client
  • Token: Create at Settings > MCP Tokens on flowdot.ai
  • Recipes: Design via MCP, execute via CLI (local execution only)

What is MCP?

The Model Context Protocol (MCP) is an open standard for connecting AI assistants to external tools and data sources. It allows AI clients like Claude Desktop to access capabilities beyond their built-in features.

FlowDot's MCP server implements the full MCP specification, providing tools that let AI assistants:

  • Create, edit, and execute workflows
  • Build and publish apps
  • Manage custom nodes and toolkits
  • Query knowledge bases with semantic search
  • Design recipes (multi-step agentic workflows)

Installation

Run the MCP server using npx (no global installation needed):

npx "@flowdot.ai/mcp-server"

Get Your Token

  1. Go to flowdot.ai and log in
  2. Navigate to Settings > MCP Tokens
  3. Click "Create New Token"
  4. Select the scopes you need (or use full access)
  5. Copy the token (starts with fd_mcp_)

Integration Points

The FlowDot MCP server works with any MCP-compatible AI client:

Claude Desktop

Anthropic's desktop app for Claude - full MCP support

Cursor IDE

AI-powered code editor with MCP tool integration

Claude Code

Anthropic's CLI tool for agentic coding tasks

Any MCP Client

JSON-RPC 2.0 protocol - build your own integration

80+ Tools Coverage

The MCP server provides comprehensive tools for all FlowDot features:

Workflows 12 tools

  • List, get, create, update, delete workflows
  • Execute workflows (sync and async)
  • Validate workflow graphs
  • Get workflow graph structure
  • Manage input presets

Apps 15 tools

  • List, get, create, update, delete apps
  • Publish and unpublish apps
  • Clone public apps
  • Manage app files (multi-file support)
  • Link workflows to apps
  • Edit app code (find/replace)

Custom Nodes 10 tools

  • List, get, create, update, delete custom nodes
  • Copy public nodes to your library
  • Vote, favorite, and comment
  • Get node template for script generation

Recipes 12 tools

  • List, get, create, update, delete recipes
  • Manage recipe steps (agent, loop, parallel, gate, branch, invoke)
  • Manage recipe stores (inputs/outputs)
  • Fork public recipes
  • Link recipes for CLI execution
  • Note: Recipes are designed via MCP but executed via CLI

Knowledge Base 10 tools

  • List and manage categories
  • Upload documents (text, URL, file)
  • Query knowledge base with semantic search
  • Manage team knowledge bases
  • Get storage usage

Toolkits 15 tools

  • List, get, create, update, delete toolkits
  • Manage toolkit tools (HTTP and workflow)
  • Install and configure toolkits
  • Invoke toolkit tools
  • Manage credentials

Executions 6 tools

  • Get execution status and results
  • View execution history
  • Retry failed executions
  • Cancel running executions
  • Stream execution output

Sharing & Social 8 tools

  • Get public workflow URLs
  • Create shared execution results
  • Vote on public content
  • Add comments
  • Manage favorites

MCP Token System

FlowDot uses granular scopes to control what each MCP token can access.

30+ Granular Scopes

When creating a token, you can select specific permissions:

  • workflows:read - List and view workflows
  • workflows:write - Create, update, delete workflows
  • workflows:execute - Execute workflows
  • apps:read / apps:write - App management
  • nodes:read / nodes:write - Custom node management
  • recipes:read / recipes:write - Recipe management
  • knowledge:read / knowledge:write - Knowledge base access
  • toolkits:read / toolkits:write / toolkits:execute - Toolkit operations
  • ...and more

Token Management

Manage tokens at Settings > MCP Tokens:

  • Create tokens with specific scopes
  • View active tokens
  • Revoke tokens at any time
  • See last used timestamp

Configuration Examples

Claude Desktop

Add to your Claude Desktop config (~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "flowdot": {
      "command": "npx",
      "args": ["@flowdot.ai/mcp-server"],
      "env": {
        "FLOWDOT_TOKEN": "fd_mcp_your_token_here"
      }
    }
  }
}

Cursor IDE

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "flowdot": {
      "command": "npx",
      "args": ["@flowdot.ai/mcp-server"],
      "env": {
        "FLOWDOT_TOKEN": "fd_mcp_your_token_here"
      }
    }
  }
}

Environment Variables

Alternatively, set the token as an environment variable:

# macOS/Linux
export FLOWDOT_TOKEN=fd_mcp_your_token_here

# Windows
set FLOWDOT_TOKEN=fd_mcp_your_token_here