Skip to main content
Glama

MCP Storyblok Server

by zerdos

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

  1. Install dependencies:
yarn install
  1. Build the project:
yarn build
  1. 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.

-
security - not tested
F
license - not found
-
quality - not tested

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.

  1. Features
    1. Architecture
      1. Environment Variables
        1. Installation & Setup
          1. Development
            1. Building
            2. Type Checking
          2. Tool Categories
            1. Basic Tools
            2. Content Management
            3. Tag Management
            4. Release Management
            5. Asset Management
            6. Component Management
            7. Content Discovery
            8. Space Management
          3. Best Practices Implemented
            1. API Coverage

              Related MCP Servers

              • -
                security
                F
                license
                -
                quality
                This 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 -
                2
                7
                TypeScript
                • Apple
              • A
                security
                A
                license
                A
                quality
                This 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 -
                5
                198
                193
                JavaScript
                MIT License
                • Apple
              • A
                security
                A
                license
                A
                quality
                A 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 -
                11
                20
                JavaScript
                MIT License
                • Apple
              • -
                security
                A
                license
                -
                quality
                Enables management of Payload CMS projects through natural language commands, allowing developers to create, configure, and deploy content models with conversational AI.
                Last updated -
                82
                21
                MIT License
                • Linux
                • Apple

              View all related MCP servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/zerdos/mcp-storyblok-server'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server