Getting Started

Presets

Ready-to-use presets

Workflows MCP comes with several ready-to-use presets to help you get started quickly. These presets are organized by category and provide powerful functionality out of the box.

Using Presets

To enable presets, use the --preset flag when starting the MCP server:

npx mcpn@latest server --preset thinking,coding,github

Or in your Cursor configuration:

{
  "mcpServers": {
    "workflows-mcp": {
      "command": "npx",
      "args": ["mcpn@latest server", "--preset", "thinking,coding,github"]
    }
  }
}

Available Presets

Thinking Presets

Tools designed to improve reasoning on any task.

PresetDescription
generate_thoughtReflect on a thought and produce a reflection/new set of thoughts. Takes a required thought parameter.
deep_thinking_modeComprehensive multi-perspective analysis with detailed reflections on ideas, problems, or questions.

Coding Presets

Universally applicable tools for common coding tasks.

PresetDescription
debugger_modeSystematic multi-step debugging with hypothesis creation, telemetry gathering, and testing.
architecture_modeSystem design prompt with tradeoff analysis and implementation planning.
planner_modeSystematic code change planning with codebase analysis.
prd_modeStructured product requirements documentation for features, user stories, and spike analysis.
save_noteDocument ongoing work with comprehensive progress tracking.

GitHub Presets

Tools to simplify common GitHub tasks.

PresetDescription
pr_review_modeComprehensive pull request analysis with security considerations.
pr_creation_modeStructured PR creation process using GitHub CLI.
create_branchSmart branch creation with contextual naming.
save_changesSystematic git commit and push workflow.

Preset Examples

Thinking Mode Example

The thinking mode preset helps you reflect on ideas:

generate_thought:
  description: "Reflect on a thought and produce a reflection/new set of thoughts"
  parameters:
    thought:
      type: "string"
      description: "A thought to deeply reflect upon"
      required: true
  prompt: |
    Deeply reflect upon the provided thought step-by-step.
    Reflect upon the implications/tradeoffs it may have as it relates to my current goals, challenges and our conversation.
    Do not change anything in our system, just return some thoughts/considerations/analysis based on your reflection of the provided thought.

    Here is the thought to reflect on:
    {{ thought }}

Debugger Mode Example

The debugger mode preset provides a structured approach to solving problems:

debugger_mode:
  description: "Systematically debug issues with a structured problem-solving approach"
  prompt: |
    You are now entering "Debugger Mode" - a structured problem-solving approach to debug issues.

    1. Understand the problem
       - What's the expected behavior?
       - What's the actual behavior?
       - When did the issue start occurring?
       
    2. Gather information
       - Examine error messages and logs
       - Search for and review related code
       - Check console and network logs
       
    3. Isolate the issue
       - Identify the component or module where the problem occurs
       - Determine if it's a frontend, backend, database or integration issue
       - Review recent changes that might have caused the problem

    4. Test hypotheses
       - Propose 5-7 possible causes
       - Identify 1-2 most likely causes
       - Implement targeted logs to verify each hypothesis
       
    5. Fix and verify
       - Suggest fixes based on analysis
       - Implement approved fixes systematically
       - Check for side effects and regressions

Creating Custom Presets

You can create your own presets by adding YAML files to a .workflows or .mcp-workflows directory in your project. These files can override or extend the built-in presets.

Basic Custom Preset

custom_workflow:
  description: "Description of what this workflow does"
  prompt: |
    Enter your multi-line
    prompt here
  tools: "tool1, tool2, tool3"

Preset with Parameter Injection

custom_mode:
  description: "Workflow with parameter injection"
  parameters:
    thought:
      type: "string"
      description: "A thought to deeply reflect upon"
      required: true
  prompt: |
    Deeply reflect upon the provided thought.
    Here's the thought: {{ thought }}
    
    Reflect upon the implications/tradeoffs it may have.

Sequential Tool Execution

sequential_workflow:
  description: "Execute tools in a specific order"
  toolMode: sequential
  tools: tool1, tool2, tool3