• DATA
  • ROUTING
  • ERRORS
  • HUMAN

How to verify page layouts with your AI agent

Connect ButterCMS to your agent to audit your content structure. Once connected, your AI can pull live data to check your site's logic.

Ask AI about this page

Short answer

Can my AI check if my ButterCMS data matches my UI?

Yes. Your agent pulls specific page layouts and custom page lists to confirm your content structure. It then compares that JSON against your routing logic to find mismatches. You get a clear view of where your data and UI diverge.

Where the discrepancies land.

The outcomes of your audit

The AI identifies mismatches between your CMS and your frontend.

DATA

Structure validation

The agent pulls the exact JSON for your pages. It checks that all required fields exist and follow your schema.

ROUTING

Route matching

It verifies that the slugs and custom page paths in ButterCMS align with your application's URL patterns.

ERRORS

Broken link detection

The AI flags missing content or broken references in your nested structures before you deploy.

HUMAN

Manual fixes

The agent highlights the specific JSON paths that failed. You then go into the ButterCMS dashboard to correct the data.

The workflow

What your AI does when the data arrives.

The agent acts as a bridge between your CMS content and your code logic.

  1. Fetch page data

    The agent pulls the specific layout configuration for a given page to see how the content is nested.

    get_page_layout

  2. Scan custom pages

    It retrieves a full list of your custom pages to map out the available content types.

    list_custom_pages

  3. Compare structures

    The agent compares the retrieved JSON against your routing requirements to find missing keys or incorrect slugs.

    get_page_layout

  4. Report mismatches

    It identifies exactly which page or field is causing a routing error or a layout break.

    list_custom_pages

Try it

Copy these to start.

Use these prompts to begin your layout audit.

Starting points

Swap out the specific page names or slugs with your actual ButterCMS identifiers.

ButterCMS Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_lz8oJACuel9Orm3eZ03PsVsPvz38Hxfltpy66t6c/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 — ButterCMS capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "buttercms-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_lz8oJACuel9Orm3eZ03PsVsPvz38Hxfltpy66t6c/mcp"
    }
  }
}
Copy into chat04

  • Check the layout for the 'homepage' page and tell me if any required fields are missing.

  • List all my custom pages and verify if the slugs match my current routing table.

  • Look at the 'product-detail' page layout and check if the nested JSON matches my UI component props.

  • Compare the list of custom pages with my site map to find any orphaned content.

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

Start here

Connect ButterCMS once, then ask.

Just enter your API credentials. Your login stays encrypted on our side, and you can immediately start asking your agent to inspect your content.

Connect ButterCMS to your AI

FAQ

How this task behaves

  • 01

    Can the AI change my content in ButterCMS?

    No. The AI can only read your page layouts and custom page lists. It cannot edit or delete your content.

  • 02

    Does the AI fix my code automatically?

    No. The AI identifies where the data and your code don't match, but you have to make the actual changes in your editor or CMS.

  • 03

    Can it see all my content?

    It can see any page or custom page that the provided tools are able to access.

  • 04

    How does it know my UI routing?

    You need to provide your routing logic or code context in the chat so the AI has something to compare the ButterCMS data against.

  • 05

    Can it create new pages?

    No. The tools only allow the agent to fetch existing layouts and list existing pages.

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

Connect ButterCMS to Claude, Cursor, ChatGPT & more