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:

src/ ├── config/ # Configuration and environment setup ├── types/ # TypeScript type definitions ├── utils/ # Shared utilities and API helpers ├── tools/ # Tool implementations organized by feature │ ├── ping.ts # Health check │ ├── stories.ts # Story management │ ├── releases.ts # Release workflows │ ├── tags.ts # Tag management │ ├── assets.ts # Asset management │ ├── components.ts # Component management │ ├── search.ts # Content discovery │ ├── space.ts # Space operations │ └── index.ts # Tool registration └── index.ts # Main server entry point

Environment Variables

The following environment variables are required:

STORYBLOK_SPACE_ID=your_space_id STORYBLOK_MANAGEMENT_TOKEN=your_management_token STORYBLOK_DEFAULT_PUBLIC_TOKEN=your_public_token

Installation & Setup

Install dependencies:

yarn install

Build the project:

yarn build

Configure environment variables in your MCP client configuration.

Development

Building

yarn build

Type Checking

yarn tsc --noEmit

Tool Categories

Basic Tools

ping: Server health check

Content Management

fetch-stories: List stories with filtering
get-story: Get specific story by ID/slug
create-story: Create new stories
update-story: Update existing stories
delete-story: Delete stories
publish-story / unpublish-story: Publishing controls
get-story-versions / restore-story: Version management

Tag Management

fetch-tags: List all tags
create-tag: Create new tags
create-tag-and-add-to-story: Create and assign tags
delete-tag: Remove tags

Release Management

fetch-releases: List releases
create-release: Create scheduled releases
add-story-to-release: Add content to releases
publish-release: Publish releases
delete-release: Remove releases

Asset Management

fetch-assets: List assets with filtering
get-asset: Get specific asset details
delete-asset: Remove assets
init-asset-upload / complete-asset-upload: Upload workflow
fetch-asset-folders: List asset folders
create-asset-folder / update-asset-folder / delete-asset-folder: Folder management

Component Management

fetch-components: List all components
get-component: Get specific component
create-component: Create new components
update-component: Update component schemas
delete-component: Remove components

Content Discovery

search-stories: Advanced content search
get-story-by-slug: Get content by slug

Space Management

get-space: Get space information
fetch-folders: List content folders
fetch-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

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

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.

Enables comprehensive management of Storyblok CMS through natural language interactions. Supports story creation and publishing, asset management, component schema updates, release workflows, and content discovery across all major Storyblok APIs.

Storyblok MCP Server