# ButterCMS MCP for AI Agents AI Agent Connect > ButterCMS MCP lets your AI agent read, search, and map your headless CMS content. Quickly grab blog posts, categories, authors, and custom page structures without manual data exports or complex API calls. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_lz8oJACuel9Orm3eZ03PsVsPvz38Hxfltpy66t6c/ai-agent-connect - **Tags:** headless-cms, content-api, taxonomy, data-extraction, knowledge-base ## Description This Connector connects your ButterCMS instance to your AI client so you can treat your content warehouse like a live knowledge base. Instead of copying and pasting text from the dashboard or manually mapping JSON structures, you can just ask your agent to find specific articles, summarize categories, or check author details. It handles the heavy lifting of navigating your taxonomy, allowing you to pull rich text data and marketing pages into your workflow instantly. Since it's part of the Vinkius catalog, you get a direct bridge to your headless content, making it easy to audit existing tags or debug why a specific custom page isn't rendering correctly. You're basically giving your agent eyes into your CMS so it can help you with SEO audits, content planning, or technical troubleshooting without you having to leave your chat window. ## Tools ### list_butter_authors Get a list of all CMS writers. This helps you identify who wrote which piece of content. ### list_custom_pages Look at the internal configurations for specific pages. Use this to see how custom data is mapped. ### list_blog_posts See the routing spaces for posts in your headless CMS. This helps you understand how your blog is indexed. ### search_collection_field Find specific active arrays within your filtered collections. This helps you pinpoint data points that match specific criteria. ### get_page_layout Get the exact structural matching for your UI routing. Use this to see how specific pages are built. ### get_post_details Pull specific Cloud logging and tracing for post slugs. It's great for looking up the history of a specific article. ### list_butter_categories Analyze the groupings in your CMS structure. Use this to see how your content is organized. ### list_global_collections See all attached structured rules and content items. This gives you a bird's eye view of your content types. ### list_butter_tags Map all taxonomy hits across your Web CRM. Use this to see all your active tags at once. ### search_blog_posts Extract properties for active keywords. This is the fastest way to find content related to specific topics. ## Prompt Examples **Prompt:** ``` Can you find all our blog posts that mention 'machine learning'? ``` **Response:** ``` I've searched the ButterCMS blog index for 'machine learning'. Here are the matches: | Title | Slug | Category | | :--- | :--- | :--- | | **The Future of ML** | `future-ml-trends` | Tech | | **ML in Production** | `ml-ops-guide` | Engineering | Would you like me to summarize the key points from either of these? ``` **Prompt:** ``` What are our main content categories and which one has the most authors? ``` **Response:** ``` I've pulled the category structures from your CMS. Here's the breakdown: * **Tech**: 12 authors * **Marketing**: 8 authors * **Engineering**: 15 authors * **Design**: 4 authors **Engineering** currently has the highest number of active writers. ``` **Prompt:** ``` Check the layout for the 'about-us' page and tell me the JSON structure. ``` **Response:** ``` I've retrieved the layout for the `about-us` page. It uses the following structural mapping: ```json { "layout_id": "hero_v2", "sections": [ {"type": "header", "content": "..."}, {"type": "image_gallery", "data_source": "gallery_01"}, {"type": "body_text", "content_id": "about_main"} ] } ``` The UI routing is currently mapped to the `hero_v2` component. ``` ## Capabilities ### Search blog posts by keyword Find specific articles in your blog by searching for active keywords. ### List all CMS categories Get a full overview of your organized content groupings. ### Fetch specific article details Retrieve the full content and metadata for a specific slug. ### Extract custom page configurations Inspect the internal JSON structures for custom pages. ### Map global taxonomy tags View all active tags and taxonomy hits across your CMS. ### Retrieve author lists Get a list of all writers registered in your CMS. ### Enumerate structured content collections See all content types and rules defined in your global collections. ## Use Cases ### Keyword Gap Analysis An SEO manager asks the agent to find all posts with 'startup' to see if the brand is already covered or if new content is needed. ### Front-end Debugging A developer checks why a custom page is broken by inspecting the nested JSON configuration to see how data is mapped. ### Content Categorization A writer asks for all categories to see where a new article about 'AI' should live to ensure it hits the right audience. ### Content Inventory A marketing lead pulls a list of all authors to prepare a content calendar and check who is available for upcoming projects. ## Benefits - Stop manual data exports by instantly viewing all content types and structured rules. - Speed up SEO audits by finding existing keywords in your blog posts in seconds. - Debug complex front-end issues faster by inspecting exact UI routing and page layouts. - Organize content better by mapping all taxonomy hits across your entire site. - Identify content owners quickly to streamline internal communication and assignments. - Scan your entire knowledge base for duplicates before publishing new drafts. ## How It Works The bottom line is your AI agent gets direct, real-time access to your headless CMS content for immediate use. 1. Subscribe to the ButterCMS MCP on Vinkius. 2. Paste your ButterCMS API Token into your AI client's configuration. 3. Ask your agent to find content, categories, or page layouts. ## Frequently Asked Questions **Can the ButterCMS MCP help me find specific blog posts?** Yes, it allows your AI agent to search your blog's full-text index and return specific articles based on keywords or slugs you provide. **How does the ButterCMS MCP help with SEO audits?** You can ask your agent to scan for existing keywords, check your tag distribution, and identify content gaps across your entire site instantly. **Can I use the ButterCMS MCP to see my content categories?** Absolutely. It can pull your full category tree so you can see how your content is grouped without opening your CMS dashboard. **Does the ButterCMS MCP work for custom pages?** Yes, it can inspect the internal configurations and JSON structures of your custom pages, which is very helpful for debugging front-end issues. **How do I connect ButterCMS to my AI agent?** Just subscribe to the Connector on Vinkius and paste your ButterCMS API token into your AI client's settings. From there, your agent can access your content. **Can the ButterCMS MCP help me find duplicate content?** Yes, by searching for specific keywords across your entire knowledge base, your agent can quickly identify if you've already published similar articles. **Can my AI analyze the full content of an already published article?** Absolutely. Through the generic get_post_details tool using a targeted URL slug, the agent actively retrieves the article content boundaries directly from ButterCMS, letting you check formatting errors inside the markup natively. **Does it connect out to our Custom Pages or specifically built Collections?** Yes. Beyond just basic blog articles, the agent explores specific array bounds pulling the 'list_custom_pages' endpoint isolating pure localized architectures and fields. **Will it discover writers or tags independently mapping cross-relations?** Yes! Running standard category lists returns an exact enumeration mapping taxonomy arrays straight into conversational strings. Ask the bot 'Who are our CMS authors?' and watch the results.