Freento MCP · Open-source modules for Magento 2
Your Magento Store, Connected to AI.
Two Magento 2 modules that let Claude, ChatGPT and other AI assistants work with your store over the Model Context Protocol (MCP) — an open standard for connecting AI to external systems.
Ask about orders, customers and stock in plain language. Let the assistant change prices, ship orders and update products — with a preview before anything is saved.
3 products are in stock with zero quantity. Nothing was saved yet:
24-MB04 in stock → out of stock 24-WB02 in stock → out of stock 24-UG06 in stock → out of stock
Apply these changes?
Two Modules, One Endpoint
Start with read-only access. Add the write module when you want the assistant to change data. Both use the same endpoint, clients, tokens and roles.
Freento MCP
Read · 18 toolsGives the assistant read access to orders, carts, products, prices, stock, customers, admin users and system versions. Every tool supports filtering, sorting, pagination and aggregation.
composer require freento/module-mcpfreento/magento-2-mcp →
Freento MCP Write
Write · 9 toolsAn add-on to Freento MCP. Lets the assistant create products, edit attributes, prices, stock and categories, comment and ship orders, issue offline refunds and update customer accounts.
composer require freento/module-mcp-writeFreento/Magento-2-MCP-write →
How It Works
The module adds an MCP server to your store. The assistant sends requests to it, the server checks the token and the role, and runs the tool inside Magento.
What You Can Ask
The assistant runs several queries, cross-references the results and answers in plain language. Examples from the module guides:
Revenue by month for the last 12 months
Find all orders over $500 that are still processing
Average order value by payment method
Top 10 customers by total order value
27 Tools Out of the Box
Read tools
Filter by any field, sort, paginate, and aggregate with sum, count, avg, min and max.
- get_ordersOrders with filtering, pagination and aggregation
- get_order_itemsOrder line items
- get_quotesShopping carts, active and abandoned
- get_quote_itemsCart line items
- get_creditmemosCredit memos
- get_productsProducts with attribute filtering
- get_categoriesProduct categories
- get_product_pricesPrices by customer group and website
- get_product_tier_pricesQuantity-based discounts
- get_tax_rulesTax rules and rates
- get_stock_single_stockInventory and stock levels
- get_cart_price_rulesCart price rules
- get_couponsCoupons
- get_customersCustomer accounts
- get_adminsAdmin users and their roles
- get_locked_adminsAccounts locked after failed logins
- get_system_versionsMagento, PHP, MySQL, Redis, OpenSearch versions
- get_storesWebsites, store groups, store views
Write tools
Every tool accepts dry_run and reports the old and the new values.
- create_productCreate a simple or virtual product
- update_product_attributesStatus, name, description, visibility, custom attributes
- update_product_pricesBase price, special price with dates, tier prices
- update_stockStock quantity and in-stock status
- assign_product_categoriesAdd to categories, remove, or set the exact list
- add_order_commentComment an order, change its status, email the customer
- create_shipmentShip fully or partially, with tracking numbers
- create_creditmemoOffline refund, fully or partially, optionally back to stock
- update_customerGroup, name, email, date of birth, tax/VAT number
DRY RUN: nothing was saved. Call again with dry_run=false to apply. Would update prices of 24-MB01 (id 1): price: 34.00 -> 29.99 special_price: (empty) -> 24.99
You Stay in Control
An AI assistant with access to a live store needs clear limits. They are built in.
OAuth clients and access tokens
Every AI client gets its own OAuth client and token, created in Magento Admin. Disable one client without touching the others.
Permissions per tool
An ACL role lists exactly which tools a client may call. A reporting assistant never sees a single write tool.
Write access is off by default
After installation write tools are hidden everywhere. One switch in the config turns all write access on or off at once.
Dry run before any change
Every write tool can preview the change without saving anything, and every result reports the old and the new values.
Anonymity mode
Hide emails and names from tool responses, so customer personal data is not sent to a third-party AI service unless you need it.
Changes go through Magento itself
Write tools use Magento service contracts, so validation, events, plugins and indexers of Magento and third-party modules run as usual.
Set Up in Three Steps
Install the module
One Composer package. The write add-on is a second, optional package.
Create a role and a client
In Magento Admin pick the tools the assistant may use, create an OAuth client and generate a token.
Connect your assistant
Add the store endpoint to Claude Code, Claude Desktop, ChatGPT or any other MCP client.
Requirements: Magento 2.4.x (Open Source or Commerce), PHP 8.1 or higher. Full guides are in the Freento MCP and Freento MCP Write repositories.
{
"mcpServers": {
"magento": {
"type": "http",
"url": "https://your-store.com/freento_mcp/index/index",
"headers": {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
}
}
}Need a Tool That Isn’t There Yet?
Both modules are open source. We can install them, set up roles for your team, and build custom tools for your store’s own data.