PHPackages                             magebitcom/magento2-mcp-catalog-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-catalog-tools

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

magebitcom/magento2-mcp-catalog-tools
=====================================

Catalog-domain MCP tools for Magebit\_Mcp (read + write over products and categories)

v1.0.0(1w ago)0129↓16.7%MITPHPPHP >=8.1

Since May 6Pushed 1w agoCompare

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

READMEChangelog (3)Dependencies (2)Versions (6)Used By (0)

Magento2 MCP - Catalog Tools
============================

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

This is a sub-module for the [Magento2 MCP module](https://github.com/magebitcom/magento2-mcp-module)

---

Catalog-domain MCP tools for `Magebit_Mcp`. Exposes catalog **products** and **categories** — paginated reads, single-entity reads with field-resolver-driven shape, and writes (create / update / delete) wired through Magento service contracts.

Each tool is a thin wrapper over the corresponding Magento service contract (`ProductRepositoryInterface`, `CategoryRepositoryInterface`, `CategoryListInterface`, `StockRegistryInterface`, `CategoryManagementInterface`). Read responses are composed from field resolvers that 3rd-party modules can extend; writes go through the same repositories the admin UI uses, so server-side validation and reindex hooks fire identically.

Install
-------

[](#install)

```
composer require magebitcom/magento2-mcp-catalog-tools
bin/magento module:enable Magebit_McpCatalogTools
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush
```

Tool catalog
------------

[](#tool-catalog)

### Products (read)

[](#products-read)

ToolWhat it does`catalog.product.list`Paginated product search; filter by sku (exact / `*glob*` / array), name substring, status, visibility, type\_id, attribute\_set\_id, price range, qty range, category\_id, website\_id, created\_at range, updated\_at range.`catalog.product.get`Single product by numeric id or SKU. Default response includes identity, state, pricing, tier prices, stock, categories (ids + names), websites, media gallery, links, configurable / bundle option metadata, custom attributes, and timestamps; narrow with `fields` / `exclude`.### Categories (read)

[](#categories-read)

ToolWhat it does`catalog.category.list`Paginated category search; filter by name substring, is\_active, include\_in\_menu, parent\_id, level range.`catalog.category.get`Single category by numeric id; tree metadata, content, meta, state, plus the product ids assigned to the category (drop with `exclude: ["products"]`).### Products (write)

[](#products-write)

Write tools require the global `magebit_mcp/general/allow_writes` flag **and**the token's own `allow_writes` flag to be `1`. All writes require explicit confirmation so MCP clients prompt before firing.

ToolConfirm?What it does`catalog.product.create`yesCreate a product. Required: sku, name, price, attribute\_set\_id, type\_id, status, visibility (plus weight for physical types). Accepts top-level scalars (description, url\_key, tax\_class\_id, meta\_\*) plus `custom_attributes`, `website_ids`, `category_ids`.`catalog.product.update`yesPATCH-style update by id or sku; only fields you provide are touched. Use `new_sku` to rename.`catalog.product.delete`yesPermanently delete a product.### Categories (write)

[](#categories-write)

ToolConfirm?What it does`catalog.category.create`yesCreate a category under an existing parent.`catalog.category.update`yesPATCH-style update by id. Changing `parent_id` triggers a tree move via `CategoryManagementInterface::move()` (path / level rebuild); use `after_id` to control sibling ordering at the destination.`catalog.category.delete`yesPermanently delete a category and its descendants. Cascades.Every write tool also implements `Magebit\Mcp\Api\UnderlyingAclAwareInterface`with `Magento_Catalog::products` / `Magento_Catalog::categories` as the underlying Magento admin resource, so they block 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 `ProductFieldResolverInterface`/ `CategoryFieldResolverInterface`;
- adding a new filter to `catalog.product.list` / `catalog.category.list`via `ProductFilterTranslatorInterface` / `CategoryFilterTranslatorInterface`;
- 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.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODA5NzUxMDIsIm5iZiI6MTc4MDk3NDgwMiwicGF0aCI6Ii81ODUwNTQ3NC80MTYxNjY0OTYtY2RjOTA0Y2UtZTgzOS00MGEwLWE4NmYtNzkyZjdhYjc5NjFmLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MDklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjA5VDAzMTMyMlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTMyN2Q3N2NkMTc0ODIyZjJhYmQyNDgzMTU3YTAwZTIzMzVlMTE2NDk2MDRmN2U0ODQ4NmM0YjE3YjU4ZmQ0MTImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.RnBR9XCB31o05tV9wJysKgdHWe7iLQqVY6NeUF5u0zY)](https://private-user-images.githubusercontent.com/58505474/416166496-cdc904ce-e839-40a0-a86f-792f7ab7961f.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODA5NzUxMDIsIm5iZiI6MTc4MDk3NDgwMiwicGF0aCI6Ii81ODUwNTQ3NC80MTYxNjY0OTYtY2RjOTA0Y2UtZTgzOS00MGEwLWE4NmYtNzkyZjdhYjc5NjFmLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MDklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjA5VDAzMTMyMlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTMyN2Q3N2NkMTc0ODIyZjJhYmQyNDgzMTU3YTAwZTIzMzVlMTE2NDk2MDRmN2U0ODQ4NmM0YjE3YjU4ZmQ0MTImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.RnBR9XCB31o05tV9wJysKgdHWe7iLQqVY6NeUF5u0zY)

*Have questions or need help? Contact us at *

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance98

Actively maintained with recent releases

Popularity14

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity46

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 ~10 days

Total

3

Last Release

13d ago

Major Versions

v0.0.2 → 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 (7 commits)")

---

Tags

adobeadobe-commerceaimagento2magento2-extensionmagento2-modulemcp-server

### Embed Badge

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

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

###  Alternatives

[elgentos/regenerate-catalog-urls

Regenerate Catalog URL Rewrites (products, categories, cms pages)

2852.6M](/packages/elgentos-regenerate-catalog-urls)[run-as-root/magento2-prometheus-exporter

Magento2 Prometheus Exporter

68353.9k](/packages/run-as-root-magento2-prometheus-exporter)[myparcelnl/magento

A Magento 2 module that creates MyParcel labels

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

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

1010.0k22](/packages/loki-magento2-components)[magepal/magento2-form-field-manager

Customer and Address Form Fields Manager for Magento2

293.9k](/packages/magepal-magento2-form-field-manager)[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.

223.3k](/packages/mage-os-module-llm-txt)

PHPackages © 2026

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