n98-magerun2 v9.3.0

Published by Christian Münch on February 2, 2026February 2, 2026

We are excited to announce the release of n98-magerun2 v9.3.0 (Codename Heidelberg). This version introduces a major leap in how you can interact with your Magento 2 environments by integrating with the Model Context Protocol (MCP), alongside critical security fixes for our update process and third-party dependencies.

What’s New?

New Command: mcp:server:start

The headline feature of this release is the introduction of the MCP server command. The Model Context Protocol is an open standard that enables AI assistants (like Claude, Gemini, or Cursor) to securely interact with local tools and data.

With the new magerun:mcp:server command, you can now connect your Magento development environment directly to AI-powered IDEs. This allows an AI agent to perform tasks such as:

• Flushing caches and checking system status.
• Listing and searching store configurations.
• Identifying DI preferences and module information.

Important Note: Please be aware that the MCP server integration is currently experimental. We advise users to be careful when utilizing this feature in sensitive environments.

Usage Example:

To start the MCP server for your AI agent to consume:

Bash

./n98-magerun2.phar magerun:mcp:server

Improvements & Security Fixes

• Critical PsySH Security Update: We have updated psysh to the latest version to address a significant security advisory (GHSA-4486-gxhx-5mg7). This vulnerability involved a potential path traversal issue when interacting with specific command histories.
• Fixed Signature Verification: We fixed the documentation examples of the signature check after a download (#1885). Thanks Damien Retzinger for reporting this.
• Psysh Test Stability: Fixed test failures related to psysh by updating the dependency and disabling color auto-detection in specific environments.
• Dev Stack Updates: We have updated the internal ddev MariaDB version and bumped several 3rd party dependencies, including phpstan, twig, and fakerphp, to their latest stable versions. We also added a first internal AI skill for releases.

Full Changelog

• Add: MCP server command
• Fix: #1885: Correct signature check after download
• Fix: Resolve psysh test failures (update psysh, disable color auto-detection)
• Docs: Add documentation for MCP server command
• Build: Update dependencies (phpstan, php-cs-fixer, captainhook, twig/twig, qs, lodash, mcp/sdk, super-linter, composer group, Appleboy SSH action)
• Build: Update ddev MariaDB version

How to Update

As always, the easiest way to update is via the built-in self-update command:

Bash

./n98-magerun2.phar self-update

We are eager to hear how you use the new MCP integration in your daily workflow. Does it change how you debug Magento 2? Let us know in the comments or open a discussion on GitHub!