get_ordersLABSCO SUMMARY
Store data, scoped by a role you define before you connect anything.
The ACL role decides which tool groups a client can reach — sales, catalog, customer, admin, system — so a connector built for reporting need never see customer records. Aggregation runs on the Magento side, which means revenue by month comes back as a dozen rows rather than every order the model then has to add up.
What it is
A Magento 2 extension that runs an MCP server inside your store, exposing sales, catalog, customer, admin and system data over HTTP with filtering, sorting, pagination and aggregation on every list tool.
What you get
- Sales —
get_orders,get_order_items,get_quotesfor active and abandoned carts,get_quote_items,get_creditmemos - Catalog —
get_products,get_categories,get_product_prices,get_product_tier_prices,get_stock_single_stock,get_tax_rules - Customers with
get_customers; admin hygiene withget_adminsandget_locked_admins - Marketing —
get_cart_price_rulesandget_coupons - System facts —
get_system_versionsreturns Magento, PHP, MySQL, Redis and OpenSearch versions;get_storesreturns the website / store group / store view hierarchy - Filters on any field with
eq,neq,in,nin,like,nlike,gt,gte,lt,lte, and analytics withcount,sum,avg,min,maxgrouped by status, month, day, customer email, store or payment method
Requirements
Magento 2.4.x, Open Source or Commerce, on PHP 8.1 or higher. Install with composer require freento/module-mcp, then php bin/magento module:enable Freento_Mcp, setup:upgrade and cache:flush. In the admin, create an ACL role, create an OAuth client against it, generate an OTP (valid 24 hours) and then an access token; connect over HTTP to <YOUR_STORE_URL>/freento_mcp/index/index with that token as a Bearer header.
Setup effort
One command plus credentials — composer require freento/module-mcp && php bin/magento module:enable Freento_Mcp && php bin/magento setup:upgrade && php bin/magento cache:flush, then supply credentials
USE CASES
01
Answering a revenue question without a spreadsheet
Sum grand total grouped by month or by payment method, straight from the orders table.
02
Finding what is about to go out of stock
Read stock levels against the catalog and filter to products below the quantity you care about.
03
Looking into abandoned carts from this week
List the carts and their line items, filtered by date, and see what people are leaving behind.
04
Checking the platform before an upgrade
Read the running Magento, PHP, MySQL, Redis and OpenSearch versions, and whether any admin accounts are locked out.
18 tools
Listed in project docs. Your client may show a different list.
get_order_itemsget_quotesget_quote_itemsget_creditmemosget_cart_price_rulesget_couponsget_productsget_categoriesget_product_pricesget_product_tier_pricesget_tax_rulesget_stock_single_stockget_customersget_adminsget_locked_adminsget_system_versionsget_storesBEFORE YOU INSTALL
What to know first
Tools you get
18 tools named in the project's documentation.
Requires
A client that can reach a remote MCP server over HTTP
INSTALLATION
Connect your client
Server setup
TERMINAL
composer require freento/module-mcp
php bin/magento module:enable Freento_Mcp
php bin/magento setup:upgrade
php bin/magento cache:flushMCP Clients
Claude Code
With the extension installed in your store, open Magento Admin and create an ACL role under System > Freento MCP > ACL Rules, choosing which tool groups it may use
Under System > Freento MCP > AI MCP Clients, add a client for that role and save it; open it, click Generate OTP, then Generate Token and enter the OTP, and copy the Access Token
Add this to your project's .mcp.json with your store's domain and that token, then run /mcp in Claude Code to reconnect:
CLAUDE CODE · JSON
{
"mcpServers": {
"magento": {
"type": "http",
"url": "<YOUR_STORE_URL>/freento_mcp/index/index",
"headers": {
"Authorization": "Bearer <YOUR_ACCESS_TOKEN>"
}
}
}
}ChatGPT
In Magento Admin, with the extension installed, create an ACL role (System > Freento MCP > ACL Rules) and an OAuth client for it (System > Freento MCP > AI MCP Clients); copy the Client ID and Client Secret
In the web client that supports OAuth 2.0, register your store's MCP endpoint and enter that Client ID and Client Secret
When asked to authorize, enter the OTP generated on the OAuth client's page and finish the authorization
The endpoint to register, with your own store's domain:
CHATGPT · URL
<YOUR_STORE_URL>/freento_mcp/index/index
