How do I use DevFlow MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@DevFlow MCP Server Create a new feature flow for user authentication" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

DevFlow MCP Server

by KlausFreiberufler

Overview Schema Related Servers Score Discussions

TypeScript

Remote

DevFlow MCP Server

License: MIT

MCP server for integrating DevFlow with AI code assistants. Enables structured development workflows with enforced planning, task tracking, and code review gates.

What is DevFlow?

DevFlow brings structure to AI-assisted development. Instead of letting AI agents write code without oversight, DevFlow enforces a workflow:

idea -> planning -> approval -> ready -> in_progress -> review -> done

Every feature or bugfix goes through planning, gets approved, is tracked with tasks, and must pass review before completion. The MCP server connects your AI coding assistant to DevFlow, making this workflow seamless.

Installation

As a Claude Code Plugin (recommended)

DevFlow is listed in the official Claude Code community marketplace. Install in one line:

/plugin marketplace add anthropics/claude-plugins-community
/plugin install devflow

This installs everything in one shot: MCP server (auto-registered via mcpServers in the plugin manifest), enforcement hooks, state-specific skills, and slash commands (/devflow-start, /devflow-status, /devflow-next, /devflow-tasks, /devflow-create, /devflow-list, /devflow-review). No separate MCP setup step needed.

Since 4.23.0: the MCP server no longer modifies your CLAUDE.md. The plugin's skills, hooks, and MCP tool responses cover the rules that the old  block used to inject. If you have an existing block from a pre-4.23 install and want it cleaned up, run npx @dev-flow-tech/mcp-server uninstall --client claude once.

Since 4.26.0 (DF-339): Two new auto-review skills fire when transitioning state. devflow-plan-critic reminds at planning → approval to deep-review the plan against 7 dimensions. devflow-code-critic does the same at in_progress → review for the implementation. Both support iterative loop (max 3), trivial-flow-skip, and auto-approve-gate based on project_configs.allow_agent_self_approval.

Since 4.30.0 (DF-374/DF-377): The DevFlow backend is the primary gate for state-transitions (unified flowGate service with conditions like plan-required, tasks-required, agent-summary, testing-instructions, knowledge-gaps-resolved, pr-state-consistent, adr-compliance-clean). The plugin's strictness checks are now informational warnings — the backend's 409 gate.failures[] response is the source of truth. This makes Multi-Client setups (Claude Code, Codex, Cursor, Gemini) consistent — the gate behavior is the same regardless of which client connects.

Updates: /plugin update devflow.

Manual Setup (fallback)

If you'd rather skip the plugin and wire the MCP server directly:

Claude Code

npx github:KlausFreiberufler/devflow-mcp setup

Cursor

npx github:KlausFreiberufler/devflow-mcp setup --client cursor

Gemini CLI

npx github:KlausFreiberufler/devflow-mcp setup --client gemini

Windsurf

npx github:KlausFreiberufler/devflow-mcp setup --client windsurf

Restart your AI client after setup.

Server-Split (since DF-334)

For clients with per-server tool-caps (e.g. Cursor 40-tool/server cap), DevFlow ships three entry-points:

Bin	Domain	Tool-Count
`devflow-mcp`	combined (default, BC)	~65
`devflow-mcp-flows`	workflow (flow_, task_, agent_session_, devflow_, release_*)	≤40
`devflow-mcp-wiki`	knowledge (adr_, wiki_, doc_page_, knowledge_, planning_context)	≤40

Cursor (or any cap'd client) registers BOTH split-bins to get full tool-coverage:

{
  "mcpServers": {
    "devflow-flows": { "command": "npx", "args": ["-y", "@dev-flow-tech/mcp-server", "devflow-mcp-flows"] },
    "devflow-wiki":  { "command": "npx", "args": ["-y", "@dev-flow-tech/mcp-server", "devflow-mcp-wiki"]  }
  }
}

Claude Code uses the combined devflow-mcp bin (no cap, simpler config).

Getting Started

Run devflow_status() to check the connection
The browser opens for authentication on first use
Link your project — a .devflow.json file is created in your project directory
Start working: flow_list() to see available flows, or flow_create() to create one
Initialize your session: devflow_init({ flowId: "..." })

Compatible Clients

Client	MCP Support	Status
Claude Code	Native	Fully supported
Cursor	MCP	Supported
Gemini CLI	MCP	Supported
Windsurf	MCP	Supported

Flow States

State	Description
`idea`	New idea, no plan yet
`planning`	Agent creates implementation plan
`approval`	User approves the plan (wait state)
`ready`	Plan approved, ready for implementation
`in_progress`	Implementation in progress
`review`	User reviews the implementation (wait state)
`done`	Completed

Required Fields for State Transitions

Transition	Required Fields
-> `approval`	`implementationPlan`
-> `review`	`agentSummary`, `testingInstructions`

Available MCP Tools

Session & Flows

Tool	Description
`devflow_init`	Required before all other tools. Starts a flow session
`devflow_status`	Show connection status, link/unlink projects
`flow_list`	List flows (filtered by project)
`flow_get`	Get flow details including plan and audit trail
`flow_create`	Create a new flow
`flow_update`	Update state, plan, agent messages
`flow_get_feedback`	Get user feedback on plan or code

Tasks

Tool	Description
`task_list`	List tasks of a flow
`task_create`	Create a new task
`task_update`	Update task or mark as completed

Agent Sessions

Tool	Description
`agent_session_create`	Create agent session (tracking)
`agent_session_log`	Log progress to a session
`agent_session_complete`	Complete an agent session
`agent_session_list`	List sessions of a flow

Documentation & Search

Tool	Description
`doc_page_list`	List documentation pages
`doc_page_get`	Get a documentation page
`doc_page_create`	Create a documentation page
`doc_page_update`	Update a documentation page
`project_guidelines_get`	Get project guidelines
`search`	Search flows, tasks, and projects

Releases

Tool	Description
`release_list`	List releases
`release_get`	Get release details
`release_create`	Create a new release
`release_update`	Update release status/details

Knowledge — Wiki & ADRs (v4.5.0)

Tool	Description
`wiki_search`	Full-text search over flows, doc-pages, reviews, releases
`wiki_get_page`	Resolve a slug / title / display-id to a concrete asset + backlinks
`wiki_list_by_type`	List assets of a specific document-type (adr, pattern, runbook, …)
`wiki_backlinks`	Reverse lookup: all assets that link to X
`wiki_graph_neighbors`	Graph (nodes + edges) of the project or a subset
`wiki_get_flow_context`	A flow's outgoing + incoming wiki links
`wiki_get_project_context`	Project knowledge graph summary
`adr_list`	List ADRs (optional status filter)
`adr_get`	ADR detail with supersedes chain
`adr_accept`	Accept an ADR from a flow-attachment
`adr_update_status`	Move ADR through proposed → accepted → deprecated / superseded

Knowledge Drafts (v4.6.0)

Tool	Description
`knowledge_backfill_request`	Get done-flows + existing ADRs + instructions — you classify and call `knowledge_draft_create` for each draft
`knowledge_draft_create`	Create a draft (dedup-aware: same (project, type, title) merges `sourceFlowIds`)
`knowledge_draft_list`	List drafts (optional status filter)
`knowledge_draft_accept`	Accept a draft (creates the ADR / doc-page)
`knowledge_draft_reject`	Reject a draft with optional reviewer note

Knowledge Harvest / Check (v4.7.0)

Tool	Description
`knowledge_harvest`	Per-flow harvest — returns a single done-flow + context + instructions for draft proposal
`knowledge_check_flow`	Flow analysis — drift (against existing ADRs) + missing-knowledge suggestions

Code Drift (v4.9.0)

Tool	Description
`knowledge_check_drift`	Returns ADR content + its `affects_paths` + instructions. You use your own Glob/Read/Grep to compare claims vs code and report drift

MCP Resources (v4.8.0)

URI-addressable project assets for reading via ReadResource.

URI	Description
`devflow://project/{id}/adr/{number}`	ADR content as markdown
`devflow://project/{id}/flow/{displayId}`	Flow with plan + agent summary
`devflow://project/{id}/graph`	Project knowledge-graph summary
`devflow://project/{id}/search?q=...`	FTS search formatted as markdown

MCP Prompts (v4.8.0)

Guided one-shot workflows — each auto-assembles relevant project context.

Prompt	Args	Purpose
`ask_project`	`query`	Answer a free-form question; loads ADRs + recent done-flows as context
`plan_with_project_knowledge`	`flowId`	Pre-build a planning prompt with relevant ADRs + related flows
`review_with_drift_check`	`flowId`	Auto-run knowledge-check-prepare and produce a review prompt

Pipeline Integration

Projects with pipeline configuration get extended features:

Pipeline Model

Each pipeline step has four dimensions:

Field	Description	Values
`actor`	Who works on this step?	`human`, `agent`, `both`, `auto`, `skip`
`transitionPolicy`	Who can complete the step?	`human_only`, `agent_only`, `human_or_agent`, `auto`
`kind`	Semantic step type	`work`, `review`, `handoff`, `terminal`
`skippable`	Can the step be skipped?	`true`, `false`

Gate Handling

Gates are controlled via transitionPolicy:

human_only — Agent is blocked (403), human must act in the UI
agent_only — Only agents can proceed
human_or_agent — Both can complete the step
auto — System transition, no actor needed

Configuration

Environment Variables

Variable	Description	Default
`DEVFLOW_URL`	Backend URL	`https://api.app.dev-flow.tech`
`DEVFLOW_TOKEN`	Auth token (skips browser auth)	-
`DEVFLOW_PROJECT_ID`	Project scoping	from `.devflow.json`

Manual Configuration

Add to your client's MCP configuration:

{
  "mcpServers": {
    "devflow": {
      "command": "node",
      "args": ["/path/to/devflow-mcp/dist/index.js"],
      "env": {
        "DEVFLOW_URL": "https://api.app.dev-flow.tech"
      }
    }
  }
}

Development

See CONTRIBUTING.md for setup and development workflow.

License

MIT - DevFlow (dev-flow.tech)

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

2dRelease cycle

37Releases (12mo)

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/KlausFreiberufler/devflow-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server