storybloq

Overview

Storybloq is an MCP server that creates a persistent context layer for AI coding sessions. It maintains a structured .story/ directory containing tickets, issues, roadmap phases, and session handovers that are tracked by git and accessible to AI assistants. The server provides 43 tools for reading and mutating this context, enabling autonomous ticket processing through a defined workflow state machine. It integrates directly with Claude Code and Codex, allowing AI to maintain continuity across sessions.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• storybloq_status

  Get project summary with phase statuses, counts, and risks

  Try:Show me project statusTry:What's the current status of the project?
• storybloq_ticket_get

  Get full details of a specific ticket

  Try:Show details for ticket T-001Try:What's the status of ticket T-002?
• storybloq_ticket_create

  Create a new ticket in the project

  Try:Create a new ticket for implementing user authenticationTry:Add a ticket to fix the login bug
• storybloq_issue_create

  Create a new issue in the project

  Try:Report a critical issue with payment processingTry:Create an issue about the UI responsiveness problem
• storybloq_handover_create

  Create a session handover documenting work completed and next steps

  Try:Write a handover for today's workTry:Document what was done on the user auth feature
• storybloq_autonomous_guide

  Drive a ticket through the autonomous workflow (plan -> implement -> test -> review)

  Try:Work autonomously on ticket T-005Try:Complete ticket T-010 using autonomous mode
• storybloq_recommend

  Get context-aware work suggestions for what to do next

  Try:What should I work on next?Try:Recommend some tasks to work on
• storybloq_phase_current

  Get the current active phase in the project roadmap

  Try:What's the current phase?Try:Show me which phase we're working on
• storybloq_issue_get

  Get full details of a specific issue

  Try:Show details for issue ISS-003Try:What's the status of the reported login issue?
• storybloq_ticket_next

  Get the highest-priority unblocked ticket

  Try:What's the next ticket to work on?Try:Show me the highest priority unblocked ticket
• storybloq_snapshot

  Create a snapshot of current project state

  Try:Take a snapshot of current progressTry:Capture the current state of the project
• storybloq_validate

  Validate project integrity and check for schema issues

  Try:Check if the project is validTry:Validate all ticket and issue data

Comparable tools

Installation

npm install -g @storybloq/storybloq@latest
storybloq setup --client all

{
  "mcpServers": {
    "storybloq": {
      "command": "storybloq",
      "args": ["--mcp"]
    }
  }
}

FAQ

What file format does Storybloq use?

Storybloq uses a .story/ directory with JSON and markdown files to track project state.

How does Storybloq integrate with AI coding assistants?

It provides both CLI tools and an MCP server that exposes 43 tools to Claude Code and Codex for reading and mutating project context.

Compare storybloq with