Tools Reference

Tools Reference

Workflow MCP exposes five tools through the Model Context Protocol.

start_session

Start a new workflow session or resume an existing one.

Parameters

Parameter	Type	Required	Description
command	string	Yes	Workflow command: /research, /plan, /implement, /review, /debug, /refactor, /archive
topic	string	Yes	Topic/project name for the session
context	string	No	Extra context (focus areas, constraints)
dps	number	No	Dynamic Problem Solving level (0-5). Defaults to command’s default.
mode	string	No	"auto" (default), "resume", or "new"

Example

mcp__workflow__start_session({
  command: "/research",
  topic: "AUTH-SYSTEM",
  context: "Focus on OAuth 2.0 implementation patterns",
  dps: 3
})

Response

Started: /research AUTH-SYSTEM
  Log: ./projects/research/RESEARCH_AUTH-SYSTEM_2026-01-12.md
  DPS: 3 (Moderate - can propose alternatives)

Tip

If an incomplete session exists for the topic, you’ll be prompted to resume or start new.

---

log_entry

Log a structured entry to the current session with automatic Entry-ID generation.

Parameters

Parameter	Type	Required	Description
tag	string	Yes	Entry type (see Entry Types below)
fields	object	Yes	Entry-specific fields

Entry Types

finding

mcp__workflow__log_entry({
  tag: "finding",
  fields: {
    title: "Authentication Flow Analysis",
    type: "Technical",
    content: "The auth system uses JWT with refresh tokens...",
    evidence: "src/auth/jwt.ts:15-42"
  }
})

decision

mcp__workflow__log_entry({
  tag: "decision",
  fields: {
    context: "Need to choose auth token storage",
    decision: "Use HttpOnly cookies over localStorage",
    rationale: "Better XSS protection, automatic CSRF handling",
    alternatives: "- localStorage: simpler but vulnerable\n- sessionStorage: doesn't persist",
    impact: "Requires cookie parser middleware"
  }
})

task-complete

mcp__workflow__log_entry({
  tag: "task-complete",
  fields: {
    task: "2.1",
    status: "completed",
    changes: "- src/auth/middleware.ts:12-45\n- src/routes/login.ts:8-30",
    tests: "- test/auth.test.ts (3 new tests)",
    verification: "All auth tests passing",
    issues: "None",
    deviations: "Added rate limiting (not in original plan)"
  }
})

blocker

mcp__workflow__log_entry({
  tag: "blocker",
  fields: {
    type: "technical",
    title: "Database schema conflict",
    impact: "Cannot add user_sessions table without migration",
    dpsOptions: "- Run migration manually\n- Add fallback for existing users",
    researchTopics: "- Database migration patterns\n- Zero-downtime schema changes"
  }
})

All Entry Types

Tag	Use Case	Key Fields
finding	Research discoveries	title, type, content, evidence
requirement	User requirements	verbatim, type, negotiable
decision	Planning decisions	context, decision, rationale, impact
task-complete	Completed tasks	task, changes, tests, verification
user-feedback	User input during work	verbatim, taskContext, action
issue	Problems encountered	task, problem, impact, options
blocker	Blocking issues	type, title, impact, dpsOptions
gap	Review findings	ref, type, finding, recommendation
fix	Applied fixes	addresses, approach, changes
fault	Debug fault reports	verbatim, symptom, context
investigation	Debug investigations	hypothesis, method, findings

---

get_status

Get the current session status.

Parameters

None.

Response

Active: /implement AUTH-SYSTEM
  Status: In Progress
  Entries: 12
  Log: ./projects/implementations/IMPL_AUTH-SYSTEM_2026-01-12.md

---

end_session

End the current session and generate a handoff message.

Parameters

Parameter	Type	Required	Description
status	string	No	"Completed" (default) or "Paused"
tasksCompleted	number	No	Number of completed tasks
tasksTotal	number	No	Total number of tasks
tasksBlocked	number	No	Number of blocked tasks
filesChanged	string[]	No	List of changed files
testsCreated	number	No	Number of tests created
testPassRate	string	No	Test pass rate (e.g., “15/15”)
keyFindings	string[]	No	Key findings to highlight (for research)
keyImplementations	string[]	No	Key implementations (for implement)
gapsFound	number	No	Number of gaps found (for review)
criticalGaps	number	No	Number of critical gaps (for review)
summary	object	No	Additional summary data to include

Example

mcp__workflow__end_session({
  status: "Completed",
  tasksCompleted: 5,
  tasksTotal: 5,
  filesChanged: ["src/auth/index.ts", "src/routes/login.ts"],
  testsCreated: 8,
  testPassRate: "8/8",
  keyImplementations: ["JWT middleware", "Login route", "Refresh token flow"]
})

---

generate_handoff

Generate a handoff message without ending the session.

Note

Prefer using end_session with handoff options - it generates handoff automatically.

Parameters

Same as the handoff-related parameters of end_session.