# Storyblok MCP for AI Agents AI Agent Connect

> Storyblok lets you connect your AI to your headless CMS. You can manage content spaces, build out story structures, and handle assets without jumping between tabs. It turns your AI into a content operator that understands your specific schemas and can push updates directly to your live environment.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_g6NA0FgzwziBIbKl6e8q1WkJenuyDA4OigBTs2VN/ai-agent-connect
- **Tags:** content-modeling, visual-editor, api-driven-content, digital-experience, asset-management, structured-data

## Description

When you connect Storyblok to your AI, you're basically giving your agent a seat at the content table. Instead of manually copy-pasting JSON blobs or hunting through the visual editor to find a specific asset, you can just tell your agent what needs to happen. It handles the heavy lifting of navigating your content spaces, pulling in media, and updating story fields. You can ask it to draft new blog posts that follow your exact content model or check if a specific component is already being used in a certain space. Because this Connector is hosted on Vinkius, it plugs right into your existing workflow, letting you move from a thought to a live content update in a single conversation. It's built for teams who need to move fast without breaking the structure of their CMS. You get to maintain your governance rules while the AI does the tedious work of populating the fields, checking the schemas, and organizing the metadata. This means your content stays consistent across every page while you focus on the actual narrative. You can iterate on drafts, verify asset availability, and push updates to your live environment without the usual friction of switching between your workspace and your content repository. It turns your content management into a conversation rather than a series of clicks.

## Tools

### delete_content_story
Permanently remove a specific story from your space. Use this to clean up old drafts or deprecated content.

### list_components
See all available content components in your environment. Use this to understand what building blocks you have to work with.

### create_content_story
Create a new story in a Storyblok space by providing a name, slug, and content JSON. This makes it easy to generate new pages or posts instantly.

### get_story_details
Pull the full details of a single content story. It's the best way to see exactly what's inside a specific page.

### list_assets
See a list of all media files in a Storyblok space. This helps you find the right images or videos for your content.

### list_spaces
Get a list of all the Storyblok spaces you have access to. It's a quick way to see your entire enterprise environment.

### list_stories
List all the stories within a specific space. This is perfect for getting a high-level view of your content library.

### list_space_users
See who has access to a specific Storyblok space. Use this to manage permissions and see authorized operators.

### update_content_story
Modify the fields of an existing story in your space. This allows for quick updates to titles, text, or metadata.

## Prompt Examples

**Prompt:** 
```
Can you find all the blog posts in my 'Marketing' space and tell me which ones use the 'Hero Banner' component?
```

**Response:** 
```
I've scanned your **Marketing** space. Here are the stories using the `hero_banner` component:

| Story Title | Slug | Last Updated |
| :--- | :--- | :--- |
| Summer Sale | `summer-sale-2024` | 2 hours ago |
| New Arrivals | `new-arrivals-list` | 1 day ago |
| Product Launch | `product-launch-x` | 3 days ago |

Would you like me to pull the details for any of these?
```

**Prompt:** 
```
I need to create a new story called 'Summer Sale' in the main space. Use this JSON for the content: { 'title': 'Summer Sale', 'body': 'Big discounts inside!' }
```

**Response:** 
```
Successfully created the new story!

**Details:**
- **Name:** Summer Sale
- **Slug:** `summer-sale`
- **Content:** 
  - Title: Summer Sale
  - Body: Big discounts inside!

It is now live in your main Storyblok space.
```

**Prompt:** 
```
List all the images we have in our media library so I can pick one for a new page.
```

**Response:** 
```
I've pulled the media assets from your Storyblok space:

**Available Assets:**
- `product_demo.mp4` (Video)
- `hero_bg.jpg` (Image)
- `summer_banner.png` (Image)
- `logo_v2.svg` (Vector)

Let me know if you'd like the direct URLs for any of these.
```

## Capabilities

### List active content spaces
View all your available Storyblok environments in one list.

### Fetch story overviews
Get a high-level look at the content stories within a space.

### Create stories from prompts
Generate new content stories directly using natural language instructions.

### Update story fields
Modify existing story content and metadata via your AI client.

### Explore media assets
Scan your media repository to find specific images or videos.

### Inspect content components
See the building blocks available for your site's architecture.

### Manage space users
Check who has authorized access to your content spaces.

### Remove old stories
Permanently delete stories from your CMS environment.

## Use Cases

### Bulk metadata updates
An SEO specialist needs to update the 'meta_description' on 50 blog posts. They ask the agent to find all stories with a specific tag and update the field using `update_content_story`.

### Component discovery for dev
A developer needs to know which components are available in the 'Marketing' space. They ask the agent to list components so they can build a new page template.

### Rapid content drafting
A content creator wants to move a draft from a doc into the CMS. They provide the text to the agent, which then uses `create_content_story` to push it live.

### Media library audit
A designer needs to find all product images. They ask the agent to list assets and display the URLs so they can verify the correct files are in the space.

## Benefits

- Update content across multiple stories quickly using `update_content_story` to save hours of manual editing.
- Pull specific component IDs for your frontend work using `list_components` to keep your code in sync with the CMS.
- Draft new content pages instantly with `create_content_story` to move from copy to live environment faster.
- Audit your entire content library by listing all stories and spaces with `list_stories` and `list_spaces`.
- Manage your media library efficiently by using `list_assets` to find and reference specific files.
- Maintain security and oversight by checking authorized users via `list_space_users` before making big changes.

## How It Works

The bottom line is you turn your CMS into a conversational interface for content management.

1. Connect the Storyblok MCP to your AI client and add your STORYBLOK_TOKEN.
2. Describe the content update or query you need to perform in plain English.
3. The agent executes the commands and confirms the changes in your Storyblok environment.

## Frequently Asked Questions

**Can the Storyblok MCP help me update content faster?**
Yes, it lets your AI agent modify story fields directly. You can make changes across your site through a conversation instead of clicking through the dashboard.

**How does the Storyblok MCP handle my media assets?**
Your agent can list all the images and videos in your space. This makes it easy to find and reference specific files for your content without manual searching.

**Can I use this to see who has access to my Storyblok space?**
Yes, the Connector can list all authorized users. This helps you keep track of who can edit your content and manage permissions more easily.

**Can the Storyblok MCP create new pages for me?**
It can create new stories in your space using a name, slug, and your content data. This speeds up your publishing workflow by automating the creation step.

**Is it safe to let an AI agent edit my Storyblok content?**
You stay in control by giving the agent specific instructions. It only performs the actions you ask for, like updating specific fields or listing stories, and never acts on its own.

**Does the Storyblok MCP work with my existing Storyblok token?**
Yes, you just need to provide your authorized token in the configuration to let the agent securely connect to your environment.

**How does the AI validate JSON payloads before creating content?**
Instruct the agent to call `list_components` first. It returns the exact field names and types each component expects, so the AI builds a compliant JSON payload before calling `create_content_story`.

**Can the agent accidentally delete entire spaces?**
No. `delete_content_story` targets a single story by ID — it cannot perform recursive or bulk deletions. For extra safety, use a token scoped with limited write permissions.

**What content types can I manage through this integration?**
Stories (pages, articles, blog posts), media assets (images, videos, documents), component definitions, and space-level settings. Use `list_stories`, `list_assets`, and `list_components` to explore your content.