PHPackages                             adwise/magento2-mcp - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. adwise/magento2-mcp

ActiveMagento2-module[API Development](/categories/api)

adwise/magento2-mcp
===================

A lightweight Magento MCP (Model Context Protocol) server.

1.0.0(1mo ago)132MITPHPPHP >=8.1

Since Jul 3Pushed 1mo agoCompare

[ Source](https://github.com/adwise/magento2-mcp)[ Packagist](https://packagist.org/packages/adwise/magento2-mcp)[ RSS](/packages/adwise-magento2-mcp/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (3)Versions (2)Used By (2)

[ ![Adwise](https://camo.githubusercontent.com/6e34ac1e9f24185882f5545ff8c10f3349fe3601d1164671a3b271835344645c/68747470733a2f2f63646e2e6164776973652e6e6c2f686f737465645f66696c65732f6769746875622f6c6f676f2e77656270 "Adwise")](https://www.adwise.nl/)Adwise\_Mcp
===========

[](#adwise_mcp)

A lightweight Magento MCP (Model Context Protocol) server.

Installation
------------

[](#installation)

```
composer require adwise/magento2-mcp
bin/magento module:enable Adwise_Mcp
bin/magento setup:upgrade
```

stdio transport
---------------

[](#stdio-transport)

From the Magento project root:

```
vendor/bin/magento-mcp
```

For a local MCP client, configure the command as `ddev` with arguments:

```
{
  "mcpServers": {
    "magento": {
      "command": "ddev",
      "args": ["exec", "php", "vendor/bin/magento-mcp"]
    }
  }
}
```

SSE transport
-------------

[](#sse-transport)

The server is also available over SSE:

```
GET  /mcp/sse
POST /mcp/message?session=

```

Authentication uses bearer tokens. Send the token with either:

```
Authorization: Bearer
```

or, for clients that cannot set SSE headers:

```
/mcp/sse?access_token=

```

The token owner must have the ACL resource `Adwise_Mcp::mcp` (`System > Adwise Magento MCP`). Integration tokens also need this resource granted in the integration API permissions.

### MCP OAuth discovery and browser login

[](#mcp-oauth-discovery-and-browser-login)

The SSE endpoint returns a `WWW-Authenticate` header with a protected resource metadata URL when no token is supplied. Metadata endpoints:

```
GET  /.well-known/oauth-protected-resource
GET  /.well-known/oauth-authorization-server
GET  /mcp/oauth/protectedresource
GET  /mcp/oauth/metadata
POST /mcp/oauth/register
POST /mcp/oauth/token

```

The OAuth authorization endpoint returned by metadata is an adminhtml URL. MCP clients can open it in the browser. Magento will require admin login and the `Adwise_Mcp::mcp` ACL, then redirect back with an authorization code. The token endpoint exchanges the code for a Magento admin bearer token. Authorization code + PKCE (`S256` or `plain`) is supported.

Included tools
--------------

[](#included-tools)

- `magento_info` - Magento name, edition, version, and mode.
- `module_status` - List modules or inspect a single module.
- `config_get` - Read config values by path and scope.
- `cache` - Read cache status, clean cache, or flush cache.
- `indexer_status` - List indexer statuses or inspect a single indexer.

Add a tool
----------

[](#add-a-tool)

1. Create a class implementing `Adwise\Mcp\Api\ToolInterface`.
2. Register it in `etc/di.xml` under `Adwise\Mcp\Model\Mcp\JsonRpcServer`'s `tools` argument.
3. Run `bin/magento setup:di:compile` if generated DI is in use.

Tool results can return any JSON-serializable data. The server wraps that data in an MCP text content response.

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance90

Actively maintained with recent releases

Popularity5

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

49d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/11959987?v=4)[Adwise - Your Digital Brain](/maintainers/adwise)[@adwise](https://github.com/adwise)

---

Top Contributors

[![npluimers](https://avatars.githubusercontent.com/u/72264931?v=4)](https://github.com/npluimers "npluimers (2 commits)")

### Embed Badge

![Health badge](/badges/adwise-magento2-mcp/health.svg)

```
[![Health](https://phpackages.com/badges/adwise-magento2-mcp/health.svg)](https://phpackages.com/packages/adwise-magento2-mcp)
```

###  Alternatives

[smile/elasticsuite

Magento 2 merchandising and search engine built on ElasticSearch

8034.8M53](/packages/smile-elasticsuite)[mollie/magento2

Mollie Payment Module for Magento 2

1142.0M17](/packages/mollie-magento2)[elgentos/module-prismicio

Magento 2 - Prismic.io integration

39121.1k4](/packages/elgentos-module-prismicio)[dotdigital/dotdigital-magento2-extension

Dotdigital for Magento 2

50406.2k23](/packages/dotdigital-dotdigital-magento2-extension)[loki/magento2-components

Core module for defining Alpine.js components with advanced AJAX features

1015.1k29](/packages/loki-magento2-components)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)