MCP - Model Context Protocol for Joomla!
About
A Joomla plugin providing a task-based API to manage content and connect with AI, workflow automation, and internal tools.
Details
- Author
- genr8r
- Categories
- Developer Tools
Jump to
Setup
Install MCP - Model Context Protocol for Joomla! in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/genr8r/plg_mcp
Follow the installation instructions in the repository README, then restart your MCP client.
MCP - Model Context Protocol for Joomla!
A Joomla plugin providing a task-based API to manage content and connect with AI, workflow automation, and internal tools.
MCP - Model Context Protocol for Joomla!
MCP is a lightweight, powerful system plugin for Joomla that provides aModel Context Protocol—a simple, task-based API for managing content. It acts as a streamlined bridge between your Joomla website and the modern world of AI, workflow automation, and internal tooling. Learn more atModel Context Protocol.
Joomla's built-in REST API is comprehensive, but its complexity can be a hurdle for rapid integration. Modern AI agents and workflow automation platforms thrive on simple, predictable "tools" or endpoints to perform specific actions. They need a clear protocol to interact with external data sources without requiring complex, service-specific configurations.
The Solution: MCP (Model Context Protocol)
MCP establishes a simple protocol for AI models and services to interact with your Joomla content. It provides a flat, single-endpoint API where an action is specified by ataskparameter. This design makes it incredibly easy for any application to create, update, or retrieve articles and categories—providing and receivingcontextthrough a standardized protocol.
It authenticates using Joomla's native API Token system, ensuring that all operations are secure and respect the permission levels of the user associated with the token.
- Simple Protocol:No complex RESTful routes to learn. Just one URL and ataskparameter.
- Secure:Leverages Joomla's coreWeb Services - Authentication - Tokensystem.
- Lightweight:A single plugin with no external dependencies.
- AI-Ready:Designed to serve as the perfect "tool" for AI agents and automation workflows to read from and write to your Joomla database.
- Essential Endpoints:Covers the most common content management tasks.
The AI & Workflow Automation Superpower
This is where MCP truly shines. It transforms your Joomla CMS from a siloed platform into a dynamic, integrated component of your automated workflows and AI-driven content pipelines.
For Workflow Automation (Make.com, n8n, Zapier, etc.)
Platforms likeMake.comandn8nare built around connecting services through API calls. MCP provides the perfect endpoints for their generic "HTTP Request" modules.
Example Use Case:An RSS feed triggers a workflow inn8n. An AI node rewrites the content, and then an HTTP Request node uses theModel Context Protocol(task=mcp.create_article) to instantly publish the new article to your Joomla site.
For AI Agent Frameworks (crewAI, AutoGen, etc.)
AI agents need "tools" to interact with the real world. MCP's endpoints are the perfect building blocks for these tools, allowing agents to autonomously manage content.
Example Use Case:You task acrewAIagent with "Write a blog post about the latest AI trends and publish it to our website."
- TheResearcherAgentbrowses the web.
- TheWriterAgentcomposes the article.
- ThePublisherAgentis given apublish_to_joomlatool, which uses theModel Context Protocolto call themcp.create_articleendpoint. The AI crew completes the entire task without human intervention.
For Internal Tooling & Scripting (Windmill, Superblocks, etc.)
Example Use Case:Your marketing team wants a simple dashboard inWindmillto quickly publish press releases. A developer creates a simple UI. The "Publish" button triggers a script that uses theModel Context Protocolto push the content live instantly.
- Download:Download the latestplg_system_mcp_vX.X.X.zipfile from theReleasespage.
- Install:In your Joomla Administrator panel, go toSystem->Install->Extensionsand upload the zip file.
- Enable Plugin:Go toSystem->Manage->Pluginsand search for "MCP". Enable the plugin.
- Generate a User API Token:
- Go toUsers->Manageand select the user you want to grant API access to. This user's permissions will be respected.
- Click the"Joomla API Token"tab.
- Click"Create a New Token"to generate an API key. Copy this key securely.
Note:This is Version 2.0 with consolidated API tasks and improved architecture.
- Endpoint:https://www.yoursite.com/index.php
- Method:POST
- Authentication Header:X-Joomla-Token: YOUR_JOOMLA_API_TOKEN
- Query Parameter:task=mcp.your_task
Here's how to create a new, published article in category ID8.
curl -X POST \ -H "X-Joomla-Token: YOUR_JOOMLA_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"title": "New Article via MCP", "articletext": "<p>This content was published by an automated workflow!</p>", "catid": 8, "published": true}' \ "https://www.yoursite.com/index.php?task=mcp.create_article"
Using MCP with Workflow Automation Tools
- Create an HTTP Node:- Add an HTTP Request node to your workflow.
- Set theMethodtoPOST.
- Set theURLtohttps://<your_joomla_website_url>/index.php.
- Add a query parameter:task=mcp.<your_task>(e.g.,task=mcp.create_article).
- Add a header:X-Joomla-Tokenwith the value<your_joomla_api_token>.
- Add the JSON payload for the task you want to perform (e.g., creating or updating an article).
- Create a Scenario:
- Add an HTTP module to your scenario.
- Set theMethodtoPOST.
- Set theURLtohttps://<your_joomla_website_url>/index.php.
- Add a query parameter:task=mcp.<your_task>(e.g.,task=mcp.get_article).
- Add a header:X-Joomla-Tokenwith the value<your_joomla_api_token>.
- Add the JSON payload for the task you want to perform.
- Task Consolidation:
- Themanage_article_stateandmove_article_to_trashtasks have been consolidated into theupdate_articletask. You can now update content and state in a single call.
- Use{"article_id": 123, "state": -2}to move to trash,{"article_id": 123, "state": 0}to unpublish, etc.
- Addedmcp.get_tagstask for retrieving all tags
- Addedmcp.infotask for plugin information and authentication status
- Enhanced filtering and pagination support forget_articles
- Completely refactored with organized handler classes
- Improved authentication system
- Better error handling and validation
- Streamlined JSON responses with timestamps
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Create crafted UI components inspired by the best 21st.dev design engineers.
Bring agent evaluations, observability, and synthetic test set generation directly into your IDE for free with Galileo's new MCP server
An MCP server to help AI assistants to answer questions and generate AccelByte Extend SDK code more effectively .
MCP server for AI Diagram Maker — generate beautiful software engineering diagrams directly inside Cursor, Claude Desktop, Claude Code, or any MCP-compatible AI agent
ALAPI MCP Tools,Call hundreds of API interfaces via MCP
AI-powered SVG animation generator that transforms static files into animated SVG components using the Allyson platform
MCP server that gives AI assistants on-demand access to 1,500+ amCharts docs, ~300 code examples, and 1000+ class API references.
APIMatic MCP Server is used to validate OpenAPI specifications using APIMatic. The server processes OpenAPI files and returns validation summaries by leveraging APIMatic’s API.
One shared context layer for AI agents and humans — live API specs, DB schemas, and versioned contracts across repos so every agent and teammate works from the same source of truth.
Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
