# Storyblok MCP

> Storyblok MCP lets your AI client manage content structure and assets directly within Storyblok. It gives you programmatic control over headless CMS environments. You can list entire content spaces, analyze available component blueprints, draft new stories, update existing articles, and find all media files without ever touching the visual editor.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** content-modeling, visual-editor, api-driven-content, digital-experience, asset-management, structured-data

## Description

Managing complex digital content used to mean clicking through endless dashboards or copy-pasting structural IDs from one tab to another. This MCP changes that. It connects your AI agent directly into Storyblok's backend, treating your entire content repository like a database you can talk to. You instruct your agent what you need—say, 'Give me all the components used in our marketing space and draft a new story using those elements.' The system finds the necessary blueprints, validates them against existing data, and then builds or updates the content for you. It’s about treating content not as visual blocks, but as structured data. If you're building out a complex site structure and need an AI assistant that understands component hierarchies and asset libraries, Vinkius has this MCP ready to go.

## Tools

### create_content_story
Builds a brand new content article by providing its name, slug, and structured JSON data.

### delete_content_story
Permanently removes an existing story from the content repository. This action can't be undone.

### get_story_details
Fetches all specific details for a single, identified content article.

### list_assets
Scans and retrieves a list of every media file stored within the Storyblok space.

### list_components
Shows all structural blueprints that can be used to build content pages.

### list_spaces
Lists every distinct and accessible Storyblok environment or 'space'.

### list_stories
Retrieves a list of article titles and metadata within a specific content space.

### list_space_users
Lists all users who have been granted access permissions for the targeted space.

### update_content_story
Modifies specific fields of an article that already exists in the system.

## Prompt Examples

**Prompt:** 
```
List the recent articles from my Storyblok space and detail their structural components.
```

**Response:** 
```
Connected to your Storyblok space.
**Recent Stories (`list_stories`)**:
- `Introduction to LLMs`
- `Marketing Automation Update`
- `Platform Change-log`

Inspecting component structure via `get_story_details`:
- Components: `hero_banner`, `rich_text`, `call_to_action`. Ready for modifications.
```

**Prompt:** 
```
List the structure blueprints by calling list_components and then formulate a new JSON to create a blog story.
```

**Response:** 
```
Analyzing current schemas...

**Available Components (`list_components`)**:
- `article_body`
- `media_header`

Structuring the payload...
**Created Story (`create_content_story`)**:
Successfully published the new blog story 'Future Tech' into the content repository.
```

**Prompt:** 
```
List all multimedia assets in my Storyblok space and display their URLs.
```

**Response:** 
```
Scanning the media repository...

**Assets Discovered (`list_assets`)**:
- `product_demo.mp4` -> `//a.storyblok.com/.../demo.mp4`
- `hero_bg.jpg` -> `//a.storyblok.com/.../hero.jpg`

These assets are ready to be integrated into your active story components.
```

## Capabilities

### Discover Content Spaces
Lists all accessible Storyblok environments so your agent knows where to start working.

### Inventory Stories and Assets
Retrieves lists of existing articles or scans the entire media library for multimedia files.

### Analyze Component Blueprints
Lists all defined content components, helping you understand what structural elements are available to build with.

### Build and Modify Content
Creates new articles or updates fields in existing stories using structured data inputs.

### Audit Space Users
Checks who has editing access to a specific content space, helping manage internal permissions.

## Use Cases

### Launching an Article Draft
A Content Architect needs to publish a new thought leadership piece. They ask their agent to draft it, which uses `list_components` first, then calls `create_content_story`, ensuring the article adheres to the correct format and includes proper metadata.

### Updating Product Information
A Marketing Manager updates pricing across fifty product pages. Instead of logging into each one, they instruct their agent to run `list_stories` for all relevant spaces and then use `update_content_story` in bulk.

### Building a Component Library
A developer wants to know if the team has already built a 'Testimonial Block.' They ask the agent, which uses `list_components`, confirming the exact structural ID needed for their front-end code.

### Media Audit for Compliance
An SEO manager suspects outdated imagery. They tell their agent to run `list_assets` across all spaces, giving them a complete inventory of every media file that needs review or replacement.

## Benefits

- You can generate a new story or update an existing one using `create_content_story` or `update_content_story`, feeding the agent structured JSON payloads instead of typing out markdown manually.
- When you need to know what structural parts are available, running `list_components` shows you all schema blueprints. This stops guesswork and standardizes development across teams.
- To prepare a new campaign page, your agent can first use `list_assets` to find every relevant image or video, making sure the content is sourced before writing begins.
- Need an overview of what's published? Running `list_stories` gives you titles and metadata for all articles in a space, letting you build a comprehensive index instantly.
- Before touching content, use `list_space_users` to audit who has access rights. This is critical for maintaining security and controlling modifications across different projects.

## How It Works

The bottom line is that you tell your AI client what content structure you want, and this MCP executes the necessary steps inside Storyblok to make it happen.

1. Establish the Storyblok MCP module on your preferred AI client.
2. Provide an authorized connection token in the MCP settings so your agent can execute commands securely.
3. Prompt your agent with a specific request, like asking it to retrieve component blueprints and then draft a new story structured as JSON.

## Frequently Asked Questions

**How do I find out which Storyblok spaces are available using the Storyblok MCP?**
You run `list_spaces`. This tool gives your agent a list of all accessible environments, letting you target the right project before any work begins.

**Can I use the Storyblok MCP to check if an article exists?**
Yes. You can first run `list_stories` within a specific space ID. This gives you a list of existing titles, confirming if your desired content piece is already published.

**How does the Storyblok MCP help with structured data creation?**
You use `create_content_story`. You just provide the name and the JSON payload, and it handles building the article according to your specified schema.

**What if I need to modify an existing blog post using Storyblok MCP?**
Use `update_content_story`. This requires you to provide both the space ID and the story ID, plus the specific fields you want to change in the article.

**Does the Storyblok MCP let me see what media is available?**
Yes. The `list_assets` tool scans your entire media library and gives you a full list of all images, videos, and other files ready for integration into your content.