flowspec-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
flowspec-mcp
MCP (Model Context Protocol) server for FlowSpec — exposes project specifications to Claude Code and other MCP-compatible AI tools.
Quick Start
Add to your ~/.claude.json:
{
"mcpServers": {
"flowspec": {
"command": "npx",
"args": ["-y", "flowspec-mcp"],
"env": {
"FLOWSPEC_MODE": "cloud",
"DATABASE_URL": "your-neon-connection-string",
"FLOWSPEC_USER_ID": "your-clerk-user-id"
}
}
}
}Local Mode (with FlowSpec Desktop)
{
"mcpServers": {
"flowspec": {
"command": "npx",
"args": ["-y", "flowspec-mcp"],
"env": {
"FLOWSPEC_MODE": "local"
}
}
}
}Local mode connects to the FlowSpec desktop server at http://localhost:3456.
Related MCP server: claude-sessions-mcp
Environment Variables
Variable | Required | Default | Description |
| No |
|
|
| Cloud mode | — | Neon Postgres connection string |
| Cloud mode | — | Clerk user ID — find yours at flowspec.app/account |
| No |
| Desktop server URL (local mode) |
Available Tools (v5.6.0 — 32 tools)
Set FLOWSPEC_TOOLS=core for 11 essential tools only. Default (all) loads all 32.
Read Tools
flowspec_list_projects— List all projects with names and datesflowspec_get_json— Get full JSON spec for a project (optimised for Claude Code)flowspec_get_project— Get raw canvas_state JSONflowspec_search_nodes— Search nodes by label across all projectsflowspec_get_screen_context— Get screen/region/element structure
Write Tools
flowspec_create_project— Create a new projectflowspec_update_project— Update project name or canvas stateflowspec_delete_project— Delete a projectflowspec_clone_project— Clone a project for backup or branchingflowspec_create_node— Add a node (datapoint, component, transform, table, actor)flowspec_update_node— Update node data or positionflowspec_delete_node— Remove a node and connected edgesflowspec_create_edge— Connect two nodes with an edge typeflowspec_update_edge— Update edge type, label, or handle positionsflowspec_delete_edge— Remove an edgeflowspec_analyse_project— Run orphan node and duplicate label analysisflowspec_validate_project— Validate data flow semantics and type matching
Bulk / Import Tools
flowspec_import_json— Import a JSON spec (create/merge nodes, edges, screens)flowspec_auto_layout— Auto-arrange nodes using dagre hierarchical layout
Screen & Region Tools
flowspec_upload_image— Upload a wireframe image and get its URLflowspec_create_screen— Add a wireframe screen to a projectflowspec_update_screen— Update screen name or image propertiesflowspec_delete_screen— Delete a screen and its regionsflowspec_add_region— Add an annotated region to a screenflowspec_update_region— Update region position, size, or linked elementsflowspec_remove_region— Remove a region from a screen
Decision Tree Tools
flowspec_list_decision_trees— List decision trees for a projectflowspec_get_decision_tree— Get a decision tree with full node/edge structureflowspec_delete_decision_tree— Delete a decision treeflowspec_analyse_decision_tree— Analyse tree depth, outcomes, and issues
Boring Logic Board Tools
flowspec_get_logic_board— Get the logic board (input/output/process/decision canvas)flowspec_upsert_logic_board— Save the logic board state for a project
Development
npm install
npm run build
node dist/index.jsNotes
MCP SDK pinned to
1.12.1due to zod v4 compatibility constraints in later versionsNode.js >= 18.0.0 required
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for generating rough-draft project plans from natural-language prompts.
MCP server for secureFlows: token-free URL builders and integration-linting tools for AI agents.
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA MCP server that exposes OpenAPI schema information to LLMs like Claude. This server allows an LLM to explore and understand large OpenAPI schemas through a set of specialized tools, without needing to load the whole schema into the context50MIT
- AlicenseBqualityDmaintenanceMCP server for managing Claude Code conversation sessions12MIT
- AlicenseCqualityBmaintenanceAn MCP server implementing Spec-Driven Development workflows for AI-agent CLIs and IDEs like Claude Code and Cursor, enabling spec-first development with automated workflow guidance and quality checks.1783 npm54MIT

Network Sketcherofficial
AlicenseAqualityBmaintenanceLocal-first MCP server that lets AI agents design Cisco-style networks and generate L1/L2/L3 topology diagrams, device tables, and AI-ready context files.612419Apache 2.0