Skip to main content

Manual Search

The Manual Search tool searches and browses the official Mirasvit extension manuals — installation guides, configuration instructions, troubleshooting steps, feature documentation, and per-module changelogs.

Manual Search vs. Doc Search

Doc Search returns the developer-oriented documentation that modules ship in their etc/mcp/ directory (workflows, API usage, pitfalls). Manual Search returns the end-user manuals published by Mirasvit. Use Manual Search for "how does this feature work / how do I configure it" questions, and to look up a module's changelog.

Access control

Access to this tool is controlled by the MCP Tools -> Built in -> System -> Mirasvit Manuals ACL resource. Enable or disable it in System -> Permissions -> User Roles -> [Role] -> Role Resources.


When to use

  • The AI client needs to explain a feature, setting, or behavior that is described in the user manual rather than discoverable through the API.
  • Looking up a module's changelog to see what changed between versions.
  • Finding which manual covers a given topic.

Actions

The tool has three actions:

list

Returns the catalog of available manuals (metadata only — id, title, package, section count).

ParameterDescriptionTypeRequired
actionSet to liststringYes
queryFilter manual titles by substring (case-insensitive). Useful when you remember part of a product name.stringNo

get

Fetches a manual's table of contents, or the full markdown body of one section.

ParameterDescriptionTypeRequired
actionSet to getstringYes
manualManual route (e.g. magento-2-advanced-reports).stringYes
sectionSection id (e.g. changelog, getting-started/installation, how-to/custom-report). Omit to get the manual's TOC.stringNo

Runs full-text search across section contents and returns matching snippets ranked by relevance.

ParameterDescriptionTypeRequired
actionSet to searchstringYes
queryKeywords or phrase to match against section contents.stringYes
manualLimit the search to a single manual (optional scope filter).stringNo
limitMaximum number of results (default 10, max 30).integerNo

  1. search — find relevant sections by keyword across all manuals.
  2. get with manual only — retrieve the TOC to understand the manual's structure.
  3. get with manual and section — read the specific section.

To read a module's changelog, call get with the manual route and section=changelog.