# CrafterCMS MCP for AI Agents AI Agent Connect > CrafterCMS MCP connects your AI agent to your content management system. It lets you fetch pages, explore folder hierarchies, run GraphQL queries, and manage the engine cache. Use it to query headless content or check site status without leaving your IDE or chat interface. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_Oflkm9N0dNiPsOPQAfATwgncrzmukLSofNYHLkI7/ai-agent-connect - **Tags:** cms, headless, graphql, opensearch, content-delivery, craftercms ## Description Imagine you're deep in a content audit and need to know exactly how many components are nested inside a specific folder or what the breadcrumb trail looks like for a production URL. Usually, this means jumping back into the CMS dashboard, clicking through several layers of navigation, and manually copying data. With this CrafterCMS MCP, you just ask your agent to do the heavy lifting. It pulls the data directly into your conversation. You can grab specific items, explore entire site structures, or run complex searches using OpenSearch syntax to find exactly what you need. It even handles the technical side, like clearing the engine cache or rebuilding the context when things get wonky. It turns your CMS into a queryable data source that your agent can actually interact with. You'll find this is a massive time-saver when you're trying to map out content relationships or verify metadata across different environments. It's one of the many high-quality integrations you can find in the Vinkius catalog to bridge the gap between your content and your development workflow. ## Tools ### clear_cache Clears the Crafter Engine cache to ensure you're seeing the latest content updates. Use this when changes aren't appearing on the live site. ### get_tree Returns the complete hierarchy under a folder for a full structural overview. It shows every nested layer at once. ### graphql Executes a GraphQL query against your content schema to pull specific data sets. This is perfect for custom data requirements. ### rebuild_context Forces the Crafter Engine to rebuild its context. Use this to fix common display issues or stale data problems. ### search Runs an OpenSearch JSON query to find specific content across your entire system. It's great for finding needles in haystacks. ### transform_url Applies specific logic to content paths to see how they look in different environments. Use it to verify delivery paths. ### get_breadcrumb Retrieves the navigation breadcrumbs for a specific URL. This helps you map out site paths and navigation flow. ### get_children Lists all the items inside a specific folder. It helps you see what's nested where without opening the CMS. ### get_component Fetches and renders a specific component's data for inspection. This is useful for verifying layout details. ### get_item Retrieves a single content item from your store based on its path or ID. It's the fastest way to grab specific page data. ### get_navigation_tree Pulls the full navigation tree to help you visualize the site's structure. Use it to get a bird's eye view of your site. ### get_status Checks the current monitoring status of your Crafter Engine. Use this to ensure the system is running well. ## Prompt Examples **Prompt:** ``` Can you show me the navigation for the 'Products' section? ``` **Response:** ``` I've pulled the navigation tree for you. Here are the main sections under Products: | Section | Sub-pages | | :--- | :--- | | **Electronics** | Smartphones, Laptops, Tablets | | **Home Office** | Desks, Chairs, Monitors | | **Accessories** | Cables, Keyboards, Mice | Would you like me to drill down into any of these? ``` **Prompt:** ``` Run a query to find all pages with 'Summer Sale' in the title. ``` **Response:** ``` Executing the search now... I found 4 pages matching 'Summer Sale': * **Summer Sale - Electronics** (Path: /promotions/summer-electronics) * **Summer Sale - Home Goods** (Path: /promotions/summer-home) * **Early Bird Summer Sale** (Path: /promotions/early-bird) * **Limited Time Summer Sale** (Path: /promotions/limited-summer) I can fetch the full content for any of these if you need. ``` **Prompt:** ``` What's the breadcrumb for /site/blog/post-1? ``` **Response:** ``` The breadcrumb navigation for that URL is: **Home > Blog > Post-1** Would you like me to check the navigation for a different path? ``` ## Capabilities ### Fetch content items Retrieve specific pages or components directly into your chat. ### Explore site structure View navigation trees and folder hierarchies to see how content is organized. ### Run GraphQL queries Execute complex queries against your content schema to get specific data sets. ### Manage engine cache Clear the Crafter Engine cache or rebuild the context to fix display issues. ### Check system status Monitor the health and monitoring status of your Crafter Engine. ### Transform URLs Apply logic to content paths to see how they behave in different environments. ## Use Cases ### Verifying content layout A developer needs to check a page's components. They ask the agent to use get_component for a specific path to see the layout. ### Mapping site navigation A content manager is worried about a broken link. They ask the agent to use get_breadcrumb to see the navigation path. ### Refreshing stale content An admin sees a stale page. They tell the agent to use clear_cache to refresh the site immediately. ### Finding specific articles A dev needs to find all articles with a specific tag. They ask the agent to run a search query using OpenSearch syntax. ## Benefits - Stop switching tabs between your IDE and the CMS dashboard. You can use get_item to see content while you're coding. - Audit your entire site structure in seconds. Use get_navigation_tree to see how pages are connected without manual clicking. - Run complex data fetches instantly. Use graphql to pull exactly the fields you need for your frontend. - Fix content display issues faster. Use rebuild_context or clear_cache to refresh the engine immediately. - Verify URL paths across environments. Use transform_url to ensure your delivery paths are correct every time. ## How It Works The bottom line is you get a direct line of communication between your AI agent and your CrafterCMS content. 1. Subscribe to the CrafterCMS MCP and gather your credentials. 2. Input your Base URL, Site ID, and access tokens into your AI client. 3. Ask your agent to pull content, run queries, or clear the cache. ## Frequently Asked Questions **Can I use CrafterCMS MCP to see my site structure?** Yes, you can use it to pull the full navigation tree or folder hierarchies. This lets you see how your content is organized without having to click through every folder in the CMS dashboard. **Does CrafterCMS MCP help with GraphQL queries?** Yes, it allows your AI agent to execute GraphQL queries against your content schema. This is great for pulling specific data sets for your frontend development. **How do I clear the cache with CrafterCMS MCP?** You can just ask your agent to clear the engine cache. It will use the tool to refresh the system so you can see your latest content updates immediately. **Can I use it to find specific content?** Yes, the Connector includes a search tool that lets you run queries to find specific content across your entire system using natural language. **Will CrafterCMS MCP show me my breadcrumbs?** It can. You can provide any URL to your agent, and it will retrieve the breadcrumb navigation for that specific path to help you map out your site's structure. **Can I execute complex GraphQL queries against my content?** Yes! Use the `graphql` tool to send query strings and optional variables. The agent will return the data according to your site's auto-generated schema. **How do I clear the delivery cache for my site?** You can use the `clear_cache` action. Note that this requires a valid `CRAFTERCMS_MANAGEMENT_TOKEN` to be configured in your credentials. **Is it possible to search for content using OpenSearch syntax?** Absolutely. The `search` tool allows you to pass a raw OpenSearch JSON query object to find exactly what you need within your CrafterCMS index.