MCP Server

Freento MCP Server connects your Magento 2 store to AI assistants via the https://modelcontextprotocol.io/ - an open standard for AI-to-application integration. Once connected, AI can query your store data in natural language: "show me revenue by month", "find customers who haven't ordered in 90 days", "which products are low on stock".

The module provides a set of read-only tools covering different areas of your store:

• Sales - orders, order items, quotes (including abandoned carts), quote items, credit memos
• Catalog - products with attribute filtering, inventory/stock levels
• Customers - customer accounts with filtering by email, group, dates, store
• Marketing - cart price rules, coupons
• Admin - admin users with roles, locked accounts (failed login detection)
• System - Magento, PHP, MySQL, Redis, OpenSearch/Elasticsearch versions

Every tool supports filtering with 10 operators (eq, neq, in, nin, like, nlike, gt, gte, lt, lte), sorting, and pagination. The orders tool adds built-in aggregation: sum, count, avg, min, max - with grouping by status, month, day, customer, payment method, or store.

AI assistants can chain multiple queries in one conversation - for example, comparing this month's revenue to last month, or cross-referencing sales velocity with stock levels to find products that need reordering.

Security & Access Control

• OAuth 2.0 Authorization Code flow with PKCE
• Role-based ACL: choose exactly which tools each AI client can access
• Multiple OAuth clients with independent permissions
• All data stays in your Magento database - no external storage, no data duplication
• Read-only access - the module cannot modify store data

Works with

• Claude Code and Claude Desktop (bearer token via .mcp.json)
• ChatGPT and web-based clients (OAuth 2.0 flow)
• Any MCP-compatible AI tool

The module is also available on Github with full source code, user guide, and issue tracker. Please refer to the Github repo for detailed setup and usage instructions.

For a detailed overview of how the module works and how to customize it, see the Freento MCP Server knowledge base article.