Site & system
The Site plugin provides site introspection and maintenance: general information, page rendering, caching and inventory.
Most of these tools are read-only / introspection tools and require no special permissions. Cache tools, however, require the permission indicated for the relevant component.
Site information
Get a snapshot of the site (name, URL, languages, active template, versions).
| Tool | Function | Required permissions (ACL) |
|---|---|---|
get_site_info | General site information | None (read-only) |
Page rendering
Retrieve the rendered output of a page as seen by an anonymous visitor.
| Tool | Function | Required permissions (ACL) |
|---|---|---|
get_rendered_page | Status, title and text of a front-end page | None (read-only) |
Cache
Clear and rebuild Joomla and JCH Optimize caches. JCH tools only appear if the JCH Optimize component is installed and enabled on the site.
| Tool | Function | Required permissions (ACL) |
|---|---|---|
clear_cache | Clear the Joomla cache (a specific group or the main caches) | Admin access — core.manage (com_cache) |
clear_jch_cache | Clear the JCH cache (combined files, Page Cache, Cloudflare); rebuild: true triggers a rebuild afterwards | Admin access — core.manage (com_cache) |
rebuild_jch_cache | Rebuild the JCH cache (recache); crawl_limit optional | Admin access — core.manage (com_cache) |
set_jch_cache_state | Enable / disable JCH (the two system plugins, optimisation and Page Cache) | Admin access + Edit State — core.manage + core.edit.state (com_plugins) |
What you need to know about JCH Optimize
Prerequisites. Clearing the cache works with all JCH editions. Rebuilding (recaching) is a feature of JCH Optimize Pro. JCH's two system plugins (JCH Optimize and JCH Page Cache) must be enabled: clear_jch_cache and rebuild_jch_cache report their status in jch_plugins and return a warning if either one is disabled. The assistant should enable them first with set_jch_cache_state.
How the rebuild works. rebuild_jch_cache triggers JCH's own mechanism, the one behind the “Rebuild Cache” button in its administration interface: a signed request to the site's recache endpoint, which responds immediately and then crawls the pages in the background. The tool reads JCH's response and returns it:
started: true,method: web-async-ping,http_status: 202— the rebuild has been accepted and is running on the site. Allow anything from a few seconds to a few minutes, depending on the number of pages and the crawl limit configured in JCH.started: false,http_status: 409— a rebuild is already in progress (JCH lock). Wait for it to finish before trying again.- Any other case (signature rejected, endpoint unavailable) — the tool falls back to the command line (
method: cli-background, requiring the Console - JCH Optimize plugin and theexecfunction on the hosting platform) and reports inweb_pingwhat the site returned. As a last resort, it returns the command to run (cli_command) and a ready-to-use cron line.
Supported JCH versions. The tools follow changes in JCH Optimize, including version 9.4.2, which changed the signature of its recache endpoint (single-use nonce) and how the Pro edition is identified. Since Senso MCP 1.2.13, the tool directly reuses the JCH classes available on the site to sign the request and detect the edition, while retaining the old mechanism for earlier versions. If rebuild_jch_cache returns “requires JCH Optimize Pro” on a Pro site, or returns started: true without anything being rebuilt, update Senso MCP.
Server load. The rebuild crawls the site using several simultaneous requests (JCH's “recache concurrency” option). If this value reaches the maximum number of PHP processes available on your hosting platform, visitors will have to wait while the crawl runs: set it lower (5 is a safe value).
Inventory
Find out what is installed and configured on the site.
| Tool | Function | Required permissions (ACL) |
|---|---|---|
list_installed_components | Enabled site components | None (read-only) |
list_installed_languages | Installed language packs | None (read-only) |
list_access_levels | Access levels (Public, Registered, …) | None (read-only) |
Prompt examples
“Give me the general site information.”
“Clear the site cache.”
“Clear the JCH cache, then rebuild it, and tell me whether JCH accepted the rebuild.”
“List the installed components and available languages.”