magebitcom / magento2-mcp-marketing-tools
magebitcom/magento2-mcp-marketing-tools
Promotion-domain MCP tools for Magebit_Mcp (catalog rules, cart price rules, coupons)
Magento2 MCP - Marketing Tools
This is a sub-module for the Magento2 MCP module
Promotion-domain MCP tools for Magebit_Mcp. Reads and toggles catalog
price rules and cart price rules, and manages coupon supply for
cart rules — all as MCP tools.
Each tool is a thin wrapper over a Magento service contract
(CatalogRuleRepositoryInterface, SalesRule\RuleRepositoryInterface,
CouponRepositoryInterface, CouponManagementInterface) and composes its
read responses from field resolvers that 3rd-party modules can extend.
Install
composer require magebitcom/magento2-mcp-marketing-tools
bin/magento module:enable Magebit_McpMarketingTools
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush
Tool catalog
Catalog rules (read)
| Tool | What it does |
|---|---|
marketing.catalog_rule.list |
Paginated catalog-rule search; filter by name, is_active, customer_group_id, website_id, from_date_after, to_date_before. |
marketing.catalog_rule.get |
Single catalog rule by id with full detail (identity, scope, schedule, conditions, action, lifecycle). |
Cart rules (read)
| Tool | What it does |
|---|---|
marketing.cart_rule.list |
Paginated cart-rule search; filter by name, is_active, coupon_type, customer_group_id, website_id, date range. |
marketing.cart_rule.get |
Single cart rule by id including the full condition and action_condition trees as JSON. |
Coupons (read)
| Tool | What it does |
|---|---|
marketing.cart_rule.coupon.list |
Paginated coupon search; filter by rule_id, code substring, type (MANUAL/GENERATED), is_primary, created_after. |
marketing.cart_rule.coupon.get |
Single coupon by id. |
Catalog rules (write)
Write tools require the global magebit_mcp/general/allow_writes flag and
the token's own allow_writes flag to be 1. Destructive operations
additionally set the requires_confirmation hint so MCP clients prompt
before firing.
| Tool | Confirm? | What it does |
|---|---|---|
marketing.catalog_rule.set_active |
no | Toggles is_active on the rule; storefront prices update on the next catalogrule_rule reindex. |
marketing.catalog_rule.delete |
yes | Permanently deletes a catalog rule. |
marketing.catalog_rule.apply_all |
yes | Invalidates catalogrule_rule so the next reindex pass rebuilds the catalogrule_product_* aggregation tables. Heavy on realtime indexers — run off-peak. |
Cart rules (write)
| Tool | Confirm? | What it does |
|---|---|---|
marketing.cart_rule.set_active |
no | Toggles is_active on the rule. Disabling immediately stops it applying to new carts; existing orders are unaffected. |
marketing.cart_rule.delete |
yes | Permanently deletes a cart rule and cascade-deletes its coupons via FK. Existing orders are unaffected. |
Coupons (write)
| Tool | Confirm? | What it does |
|---|---|---|
marketing.cart_rule.coupon.generate |
yes | Bulk-generates coupon codes for a cart rule. The rule must have coupon_type = SPECIFIC_COUPON and use_auto_generation = true. |
marketing.cart_rule.coupon.delete |
yes | Bulk-deletes coupons by id list or code list. Existing orders that previously used a deleted code are unaffected. |
Every write tool also implements Magebit\Mcp\Api\UnderlyingAclAwareInterface
so the handler blocks calls from admins who wouldn't be allowed to perform
the same action in the admin UI.
Extending
See docs/EXTENDING.md for:
- adding a new field to any tool response via
*FieldResolverInterface; - adding a new filter to a
listtool via*FilterTranslatorInterface; - the ACL layering rules for custom write tools.
License
Released under the MIT License.
Have questions or need help? Contact us at [email protected]
No changelog yet
The vendor hasn't published a changelog. Tagged releases appear in the Versions tab.
Requires 3
| Package | Constraint |
|---|---|
| magebitcom/magento2-mcp-module | * |
| magento/framework | ^103.0 |
| php | >=8.1 |
Compatibility
Each Magento release line is installed on its supported PHP versions, then the module is built (DI compilation + static-content deploy) and its unit and integration suites are run. The matrix shows the lines and PHP versions the module is confirmed to install and run on. Code-quality results further down (phpstan, phpcs, …) are reported separately and never affect compatibility.
Code Quality
Advisory checks against the module's source. Static analysis runs once across the whole module; PHPStan re-runs per Magento + PHP version because resolvable symbols differ between releases. These NEVER affect the Compatibility badge — a phpcs finding can't make a module incompatible.
Static analysis
Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.
| Tool | Status | Findings | Summary |
|---|---|---|---|
| PHPCS | Warning | 8 | 8 warnings (ruleset: Magento2) — 5 auto-fixable with phpcbf |
| PHPMD | Warning | 6 | 6 rule violations (CyclomaticComplexity:4, NPathComplexity:2) |
| Cpd | Warning | 2 | 2 duplicated chunks spanning 77 total lines (min-lines=5, min-tokens=70) |
| Composer validate | Info | 1 | valid; 1 advisory note (composer validate --strict) |
PHPStan
Type-checks the module's PHP against a real Magento install at the configured gate level. Re-runs per Magento and PHP version because resolvable symbols differ between releases. Cell → details modal.
Tests
Unit and integration suites, run for each applicable Magento and PHP version. A test failure speaks to the module's behaviour, not its compatibility with a Magento line, so it is reported here separately and never reddens the compatibility matrix.
Unit tests
Integration tests
| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | ||
| 2.4.8 | N/A | N/A | ||
| 2.4.9 | N/A | N/A |
Security
Security checks run directly against the module: an audit of its declared dependencies for known vulnerabilities (composer audit) and a scan of its source for malware and web-shell signatures. Each runs once. A malware detection fails the version outright.
More from magebitcom
View vendorModule documentation viewer for Magento 2 admin
This module enables Montonio Hirepurchase with Hyva Checkout
Google Analytics 4 MCP tools for Magebit_Mcp — wraps the GA Data and Admin APIs as MCP tools so AI clients can query property metadata, run reports, run realtime reports, and run funnel reports against your store's analytics property.
Magebit Klaviyo extension
Turn an existing module into recurring revenue.
If you already maintain a Magento 2 module on GitHub or GitLab, listing it on Packagento takes about five minutes. We mirror your tags, handle distribution signing, and route paid licenses through Stripe Connect, so you can keep shipping the way you already do.