• STRUCTURE
  • BLUEPRINTS
  • ERRORS
  • HUMAN

How to audit content hierarchy with your AI

Connect Storyblok to your AI client to scan your entire content structure. Once linked, your agent can map out how stories and components relate to each other.

Ask AI about this page

Short answer

Can my AI check my Storyblok structure?

Yes. Your AI uses the connector to pull your spaces, stories, and component lists to identify inconsistencies or broken hierarchies. You get a clear map of your architecture and a list of specific areas that need manual cleanup.

Audit outcomes.

Where your findings land.

The AI categorizes its findings into these four areas.

STRUCTURE

Hierarchy maps

The AI looks at how stories are nested. You get a clear view of your content tree and any orphaned stories.

BLUEPRINTS

Component audits

The agent checks your component library. It flags redundant or unused components that clutter your space.

ERRORS

Broken links

The AI identifies mismatches between story details and component requirements. You get a list of structural gaps.

HUMAN

Manual fixes

The AI flags complex logic issues it can't solve. These are the specific spots where you need to step in and edit.

The workflow

What your AI does when the audit starts.

The AI moves through your Storyblok environment in a logical sequence to build a complete picture.

  1. Map the environment

    The agent identifies all available content areas within your account.

    list_spaces

  2. Inventory stories

    It pulls a full list of every story to understand the depth of your content tree.

    list_stories

  3. Inspect content details

    The AI looks deep into specific story data to check for schema compliance.

    get_story_details

  4. Review blueprints

    The agent scans your component library to verify that your building blocks match your content needs.

    list_components

Try it

Copy these to start.

Use these prompts to kick off your audit.

Starting points

These are opening lines. Swap out the bracketed text for your actual Storyblok space or component names.

Storyblok Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_g6NA0FgzwziBIbKl6e8q1WkJenuyDA4OigBTs2VN/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Storyblok capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "storyblok-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_g6NA0FgzwziBIbKl6e8q1WkJenuyDA4OigBTs2VN/mcp"
    }
  }
}
Copy into chat04

  • List all the spaces in my Storyblok account and tell me which one has the most stories.

  • Look at the 'Homepage' story and tell me if the components used match my standard blueprints.

  • Check the component list and find any components that aren't being used in any stories.

  • Audit the hierarchy of my 'Marketing' space and find any stories that are too deeply nested.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Storyblok once, then ask.

Click the link to connect your account. Your credentials stay encrypted, and you can immediately start asking questions about your content.

Connect Storyblok to your AI

FAQ

How the audit behaves.

  • 01

    Can the AI change my content or components?

    No. The AI can only read your data to perform the audit. It cannot create, edit, or delete anything in Storyblok.

  • 02

    Does the AI see all my spaces?

    Yes, it uses the list_spaces tool to see everything it has permission to access.

  • 03

    Can the AI fix a broken component blueprint?

    No. The AI identifies the mismatch, but you must manually fix the blueprint in the Storyblok UI.

  • 04

    How does the AI know which components are in a story?

    It uses get_story_details to inspect the specific data within a story.

  • 05

    Will this slow down my Storyblok editor?

    No. The AI works through the API independently of your daily editing work.

  • More questions about Storyblok? The Connector page answers them. See everything the Storyblok Connector can do

Connect Storyblok to Claude, Cursor, ChatGPT & more