# magebitcom/magento2-mcp-module > Magento 2 MCP (Model Context Protocol) server module `composer require magebitcom/magento2-mcp-module` Canonical URL: https://packagento.com/magebitcom/magento2-mcp-module ## At a glance - **Vendor**: magebitcom (https://packagento.com/magebitcom.md) - **Latest version**: v1.0.4 — released 2026-06-12 - **Pricing**: Free - **Package type**: Magento 2 module - **Status**: active, accepting new buyers ## Installation Packagento is licence-gated, so even free packages need a licence on a project before Composer can resolve them. 1. **Sign in or create an account** at https://packagento.com/customer/account/. 2. **Add the package to your account.** Open https://packagento.com/magebitcom/magento2-mcp-module and complete the free checkout. A licence is minted automatically. 3. **Create or pick a project, then activate the licence on it.** - Projects represent the Magento installs you deploy to. Manage them at https://packagento.com/projects/. - Activate the new licence on the project you'll deploy this package to. Activation is what generates the Composer credentials scoped to that project. 4. **Add the project credentials to your Magento codebase.** Grab the project's public + private key from https://packagento.com/projects/ (open the project, then its Credentials tab), and add them to `auth.json`: ```json { "http-basic": { "packagento.com": { "username": "ppk_live_...", "password": "psk_live_..." } } } ``` Add the Packagento Composer repository to `composer.json`: ```json { "repositories": [ { "type": "composer", "url": "https://packagento.com" } ] } ``` 5. **Install and apply.** ```bash composer require magebitcom/magento2-mcp-module:* bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flush ``` ## What it does Magento 2 MCP (Model Context Protocol) server module ## README

Sample MCP session: an operator asks why a customer's order hasn't arrived; the AI calls three MCP tools and reports the order status, shipment progress, and customer history.

## Magento 2 MCP module Extensible [Model Context Protocol](https://modelcontextprotocol.io/specification/2025-06-18) server for Magento 2. Connect your store to any MCP-compatible AI agent — read and mutate customer, product, CMS or sales data, fetch reports, manage configuration, and more. The base module ships the transport, authentication, ACL, audit log, and tool registry, plus a small set of system tools for inspecting and refreshing the store. Domain-specific functionality lives in optional sub-modules listed below — you can also write your own. ### Contents - [What the base module gives you](#what-the-base-module-gives-you) - [Quick start](#quick-start) - [Installation](#installation) - [Sub-modules](#sub-modules) - [Order module — `Magebit_McpOrderTools`](#order-module--magebit_mcpordertools) - [Catalog module — `Magebit_McpCatalogTools`](#catalog-module--magebit_mcpcatalogtools) - [Customer module — `Magebit_McpCustomerTools`](#customer-module--magebit_mcpcustomertools) - [CMS module — `Magebit_McpCmsTools`](#cms-module--magebit_mcpcmstools) - [Marketing module — `Magebit_McpMarketingTools`](#marketing-module--magebit_mcpmarketingtools) - [Report module — `Magebit_McpReportTools`](#report-module--magebit_mcpreporttools) - [Google Analytics module — `Magebit_McpGoogleAnalyticsTools`](#google-analytics-module--magebit_mcpgoogleanalyticstools) - [Setup](#setup) - [Connecting an AI agent](#connecting-an-ai-agent) - [Bearer token](#bearer-token) - [OAuth 2.1](#oauth-21) - [Security](#security) - [Extending](#extending) - [Contributing](#contributing) ### What the base module gives you - A `POST /mcp` JSON-RPC endpoint with bearer-token and OAuth 2.1 authentication - Per-tool admin-role ACL and a two-layer write kill-switch - A PII-redacting audit log with configurable retention - Per-(admin, tool) rate limiting - An origin allowlist with sensible defaults for major AI clients - Core tools for cache types, indexers, store views, system configuration values and admin notifications - MCP prompt support (see examples in [Prompt/System](Prompt/System/) directory) ### Quick start The fastest path from `composer require` to a connected AI is the interactive **[Quick Setup guide](https://magebitcom.github.io/magento2-mcp-module/quick-setup/)** — pick which AI you're using (Claude, ChatGPT, Cursor, Claude Code, or anything else MCP-compatible) and follow the per-client steps with copy-paste snippets and admin-screen screenshots. Not connecting? The **[Connection Checker](https://magebitcom.github.io/magento2-mcp-module/quick-setup/diagnose.html)** probes your store's MCP endpoints from the browser and flags redirects, unreachable hosts and base-URL mismatches; the **[MCP Inspector guide](https://magebitcom.github.io/magento2-mcp-module/quick-setup/inspector.html)** walks you through verifying the OAuth sign-in and bearer-token access end to end. For the long-form reference — every admin setting, the OAuth and bearer-token flows in detail, and the full tool catalog — see the [Wiki](https://github.com/magebitcom/magento2-mcp-module/wiki). ### Installation ```bash composer require magebitcom/magento2-mcp-module bin/magento module:enable Magebit_Mcp bin/magento setup:upgrade ``` ### Sub-modules Each sub-module is published independently and depends on `Magebit_Mcp`. Install only the ones you need. After every `composer require` below, enable and rebuild Magento with: ```bash bin/magento module:enable Magebit_McpTools bin/magento setup:upgrade ``` #### Order module — [`Magebit_McpOrderTools`](https://github.com/magebitcom/magento2-mcp-order-tools) - Read and search orders, invoices, shipments, payments, order comments and credit memos - Create invoices, shipments, shipment tracks, credit memos and order comments - Cancel, hold or unhold orders ```bash composer require magebitcom/magento2-mcp-order-tools ``` #### Catalog module — [`Magebit_McpCatalogTools`](https://github.com/magebitcom/magento2-mcp-catalog-tools) - Read and search products and categories - Create, update or delete products - Create, update or delete categories ```bash composer require magebitcom/magento2-mcp-catalog-tools ``` #### Customer module — [`Magebit_McpCustomerTools`](https://github.com/magebitcom/magento2-mcp-customer-tools) - Read or search customers, addresses and customer groups - Fetch customer confirmation status - Create, update or delete customers and addresses - Trigger password reset or resend confirmation ```bash composer require magebitcom/magento2-mcp-customer-tools ``` #### CMS module — [`Magebit_McpCmsTools`](https://github.com/magebitcom/magento2-mcp-cms-tools) - Read or search CMS pages and blocks - Create, update or delete CMS pages and blocks ```bash composer require magebitcom/magento2-mcp-cms-tools ``` #### Marketing module — [`Magebit_McpMarketingTools`](https://github.com/magebitcom/magento2-mcp-marketing-tools) - Read or search catalog rules, cart rules and coupons - Delete, toggle and apply catalog and cart rules - Generate or delete coupon codes ```bash composer require magebitcom/magento2-mcp-marketing-tools ``` _(README truncated for .md surface. Full README on https://packagento.com/magebitcom/magento2-mcp-module.)_ ## Recent Versions | Version | Released | |---|---| | v1.0.4 | 2026-06-12 | | 1.0.3 | 2026-05-29 | | 1.0.2 | 2026-05-28 | | 1.0.1 | 2026-05-27 | | 1.0.0 | 2026-05-27 | | 0.0.3 | 2026-05-12 | | 0.0.2 | 2026-05-11 | | 0.0.1 | 2026-05-11 | ## Dependencies ### Require | Package | Constraint | |---|---| | magebitcom/magento2-core | * | | magento/framework | ^103.0 | | opis/json-schema | ^2.3 | | php | >=8.1 | ### Suggest | Package | Constraint | |---|---| | magebitcom/magento2-mcp-catalog-tools | Sub-module for catalog-related MCP tools | | magebitcom/magento2-mcp-cms-tools | Sub-module for CMS-related MCP tools | | magebitcom/magento2-mcp-customer-tools | Sub-module for customer-related MCP tools | | magebitcom/magento2-mcp-marketing-tools | Sub-module for marketing-related MCP tools | | magebitcom/magento2-mcp-order-tools | Sub-module for order-related MCP tools | | magebitcom/magento2-mcp-report-tools | Sub-module for reporting-related MCP tools | ## Licence and pricing Free. A licence is still minted on checkout and bound to your project for Composer access — no payment step. Refundable within 14 days of first purchase via https://packagento.com/account/refunds/. ## Install via Claude Code or any MCP client The Packagento MCP server can run the licence + project + Composer steps above in one tool call: ``` purchase_and_install_packages( composer_names=["magebitcom/magento2-mcp-module"], project_id="proj_xxx" ) ``` This handles cart, checkout, licence minting, project activation, and writes auth.json credentials. Connect a client with `claude mcp add packagento https://mcp.packagento.com`. Full setup at https://packagento.com/docs/mcp-setup. ## Vendor magebitcom is a Magento 2 vendor on Packagento. See https://packagento.com/magebitcom.md for their full catalogue.