Built-in tools
MCP tools are capabilities that AI clients can invoke through the MCP protocol. Each tool has a name, description, input schema, output format, and a read-only marking. Tools are filtered by the admin user's ACL permissions - the AI client can only use tools the authorizing admin has access to.
Read-only and write tools
Every tool is advertised to the AI client as either read-only or able to change store data. Some clients use this to decide whether a call needs your confirmation, and some restrict an assistant to read-only tools entirely - ChatGPT does both, see ChatGPT.
| Read-only | Can change store data |
|---|---|
| Store Info, Packages, Mirasvit Modules Info, Database Reader, Log Reader, Cron Checker, Doc Search, Manual Search, Who Am I | REST API, GraphQL Query, Cache Manager, Indexer, Media Upload |
Database Reader is read-only because it rejects anything other than SELECT, DESCRIBE, SHOW, EXPLAIN and WITH. REST API and GraphQL Query are on the right because both can reach write endpoints and mutations, whatever a given call happens to do.
The five tools that can change store data are marked read-only for a connection when every write they offer is blocked there: by the Write access setting for all five, or by the tool's own setting or permissions for Cache Manager, Indexer and Media Upload. A client that allows only read-only tools then offers them too.
The AI Agent Connector extension includes fourteen built-in tools:
📄️ Store Info
The Store Info tool returns store configuration and structure — websites, store views, currencies, and locale settings.
📄️ Database Reader
The Database Reader tool executes read-only SQL queries against the Magento database. It supports SELECT, DESCRIBE, SHOW, and EXPLAIN statements.
📄️ REST API
The REST API tool provides full access to Magento's REST API — the same endpoints available at /rest/V1/*. It supports GET, POST, PUT, and DELETE methods, as well as asynchronous and bulk operations.
📄️ GraphQL Query
The GraphQL Query tool executes queries and mutations against Magento's GraphQL API.
📄️ Doc Search
The Doc Search tool browses and searches documentation shipped with installed Magento modules. It provides the AI client with usage guides, required workflows, and common pitfalls — information that cannot be auto-discovered through REST API schemas or database structure.
📄️ 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.
📄️ Packages
The Packages tool lists the Composer packages installed on the Magento instance — one row per shippable extension. Each entry carries the Composer package name, the user-facing title, the installed version, its status, the technical modules it provides, and the other packages it requires.
📄️ Mirasvit Modules Info
The Mirasvit Modules Info tool returns every installed Mirasvit package enriched with its latest stable version (from the Mirasvit feed) and its license status (from the Mirasvit license server). One call answers questions that would otherwise require scraping each module's changelog.
📄️ Who Am I
The Who Am I tool returns the identity of the admin user that the current MCP request is authenticated as: user_id, email, firstname, and lastname.
📄️ Cache Manager
The Cache Manager tool (internal name builtinsystemcache) lists Magento cache types and their status, and can clean, flush, enable, or disable cache types. Clean and flush act immediately; enable and disable persist to app/etc/env.php.
📄️ Cron Checker
The Cron Checker tool (internal name builtinsystemcron) is a read-only diagnostic for the Magento cron scheduler. It reports overall health and per-group heartbeat, detects failing, stuck, and never-scheduled jobs, and returns bounded job run history with error messages.
📄️ Indexer
The Indexer tool (internal name builtinsystemindexer) lists Magento indexers — status, mode (Update on Save / Update by Schedule), last update, and pending backlog — and can invalidate indexers to trigger asynchronous reindexing via cron.
📄️ Log Reader
The Log Reader tool (internal name builtinsystemlogreader) inspects Magento log and report files under var/log and var/report. It can list files, tail them, grep across them, read small files, and page through a file by line range. All actions are bounded so large files are never returned in one shot.
📄️ Media Upload
The Media Upload tool (internal name builtinsystemmediaupload) puts a file into your store's media storage (pub/media) and returns its path and public URL. It can also list the files in a media directory and delete one.