Provides comprehensive tools for interacting with the Storyblok CMS, including story management (CRUD, publishing, versioning), asset management (uploads, folder organization), component schema management, tag management, release workflows, content search, and space-level operations.
Implements type safety throughout the server with comprehensive TypeScript type definitions for all interfaces, ensuring type-safe interactions with the Storyblok API.
MCP Storyblok Server
A comprehensive Model Context Protocol (MCP) server for Storyblok CMS integration. This server provides tools for managing stories, assets, components, releases, and more through a well-organized, modular architecture.
Features
- Story Management: CRUD operations, publishing, versioning, and lifecycle management
- Asset Management: Upload workflows, organization, and folder management
- Component Management: Block/component schema management and updates
- Tag Management: Organization and categorization of content
- Release Management: Scheduled publishing workflows
- Content Search: Advanced filtering and content discovery
- Space Management: Space-level operations and metadata
Architecture
The server follows a modular architecture with clear separation of concerns:
Environment Variables
The following environment variables are required:
Installation & Setup
- Install dependencies:
- Build the project:
- Configure environment variables in your MCP client configuration.
Development
Building
Type Checking
Tool Categories
Basic Tools
ping
: Server health check
Content Management
fetch-stories
: List stories with filteringget-story
: Get specific story by ID/slugcreate-story
: Create new storiesupdate-story
: Update existing storiesdelete-story
: Delete storiespublish-story
/unpublish-story
: Publishing controlsget-story-versions
/restore-story
: Version management
Tag Management
fetch-tags
: List all tagscreate-tag
: Create new tagscreate-tag-and-add-to-story
: Create and assign tagsdelete-tag
: Remove tags
Release Management
fetch-releases
: List releasescreate-release
: Create scheduled releasesadd-story-to-release
: Add content to releasespublish-release
: Publish releasesdelete-release
: Remove releases
Asset Management
fetch-assets
: List assets with filteringget-asset
: Get specific asset detailsdelete-asset
: Remove assetsinit-asset-upload
/complete-asset-upload
: Upload workflowfetch-asset-folders
: List asset folderscreate-asset-folder
/update-asset-folder
/delete-asset-folder
: Folder management
Component Management
fetch-components
: List all componentsget-component
: Get specific componentcreate-component
: Create new componentsupdate-component
: Update component schemasdelete-component
: Remove components
Content Discovery
search-stories
: Advanced content searchget-story-by-slug
: Get content by slug
Space Management
get-space
: Get space informationfetch-folders
: List content foldersfetch-datasources
: List datasources
Best Practices Implemented
- Modular Architecture: Each tool category is in its own file
- Type Safety: Comprehensive TypeScript types for all interfaces
- Error Handling: Consistent error handling across all tools
- Code Reuse: Shared utilities for common operations
- Documentation: Comprehensive inline documentation
- Configuration Management: Centralized environment variable handling
API Coverage
This server provides comprehensive coverage of the Storyblok Management API and Content Delivery API, including:
- Stories API (Management & Delivery)
- Assets API
- Components API
- Releases API
- Tags API
- Space API
- Datasources API
Each tool includes proper error handling, parameter validation, and consistent response formatting.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A comprehensive server enabling natural language interaction with Storyblok CMS for managing stories, assets, components, releases, and other content through a modular architecture.
Related MCP Servers
- -securityFlicense-qualityThis TypeScript-based server implements a simple notes system, allowing users to create and manage text notes and generate summaries, showcasing core MCP concepts.Last updated -27TypeScript
- AsecurityAlicenseAqualityThis TypeScript-based server implements a simple notes system using MCP concepts, enabling users to create, list, and summarize text notes through natural language prompts.Last updated -5198193JavaScriptMIT License
- AsecurityAlicenseAqualityA TypeScript-based server that enables interaction with Jira, providing tools to execute JQL queries, manage tickets, list projects and statuses through natural language.Last updated -1120JavaScriptMIT License
- -securityAlicense-qualityEnables management of Payload CMS projects through natural language commands, allowing developers to create, configure, and deploy content models with conversational AI.Last updated -8221MIT License