StoryCrafter MCP Server

Available Endpoints

• /api/mcp - Main MCP endpoint (GET for health, POST for tools)

Available Tools (4 total)

Two-phase workflow: Fast epics first, then detailed stories. Iterative refinement supported.

Phase 1: Epic Generation ⚡

• generate_epics - ⚡ FAST (15-20 seconds) epic generation
  • Generates 5-8 high-level epics from VISHKAR project context
  • Uses Claude Sonnet 4.5 for fast, intelligent epic structure
  • Returns titles, descriptions, priorities, categories, acceptance criteria
  • ~$0.15 per generation, 15-20 seconds
  • Use this FIRST to get quick epic overview before detailed stories
• regenerate_epic - 🔄 Iterative epic refinement (20-30 seconds)
  • Regenerate single epic based on user feedback
  • Uses Claude Sonnet 4.5 with feedback incorporation
  • Returns updated epic with same structure
  • Use when user wants to improve specific epic

Phase 2: Story Generation 🔄

• generate_stories - 🔄 DETAILED (3-5 minutes) story generation
  • Generates comprehensive user stories for epics
  • Uses GPT-5 (128K output) for detailed story expansion
  • Includes Given/When/Then acceptance criteria, technical tasks, story points (Fibonacci), estimated hours
  • ~$0.29 per generation, 3-5 minutes
  • Call AFTER generate_epics to create full backlog
• regenerate_story - 🔄 Iterative story refinement (1-2 minutes)
  • Regenerate single story based on user feedback
  • Uses GPT-5 with feedback incorporation
  • Returns updated story with better criteria and tasks
  • Use when user wants to improve specific story

Usage

Health Check

GET /api/mcp

Response:
{
  "name": "StoryCrafter MCP",
  "version": "1.0.0",
  "tools": ["generate_epics", "generate_stories", "regenerate_epic", "regenerate_story"],
  "service_url": "https://storycrafter-service.vercel.app",
  "status": "healthy"
}

Example: Generate Epics

POST /api/mcp
Content-Type: application/json

{
  "method": "tools/call",
  "params": {
    "tool": "generate_epics",
    "arguments": {
      "project_context": {
        "project_summary": {
          "name": "TaskMaster",
          "description": "Task Management App with offline support",
          "target_users": "Remote teams needing offline task management"
        },
        "final_decisions": {
          "technical_stack": "React Native, IndexedDB, Service Workers",
          "timeline": "4 weeks",
          "team_size": "2 developers",
          "priorities": ["Offline support", "Task CRUD", "Sync"]
        }
      }
    }
  }
}

Example: Generate Stories

POST /api/mcp
Content-Type: application/json

{
  "method": "tools/call",
  "params": {
    "tool": "generate_stories",
    "arguments": {
      "project_context": { /* same as above */ },
      "epics": [
        {
          "id": "EPIC-1",
          "title": "User Authentication & Profile",
          "description": "Secure user authentication system",
          "priority": "high",
          "category": "security"
        }
        /* ... more epics from generate_epics output */
      ]
    }
  }
}

Example Response

{
  "content": [
    {
      "type": "text",
      "text": {
        "success": true,
        "backlog": {
          "project": {
            "name": "TaskMaster",
            "description": "Task Management App with offline support"
          },
          "epics": [
            {
              "id": "EPIC-1",
              "title": "User Authentication & Profile Management",
              "description": "Core user authentication with secure profile management",
              "stories": [
                {
                  "id": "STORY-1",
                  "title": "User Registration with Email Verification",
                  "description": "As a new user, I want to register...",
                  "acceptance_criteria": [...],
                  "technical_tasks": [...],
                  "story_points": 5,
                  "estimated_hours": 12
                }
              ]
            }
          ]
        },
        "summary": {
          "total_epics": 8,
          "total_stories": 36,
          "total_estimated_hours": 458,
          "generated_at": "2025-10-25T15:30:00Z"
        }
      }
    }
  ]
}

VISHKAR Integration

StoryCrafter works with VISHKAR project context (project_summary + final_decisions):

Architecture

┌──────────────────┐
│  Vishkar Agent   │
│  (User Request)  │
└────────┬─────────┘
         │ MCP Protocol
┌────────▼─────────────┐
│ StoryCrafter MCP     │ (Next.js - This Service)
│ /api/mcp             │
└────────┬─────────────┘
         │ HTTP
┌────────▼─────────────┐
│ StoryCrafter Service │ (Python/FastAPI)
│ - Claude Sonnet 4.5  │ (Epic Structure)
│ - GPT-5              │ (Story Details)
└──────────────────────┘

Costs & Performance