Genesis MCP

Idea-to-money workflow as an MCP server. Transform ideas into deployed, monetizable products with a single command.

Quick Start

# Install globally
npm install -g genesis-mcp

# Initialize in your project
genesis init

# Transform an idea into a product
genesis idea "CLI tool that shows git status with AI summaries"

What It Does

Genesis runs a 5-phase workflow that takes an idea from concept to deployed product:

1. Research - Validates idea viability, analyzes competition, recommends tech stack
2. Architecture - Designs solution with Steve Jobs validation (simplicity check)
3. Implementation - Builds via parallel Codex CLI waves
4. Validation - 5-agent council approval (Core Goal, Steve, Karen, Security, UX)
5. Deployment - Deploys to platform + sets up monetization

MCP Integration

Genesis is an MCP server. Add it to your Claude Desktop or Cursor config:

{
  "mcpServers": {
    "genesis": {
      "command": "npx",
      "args": ["-y", "genesis-mcp"],
      "env": {}
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | genesis_init | Initialize .genesis/ in project | | genesis_idea | Full idea-to-money workflow | | genesis_research | Research phase only | | genesis_architect | Architecture + Steve validation | | genesis_implement | Implementation via providers | | genesis_validate | 5-agent council validation | | genesis_deploy | Deploy + monetization setup | | genesis_status | Check workflow status | | genesis_resume | Resume interrupted workflow | | genesis_config | Manage configuration |

CLI Usage

# Initialize
genesis init

# Full workflow
genesis idea "Your idea here"

# Options
genesis idea "Your idea" --skip-research  # Fast mode
genesis idea "Your idea" --dry-run        # Plan only
genesis idea "Your idea" --skip-deploy    # No deployment

# Status
genesis status
genesis status --workflow workflow-123

# Resume interrupted workflow
genesis resume

# Configuration
genesis config                           # Show all
genesis config --get providers.research  # Get value
genesis config --set defaults.parallelTasks=3  # Set value

Folder Structure

After genesis init, your project will have:

.genesis/
├── config.json     # Provider settings, defaults
├── state.json      # Workflow state tracking
├── workflows/      # All workflow runs
│   └── {id}/
│       ├── idea.md
│       ├── research.md
│       ├── architecture.md
│       ├── tasks.json
│       ├── validation.md
│       └── deployment.md
├── docs/           # PRDs, specs
├── reports/        # Generated reports
└── CLAUDE.md       # Integration guide

Configuration

Edit .genesis/config.json or use genesis config:

{
  "version": "1.0.0",
  "providers": {
    "research": { "provider": "perplexity", "model": "sonar-pro" },
    "architect": { "provider": "claude", "model": "claude-3-5-sonnet" },
    "implement": { "provider": "codex-cli", "model": "gpt-4.1" },
    "validate": { "provider": "claude", "model": "claude-3-5-sonnet" }
  },
  "defaults": {
    "parallelTasks": 5,
    "maxWaves": 6,
    "validationThreshold": 0.8,
    "autoDeployEnabled": false
  }
}

Monetization Model

Genesis itself uses this pricing:

| Tier | Price | Features | |------|-------|----------| | Open Source | Free | Full MCP server, local execution | | Pro | $19/mo | Cloud execution, team workflows | | Enterprise | $99/mo | SSO, audit logs, custom providers |

Development

# Clone
git clone https://github.com/anombyte/genesis-mcp.git
cd genesis-mcp

# Install
npm install

# Dev mode
npm run dev

# Build
npm run build

# Test
npm test

Architecture

┌─────────────────────────────────────────────┐
│              Genesis MCP Server              │
├─────────────────────────────────────────────┤
│  10 Tools → 5 Phase Workflow                │
│                                             │
│  Providers:                                 │
│  ├── Claude (research, validation)          │
│  ├── Codex CLI (implementation)             │
│  ├── Perplexity (web research)              │
│  └── Ollama (cost-efficient)                │
│                                             │
│  Storage: .genesis/ folder                  │
│  ├── config.json (settings)                 │
│  ├── state.json (workflows)                 │
│  └── workflows/ (artifacts)                 │
└─────────────────────────────────────────────┘

Inspired By

• TaskMaster - Folder structure and MCP patterns
• 12-Factor Agents - Stateless, resumable workflows
• Steve Jobs - Simplicity validation ("Would we ship with pride?")

License

MIT © anombyte

Core Goal: "Idea → System MAKING MONEY in one command"