# Joomla CMS MCP > Joomla CMS MCP lets you manage an entire website's content structure using natural conversation. List, create, and update articles; audit site menus, categories, and users—all without logging into the admin backend. It’s full control over your digital publishing lifecycle. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** cms, article-management, taxonomy, web-publishing, content-orchestration ## Description Forget navigating endless dashboards just to publish a small change. This MCP connects your Joomla website directly to your agent, letting you manage content creation and site structure using plain language. You can draft an article with a specific title and intro text, or pull up a list of every existing piece of content. Need to clean house? Delete old articles or update banners in minutes. Beyond the core articles, you get full visibility into how your site is built: check the user roles, see what global categories are active, or audit the entire menu hierarchy. This level of deep content control is critical for any modern web presence, and having it accessible through a central catalog like Vinkius makes running multi-site operations simple. ## Tools ### create_cms_article Generates a brand new Joomla article using specified title, alias, category ID, and intro text. ### delete_cms_article Removes an existing Joomla article permanently from the site content. ### get_article_details Retrieves all specific information about a single, identified Joomla article. ### list_site_articles Fetches a list of articles from the site; you can filter this list using parameters like state status. ### list_active_banners Lists all advertising banners and tracking modules currently running on the website. ### list_global_categories Provides a list of all main content categories defined across the entire Joomla instance. ### list_site_menus Retrieves and displays the current structure of the site's navigation menus. ### list_system_tags Gives you a comprehensive list of all system tags applied to content. ### list_platform_users Lists every registered user account on the platform and their assigned roles. ### patch_cms_article Updates all details of an existing Joomla article, allowing you to revise its content or metadata. ## Prompt Examples **Prompt:** ``` List the last 5 articles from my Joomla site ``` **Response:** ``` I've retrieved the latest 5 articles. Highlights include 'Getting Started with Joomla 5' (ID: 101), '2024 Tech Trends' (ID: 105), and 'Product Launch Update' (ID: 108). All are currently published. Would you like the full text for any of these? ``` **Prompt:** ``` Create a new article titled 'AI in CMS' in the 'Technology' category (ID: 5) ``` **Response:** ``` Article 'AI in CMS' created successfully in the Technology category. Alias: ai-in-cms. I've added the placeholder introtext you provided. You can now use the `patch_cms_article` tool to finalize the full HTML content. ``` **Prompt:** ``` What are the active categories on our site? ``` **Response:** ``` I've identified 4 active categories: 'Uncategorised' (ID: 1), 'News' (ID: 2), 'Blog' (ID: 3), and 'Technology' (ID: 5). I can provide the description and parent mapping for any of these if needed. ``` ## Capabilities ### Drafting new articles You can generate brand new Joomla articles by providing the title, alias, category ID, and initial intro text. ### Updating existing content Modify the full HTML body of any specific article or patch details on an already published piece of content. ### Managing site organization List and manage global categories, system tags, and check the structure of all active site menus. ### Auditing user and asset data Pull lists of all registered users or enumerate any active advertising banners currently running on the site. ### Controlling content lifespan Permanently delete old articles from the CMS, keeping your digital storefront fresh and optimized. ## Use Cases ### The team needs to update a product page but is locked out of the admin panel. A marketing editor asks their agent, 'Update the main features article for Product X.' The agent uses `patch_cms_article` and updates the full HTML content in real time. No logins, no clicking through menus. ### The developer needs to map out the entire site navigation before building a new section. A web developer asks their agent to 'list all main menu structures.' The agent runs `list_site_menus`, providing an immediate, structured view of the current navigation hierarchy for testing. ### The administrator needs to see who has publishing rights and what they are doing. An admin asks the agent to 'show all user roles.' The agent calls `list_platform_users`, giving a clear, actionable list of every registered account and its permissions. ### The content lead needs to see what articles exist in a specific topic area. The lead asks the agent to 'list all published articles for tech news.' The agent uses `list_site_articles`, filtering results immediately and providing a list of IDs ready for review. ## Benefits - Write new content quickly. Instead of manually navigating to the editor, you simply ask your agent to use `create_cms_article`, specifying the title and category, and it handles the draft. - Maintain site accuracy by auditing everything. Use `list_site_menus` or `list_global_categories` to check if a new page needs a taxonomy tag or a menu link before development starts. - Keep your content fresh and clean. When an article is obsolete, use `delete_cms_article`. You can manage the entire lifecycle of publishing from one chat window. - Understand who has access. If you need to audit team permissions, run `list_platform_users` to see every registered account and their roles instantly. - Check site visibility at a glance. Use `list_active_banners` to confirm what promotional modules are currently live on the front end. ## How It Works The bottom line is that this MCP turns complex website administration tasks into simple conversational commands for your agent to run. 1. First, subscribe to this MCP on Vinkius. 2. Next, you input your Joomla Base URL and API Token credentials into your AI client. 3. Finally, you tell your agent what content task needs doing—like 'list all articles in the Technology category'—and it executes the action. ## Frequently Asked Questions **How do I list all articles using the Joomla CMS MCP?** You use the `list_site_articles` tool. This lets your agent pull a full inventory of published content, and you can optionally narrow down the search with status filters. **Can I delete old articles using the Joomla CMS MCP?** Yes, the `delete_cms_article` tool handles this. You just need to specify the article ID, and your agent executes the permanent deletion for you. **How do I check my site's navigation menus with Joomla CMS MCP?** Run `list_site_menus`. This tool gives you a complete overview of every menu structure on your website, helping developers audit the current layout easily. **Does the Joomla CMS MCP help me create articles?** Absolutely. Use `create_cms_article` to draft brand new content by providing the title, alias, category ID, and intro text in one prompt. **Where can I see who uses my Joomla site with the MCP?** The `list_platform_users` tool lets you pull a list of all registered user accounts and their corresponding roles on your Joomla instance.