The JoomShopping MCP (Model Context Protocol) server allows AI assistants such as Claude to interact with JoomShopping websites via the Joomla Web Services API. It provides tools for managing the store using an AI assistant.
Important: This is an
alpha version and is intended
for testing purposes only.
Features
Retrieve all products
List all categories
List all manufacturers
Create, edit, delete
Requirements
PHP 8.0+
Joomla 4.x, 5.x, 6.x with the Web Services API plugin enabled
JoomShopping 5.9.0+ with the
Web Services REST API add-on
API Bearer token for authentication
Installation
Creating a Joomla API Token
Access user profile: Log in to the Joomla administrator panel and go to the “Users” menu, then select “Manage.”
Edit super user: Find and click the super user account (or the required user) to edit the profile.
Generate token: Go to the “Joomla API Tokens” tab, click “Generate,” and copy the displayed token.
Install the server locally
For example, use the folder: H:\joomshopping-mcp
Installing on Claude or other AI assistants
Method 1 — via command (Windows)
claude mcp add --transport stdio joomshopping --env BASE_URL=http://websiteur.. --env API_TOKEN=Joomla-API-Token -- cmd /c php.exe H:/joomshopping-mcp/server.php
Method 2 — directly in the config file
The config file is located at `~/.claude.json` (Claude Code) or `claude_desktop_config.json` (Claude Desktop). Open it and add the following to the `mcpServers` section:
~/.claude.json
{
"mcpServers": {
"joomshopping": {
"type": "stdio",
"command": "C:\\OSPanel\\modules\\PHP-8.3\\PHP\\php.exe",
"args": [
"H:\\joomshopping-mcp\\server.php"
],
"env": {
"BASE_URL": "http://site.com",
"API_TOKEN": "JOOMLA TOKEN"
}
}
}
}