Storyblok MCP. Manage content structure without touching the UI.
Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Storyblok MCP Server connects your AI client directly to a headless CMS. It lets you programmatically manage content spaces, read asset libraries, and structure complex data stories without opening the visual editor.
You can list all active environments, create new articles with defined schemas, or update existing page components via conversation.
What your AI agents can do
Create content story
Builds a brand new story in your Storyblok space by accepting a name, slug, and content JSON payload.
Delete content story
Permanently deletes an existing Storyblok story. This action cannot be undone.
Get story details
Retrieves all the specific details for one content story using its ID.
List all accessible content spaces, or fetch a list of stories within a specific space ID.
Generate new articles with defined names, slugs, and complex JSON content structures, or update fields in an existing story.
List all media files stored in the Storyblok space to get their URLs and metadata.
Retrieve a list of available content component blueprints, letting you know what structures are possible for your site.
List all users who have access to the current space for security checks.
Ask AI about this MCP
Supported MCP Clients
Waiting for input…
Storyblok MCP Server: 9 Tools for CMS Management
Use these nine tools to build, read, modify, and audit all types of structured content and media within your Storyblok space.
019d760dcreate content story
Builds a brand new story in your Storyblok space by accepting a name, slug, and content JSON payload.
019d760ddelete content story
Permanently deletes an existing Storyblok story. This action cannot be undone.
019d760dget story details
Retrieves all the specific details for one content story using its ID.
019d760dlist assets
Fetches a list of every media asset stored in the Storyblok space.
019d760dlist components
Gets a complete list of available, reusable content component blueprints for your site.
019d760dlist space users
Lists every user account that has access permissions to the current space.
019d760dlist spaces
Retrieves a list of all Storyblok spaces you have access to.
019d760dlist stories
Lists content stories within a specified space ID, giving an overview of available content titles.
019d760dupdate content story
Updates the fields of a story that already exists by requiring both the space and story IDs.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Storyblok, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Storyblok MCP Server
Your agent connects directly to a headless CMS, giving you hands-on control over content—no need for the visual editor, trust me. You can programmatically manage entire content spaces and structure complex data stories using just conversation. This lets your AI client interact with Storyblok's backbone, bypassing the traditional click-and-drag workflow entirely.
It’s all about controlling the data flow directly from your chat interface.
Discovering Content Structure and Spaces
You can start by getting a full list of every accessible content space using list_spaces, so you know exactly what environments you're playing with. If you need an overview of existing articles, use list_stories to fetch all content titles within a specific space ID.
Managing Stories: Create, Read, Update, Delete (CRUD)
The server gives you full lifecycle control over stories. To build something brand new, invoke create_content_story: you just provide the story's name, its unique slug, and a detailed content JSON payload, and it builds the article for you. If that story needs tweaking later, use update_content_story; you gotta supply both the space ID and the existing story ID to modify any of its fields.
For quick reference on an existing piece, run get_story_details with a specific story's ID to grab every detail about it. You can also manage the whole collection by running list_stories again.
When you’re done with content, and you know for sure you never want it back, delete_content_story permanently removes an existing Storyblok story—it’s irreversible, so don't mess around.
Inspecting Components and Media Assets
Want to see what kind of structures are possible? Run list_components to get a full list of every available content component blueprint; this shows you exactly what structures your site can handle. To check out the media, use list_assets, which fetches a complete inventory of every single media file stored in the Storyblok space, giving you both their URLs and metadata.
Auditing Permissions
If you gotta check who's allowed into the system, run list_space_users to get an account list of everyone with access permissions to the current space. This keeps your security tight.
Basically, you use these tools to build a complete picture of what’s going on behind the curtain. You don't have to rely on clicks; you control the data flow using simple commands like create_content_story(name: string, slug: string, content: JSON) or checking existing assets with list_assets().
How Storyblok MCP Works
- 1 Establish the Storyblok MCP module as a bridge on your AI client. You'll need an authorized
STORYBLOK_TOKENin the MCP configuration to run commands. - 2 Prompt your agent with a task, like: 'List all component blueprints and then draft a new blog post using that structure.'
- 3 The agent calls the necessary tools (
list_components, thencreate_content_story) sequentially, giving you structured data back in JSON format.
The bottom line is, it lets your AI client treat the CMS like a database—you query and manipulate content using natural language prompts instead of clicking through web forms.
Who Is Storyblok MCP For?
Content Architects or SEO Managers who are tired of manually navigating complex content hierarchies. Frontend Developers needing to pull component IDs programmatically, not by guessing. And Agile Editors who need to push localized drafts across multiple live platform versions without slow structural validations.
Needs to bulk-orchestrate content and analyze complex hierarchies. They use this to programmatically alter metadata or run large-scale story audits.
Uses it to query nested objects or retrieve component structural IDs automatically, isolating dependencies without manually checking the CMS UI.
Requires analyzing and updating content stories at scale. They use this to ensure metadata parameters are consistent across hundreds of articles quickly.
What Changes When You Connect
- Full Content Lifecycle Control: You can create new stories (
create_content_story), modify existing ones (update_content_story), and delete them programmatically. This moves content management from a series of clicks into a single, actionable chat command. - Deep Asset Analysis: Don't just browse media files. Use
list_assetsto pull every asset URL in bulk. The agent can read this list, making it easy to integrate large batches of images or videos immediately. - Structured Development Flow: Need to know what components are available? Call
list_components. This tool standardizes development by giving your AI client a definitive blueprint of all possible content blocks on the site. - Space Visibility and Auditing: Use
list_spacesto see every environment you work in, or uselist_space_usersto audit who has access. It keeps your project structure visible from one place. - Granular Story Retrieval: Instead of getting a massive dump of data, use
get_story_detailsto pull only the specific information you need for a single piece of content. This cuts down on noise and speeds up retrieval.
Real-World Use Cases
Updating metadata across 50 articles
An SEO Manager needs to update the featured author for fifty old blog posts. Instead of opening fifty different stories, they prompt their agent: 'Update all stories in Space X to use Author ID Y.' The agent calls update_content_story repeatedly and systematically, solving a massive manual task instantly.
Building a new site section from scratch
A developer needs a new landing page. They ask the agent to 'Draft a story for the Q3 campaign.' The agent first checks schemas using list_components, then uses that blueprint to call create_content_story with the proper JSON structure.
Preparing content for migration
A Content Architect is preparing content for a system switch. They run list_stories to get all titles, then use get_story_details on each one to extract the specific component IDs needed for the new platform's API.
Inventory check of media assets
A marketing team needs a list of all available photos and videos before a campaign launch. They prompt the agent, 'List every asset in the space.' The agent calls list_assets and provides clean URLs for immediate use.
The Tradeoffs
Trying to update everything at once
Asking the agent: 'Fix all content issues in Space A.' This is vague. The system doesn't know if you mean metadata, text, or components.
→
Be specific and use tools. First, list what needs fixing: 'Run list_stories for space ID 123.' Then, target the fix: 'Use update_content_story to change the slug of story XYZ.'
Relying only on listing tools
Just running list_components and assuming you know how to build a full page. You get blueprints, but no actual content.
→
After checking available components (list_components), use that knowledge in conjunction with create_content_story. This lets the agent draft the story using validated schemas.
Guessing IDs
Telling the agent to update a story without providing both the space ID and the specific story ID. The operation fails immediately.
→
Always verify your targets first. Run list_stories (requires Space ID) to confirm the slug or title, then use that result in update_content_story for accuracy.
When It Fits, When It Doesn't
Use this if you need programmatic control over content structure and assets. If your workflow involves reading data from a CMS and using that data (metadata, component IDs) to build or change other structured content, this is the right tool.
Don't use it if you just need to view the site as an end-user would—that requires browsing. Don't use it for general API calls that aren't CMS related (like sending emails or managing inventory). For simple data retrieval without needing component context, sometimes a specialized read-only endpoint might be better than using get_story_details. This tool is built around the content lifecycle: discovery (list_stories), definition (list_components), and modification/creation (create_content_story).
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Storyblok. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 9 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Manually checking component IDs across a site's development environment.
Today, if you’re building out a complex page or need to audit content structure, you have to jump between the CMS UI and your code editor. You click through dozens of sample pages just to figure out what component IDs are valid—is it `rich_text` or `markdown-block`? This is tedious copy/pasting and manual verification.
With this MCP server, you ask your agent: 'What content components can I use?' The agent calls `list_components`, spits back a clean list of available blueprints, and you get the exact component names ready to build into your payload. It's instant structural clarity.
Storyblok MCP Server: Write or update content stories via chat.
The old way meant having to open a story, click the 'Edit Content' button, and manually fill out structured JSON fields in complex forms. If you missed one field or used an incorrect slug, the save failed, and you started over.
Now, you just tell your agent: 'Create a new blog post titled 'AI Trends' with this content.' The agent handles the entire payload structure via `create_content_story`. You get validated, ready-to-publish content in seconds.
Common Questions About Storyblok MCP
How do I list stories using Storyblok MCP Server? +
You use the list_stories tool. This requires you to specify a space ID first, then it returns an overview of all story titles available in that specific content area.
Can I delete a story with Storyblok MCP Server? +
Yes, the delete_content_story tool handles this. Just be warned: the API confirms this action is irreversible, so double-check before running it.
What if my content structure changes? Should I use list_components? +
Absolutely. You should run list_components any time you suspect the available building blocks have changed. This guarantees your AI client is using current, valid component blueprints.
Which tool do I use to get a single story's details? +
Use get_story_details. You need the specific content story ID for this function; it retrieves all fields and components associated with that one piece of content.
How do I use `create_content_story` if I need to publish brand-new content? +
You call create_content_story by providing a name, slug, and the full content JSON payload. This tool handles the entire publishing workflow, making it easy for your agent to generate draft stories directly into the space.
What is the process for modifying an existing story using `update_content_story`? +
To update a story, use update_content_story. You must pass both the specific space ID and the target story ID. This lets your agent change fields—like fixing a typo or revising metadata—without overwriting the entire structure.
How do I find out which content spaces are available using `list_spaces`? +
list_spaces shows you all accessible environments. If you aren't sure if your target story is in 'Production' or 'Staging,' running this tool first helps your agent confirm the correct space ID before listing stories.
Which tool do I use to list and manage media assets with `list_assets`? +
list_assets scans your entire media repository. It returns a list of all available files, giving you the direct URLs needed to reference images or videos when building components into a story.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
AntChain
Alibaba's enterprise blockchain API hub — query blocks, transactions, smart contracts, and accounts on AntChain BaaS.
Chuck Norris
Access the legendary power of Chuck Norris facts — get random jokes, browse categories, and search the entire database directly from your AI agent.
Nodereal
High-performance blockchain infrastructure for Aptos and EVM networks — query accounts, blocks, and simulate transactions.
You might also like
IgnitePOST
Manage hand-written note orders and outreach campaigns via IgnitePOST API.
Deezer
Search music, browse artists, albums and playlists, and explore charts via AI.
Freightview
Automate LTL freight quoting, track shipments, and manage carriers via AI agents with Freightview.