PHPackages                             magebitcom/magento2-mcp-marketing-tools - 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. [Utility & Helpers](/categories/utility)
4. /
5. magebitcom/magento2-mcp-marketing-tools

ActiveMagento2-module[Utility & Helpers](/categories/utility)

magebitcom/magento2-mcp-marketing-tools
=======================================

Promotion-domain MCP tools for Magebit\_Mcp (catalog rules, cart price rules, coupons)

v1.0.0(1mo ago)0366↑47.6%1MITPHPPHP >=8.1

Since May 6Pushed 1mo agoCompare

[ Source](https://github.com/magebitcom/magento2-mcp-marketing-tools)[ Packagist](https://packagist.org/packages/magebitcom/magento2-mcp-marketing-tools)[ RSS](/packages/magebitcom-magento2-mcp-marketing-tools/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (2)Dependencies (2)Versions (4)Used By (0)

Magento2 MCP - Marketing Tools
==============================

[](#magento2-mcp---marketing-tools)

This is a sub-module for the [Magento2 MCP module](https://github.com/magebitcom/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
-------

[](#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
------------

[](#tool-catalog)

### Catalog rules (read)

[](#catalog-rules-read)

ToolWhat 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)

[](#cart-rules-read)

ToolWhat 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)

[](#coupons-read)

ToolWhat 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)

[](#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.

ToolConfirm?What it does`marketing.catalog_rule.set_active`noToggles `is_active` on the rule; storefront prices update on the next `catalogrule_rule` reindex.`marketing.catalog_rule.delete`yesPermanently deletes a catalog rule.`marketing.catalog_rule.apply_all`yesInvalidates `catalogrule_rule` so the next reindex pass rebuilds the `catalogrule_product_*` aggregation tables. **Heavy** on `realtime` indexers — run off-peak.### Cart rules (write)

[](#cart-rules-write)

ToolConfirm?What it does`marketing.cart_rule.set_active`noToggles `is_active` on the rule. Disabling immediately stops it applying to new carts; existing orders are unaffected.`marketing.cart_rule.delete`yesPermanently deletes a cart rule and cascade-deletes its coupons via FK. Existing orders are unaffected.### Coupons (write)

[](#coupons-write)

ToolConfirm?What it does`marketing.cart_rule.coupon.generate`yesBulk-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`yesBulk-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
---------

[](#extending)

See `docs/EXTENDING.md` for:

- adding a new field to any tool response via `*FieldResolverInterface`;
- adding a new filter to a `list` tool via `*FilterTranslatorInterface`;
- the ACL layering rules for custom write tools.

License
-------

[](#license)

Released under the [MIT License](LICENSE).

---

[![magebit (1)](https://private-user-images.githubusercontent.com/58505474/416166496-cdc904ce-e839-40a0-a86f-792f7ab7961f.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODIzOTA0ODEsIm5iZiI6MTc4MjM5MDE4MSwicGF0aCI6Ii81ODUwNTQ3NC80MTYxNjY0OTYtY2RjOTA0Y2UtZTgzOS00MGEwLWE4NmYtNzkyZjdhYjc5NjFmLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjUlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI1VDEyMjMwMVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWM4Nzg5MTJlNmNmNWVjY2E0YjQ3ZmE5YTA5NjQ0NDM2NzFiMmYxY2ZmNWIxMjM3NDUzZWYzYTYxMGU0ZTJlNzYmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.jn6f3bVb7zO0cEVapC_BwX5KxkBMsj-AmQe59bZP3bY)](https://private-user-images.githubusercontent.com/58505474/416166496-cdc904ce-e839-40a0-a86f-792f7ab7961f.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODIzOTA0ODEsIm5iZiI6MTc4MjM5MDE4MSwicGF0aCI6Ii81ODUwNTQ3NC80MTYxNjY0OTYtY2RjOTA0Y2UtZTgzOS00MGEwLWE4NmYtNzkyZjdhYjc5NjFmLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjUlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI1VDEyMjMwMVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWM4Nzg5MTJlNmNmNWVjY2E0YjQ3ZmE5YTA5NjQ0NDM2NzFiMmYxY2ZmNWIxMjM3NDUzZWYzYTYxMGU0ZTJlNzYmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.jn6f3bVb7zO0cEVapC_BwX5KxkBMsj-AmQe59bZP3bY)

*Have questions or need help? Contact us at *

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance88

Actively maintained with recent releases

Popularity18

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity45

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

Every ~20 days

Total

2

Last Release

59d ago

Major Versions

v0.0.1 → v1.0.02026-05-27

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/10514036?v=4)[magebit](/maintainers/magebit)[@Magebit](https://github.com/Magebit)

---

Top Contributors

[![KristofersOzolinsMagebit](https://avatars.githubusercontent.com/u/58505474?v=4)](https://github.com/KristofersOzolinsMagebit "KristofersOzolinsMagebit (6 commits)")

### Embed Badge

![Health badge](/badges/magebitcom-magento2-mcp-marketing-tools/health.svg)

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

###  Alternatives

[nosto/module-nostotagging

Increase your conversion rate and average order value by delivering your customers personalized product recommendations throughout their shopping journey.

27703.7k4](/packages/nosto-module-nostotagging)[myparcelnl/magento

A Magento 2 module that creates MyParcel labels

1860.2k](/packages/myparcelnl-magento)[loki/magento2-components

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

1011.8k26](/packages/loki-magento2-components)[mage-os/module-llm-txt

AI-powered LLMs.txt generation for Magento 2 / Mage-OS stores. Help AI systems understand your store with OpenAI-generated content.

234.4k](/packages/mage-os-module-llm-txt)[mage-os/module-rma

Return Merchandise Authorization

214.0k](/packages/mage-os-module-rma)[zwernemann/module-withdrawal

Magento 2 EU Withdrawal Button Module - Adds a withdrawal/revocation button for orders in compliance with EU Directive (EU) 2023/2673

256.0k2](/packages/zwernemann-module-withdrawal)

PHPackages © 2026

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