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

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"
  }
})

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"
  }
})

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)"
  }
})

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.

Tools Reference

On this page