# Clone and install
git clone https://github.com/your-org/prompt-auto-optimizer-mcp.git
cd prompt-auto-optimizer-mcp
npm install
npm run build

# Start the MCP server
npm run mcp:start

{
  "mcp": {
    "servers": {
      "prompt-optimizer": {
        "command": "npx",
        "args": ["prompt-auto-optimizer-mcp"],
        "cwd": "./path/to/prompt-auto-optimizer-mcp"
      }
    }
  }
}

{
  taskDescription: string;           // What you want to optimize for
  seedPrompt?: string;              // Starting prompt (optional)
  config?: {
    populationSize?: number;        // How many variants to test (default: 20)
    generations?: number;           // How many iterations (default: 10)
    mutationRate?: number;         // How much to change prompts (default: 0.15)
  };
}

{
  promptId: string;                 // Which prompt to test
  taskIds: string[];               // What tasks to test it on
  rolloutCount?: number;           // How many times to test (default: 5)
}

{
  trajectoryIds: string[];         // Which test runs to analyze
  targetPromptId: string;          // Which prompt needs improvement
  analysisDepth?: 'shallow' | 'deep'; // How detailed (default: 'deep')
}

{
  minPerformance?: number;         // Minimum quality threshold
  limit?: number;                  // Max results to return (default: 10)
}

{
  taskContext?: string;            // Describe your use case
  performanceWeight?: number;      // How much to prioritize accuracy (default: 0.7)
  diversityWeight?: number;        // How much to prioritize creativity (default: 0.3)
}

{
  promptId: string;                // Which prompt was used
  taskId: string;                  // What task was performed
  executionSteps: ExecutionStep[]; // What happened during execution
  result: {
    success: boolean;              // Did it work?
    score: number;                 // How well did it work?
  };
}

# Optional performance tuning
GEPA_MAX_CONCURRENT_PROCESSES=3           # Parallel execution limit
GEPA_DEFAULT_POPULATION_SIZE=20            # Default prompt variants
GEPA_DEFAULT_GENERATIONS=10               # Default iterations