Storyblok MCP

🚀 Storyblok MCP Server

Connect AI tools to Storyblok instantly and use natural language to manage your CMS like magic.

🚀 Quick Start

This server allows you to connect AI tools with Storyblok and manage your CMS using natural language. Below, you'll find details about the project, setup steps, usage guides, and more.

✨ Features

• AI Integration: Connect AI tools to Storyblok seamlessly, enabling natural - language - based content management.
• Comprehensive Functionality: Cover various aspects of Storyblok management, including story, tag, release, asset, and component management.
• AI - Powered Utilities: Provide AI - related features such as generating alt - text, translating stories, and generating meta - tags.

📦 Installation

For Contributors

1. Clone the repository:

   git clone https://github.com/ArjunCodess/storyblok-mcp.git
   cd storyblok-mcp
   

2. Install dependencies:

   pnpm install
   

3. Run the server:

   pnpm start
   

For Users

1. Clone the repository:

   git clone https://github.com/ArjunCodess/storyblok-mcp.git
   cd storyblok-mcp
   

2. Connect with Cursor:
   • Open Cursor in the same directory.
   • Right - click on the build/index.js file and click Copy Path.
   • Go to Settings → MCP Tools.
   • Click on New MCP Server.
   • Inside the opened mcp.json file, paste the following and replace PATH_YOU_COPIED with the path copied in the second step:

   {
     "mcpServers": {
       "storyblok": {
         "command": "node PATH_YOU_COPIED",
         "env": {
           "STORYBLOK_SPACE_ID": "your_space_id",
           "STORYBLOK_MANAGEMENT_TOKEN": "your_management_token",
           "STORYBLOK_DEFAULT_PUBLIC_TOKEN": "your_public_token",
           "GOOGLE_GENERATIVE_AI_API_KEY": "your_gemini_ai_api_key"
         }
       }
     }
   }
   

📚 Documentation

Why This Project?

This project is built for the Storyblok Headless CMS Challenge on DEV.to. The goal is to combine the power of AI and Storyblok to create something new and useful.

What is Storyblok?

Storyblok is a powerful headless CMS. It follows an API - first approach, making it easy for developers and content creators to collaborate. It is modular, highly flexible, and can fit any frontend or workflow.

What's an MCP Server?

MCP stands for a protocol that connects AI, tools, and data. The MCP server acts as an intermediary, showing AI what it can do and what data it has. This allows AI clients, such as Cursor or Claude Desktop, to interact with Storyblok through natural language and manage content smoothly.

Challenges I Faced

• Built for myself (lol): I had never created or installed an MCP before, and it took much longer than I expected.
• API stress: I constantly checked Storyblok's API documentation, fearing that I might miss something.
• AI stuff pressure: Getting the AI features right without breaking anything was a headache.
• Security: I had to ensure that no sensitive information was leaked while exposing Storyblok management.
• Developer experience: I made sure the server was easy to run, extend, and integrate with AI tools without taking shortcuts.

Tools

1. Story Management

• fetch_stories: Retrieve a list of stories (pages, folders, or content entries) from Storyblok. Supports filtering, pagination, and search.
• get_story: Fetch a single story by its ID.
• create_story: Create a new story (page, folder, or content entry) in Storyblok.
• update_story: Update an existing story's content, name, slug, or tags.
• delete_story: Delete a story by its ID.
• publish_story: Publish a story, making it live.
• unpublish_story: Unpublish a story, removing it from the live site.
• get_story_versions: Retrieve all previous versions of a story for version history and rollback.
• restore_story: Restore a story to a previous version.

2. Tag Management

• fetch_tags: List all tags used in the space.
• create_tag: Create a new tag.
• create_tag_and_add_to_story: Create a tag and immediately assign it to a story.
• delete_tag: Delete a tag by its ID.

3. Release Management

• fetch_releases: List all releases (content batches for scheduled publishing).
• create_release: Create a new release.
• add_story_to_release: Add a story to a release.
• publish_release: Publish all stories in a release.
• delete_release: Delete a release.

4. Asset Management

• fetch_assets: List all assets (images, files, etc.) in the space.
• get_asset: Fetch a single asset by its ID.
• delete_asset: Delete an asset.
• init_asset_upload: Start uploading a new asset.
• complete_asset_upload: Complete the asset upload process.

5. Asset Folder Management

• fetch_asset_folders: List all asset folders.
• create_asset_folder: Create a new asset folder.
• update_asset_folder: Rename an asset folder.
• delete_asset_folder: Delete an asset folder.

6. Component Management

• fetch_components: List all components (content types) in the space.
• get_component: Fetch a single component by its ID.
• create_component: Create a new component.
• update_component: Update a component's schema or settings.
• delete_component: Delete a component.

7. Advanced Story Search

• search_stories: Search for stories using advanced filters (by slug, tag, etc.).
• get_story_by_slug: Fetch a story by its slug.

8. Space & Folder Info

• get_space: Get information about the current Storyblok space.
• fetch_folders: List all story folders.
• fetch_datasources: List all datasources (for dynamic select fields, etc.).

9. Utility

• ping: Check if the server and Storyblok API are reachable.

10. AI Tools

• generate_alt_text: Automatically create alt text for images based on content or context.
• translate_story: Translate the content of a story into different languages using AI.
• generate_meta_tags: Generate SEO - friendly meta titles and descriptions for any story.
• summarize_story: Get a brief AI - generated summary of a story’s content.
• tag_story_with_ai: Auto - generate relevant tags for a story using natural language processing.

🤝 How to Contribute

Fork the repository, make your changes, and open a pull request. If you find bugs or have feature requests, open an issue.

🔗 Useful Links

• Storyblok Docs
• MCP Protocol
• MCP TypeScript SDK
• DEV.to Challenge

🙏 Thanks

This project is made with ❤️ for the DEV.to Storyblok Challenge.

📄 License

This project is licensed under the MIT license.