# Magento tools in Cogny Cogny's Magento integration exposes 20 tools (17 read, 3 write) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app. - **Read** (17): only reads data. - **Write** (3): creates or changes something. - **Destructive** (0): deletes, removes or replaces something. Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations. ## Notes Magento 2 and Adobe Commerce (2.3 and later) are connected from Settings → Integrations with your **store address** and the **Access Token** of an integration you create in the Magento admin (System → Extensions → Integrations). On Magento 2.4.4 and later, also set Stores → Configuration → Services → OAuth → Consumer Settings → "Allow OAuth Access Tokens to be used as standalone Bearer tokens" to Yes, or every call is refused. The integration's **Resource Access** decides what Cogny can see and change. For every tool to work, tick Sales (orders, credit memos), Catalog (products, categories, inventory), Customers, Marketing → Cart Price Rules and Stores → Settings → Stores. Leave out write access to products and inventory if you want the connection read-only. Writes are limited to regular prices, scheduled sale (special) prices and stock quantities, and stay **ask-first** until you allow them in Settings. Sales totals and best sellers cover up to 5,000 orders per call, in the store's timezone and base currency. ### Known gaps - **Catalog price rules** can't be read or changed: Magento has no REST endpoint for them. Cart price rules and coupons are covered. - **No order actions**: Cogny doesn't invoice, ship, cancel or refund orders, and doesn't create or delete products, customers or coupons. - **Storefront analytics** (sessions, carts, conversion rate) aren't in the Magento API; connect GA4 for those. - The store must be reachable over the public internet on port 443. If it only accepts known addresses, allow Cogny's egress address shown in the connect dialog. ## All tools | Tool | Kind | What it does | |---|---|---| | `get_store_info` | Read | See the store's websites, store views, timezone and currencies. | | `list_orders` | Read | List orders, newest first, with totals, status and customer. | | `get_order` | Read | Get one order with its line items, addresses, payment and status history. | | `get_sales_summary` | Read | Get order count, revenue, discounts, shipping, tax, refunds and average order value for a period. | | `get_best_sellers` | Read | Rank products by units sold or revenue over a period, from the order lines. | | `list_credit_memos` | Read | List refunds (credit memos), newest first, with amounts and the order they belong to. | | `list_products` | Read | List products with SKU, name, type, status and price. | | `get_product` | Read | Get one product by SKU with its attributes, categories, stock and configurable options. | | `get_prices` | Read | Get the base prices and scheduled special (sale) prices for up to 100 SKUs. | | `get_stock` | Read | Get a product's stock: quantity, in-stock flag and backorder settings. | | `list_low_stock` | Read | List products whose stock is at or below a quantity, with SKU and name. | | `list_categories` | Read | Get the category tree with ids, names, product counts and active flags. | | `list_customers` | Read | List registered customers, newest first, with name, email, group and city. | | `get_customer` | Read | Get one customer with addresses, group and account details. | | `list_cart_price_rules` | Read | List cart price rules (discounts and promotions) with their conditions, amounts and dates. | | `list_coupons` | Read | List coupon codes with their rule, usage count, limits and expiry. | | `get_rest_resource` | Read | Read any other Magento REST endpoint (GET only), such as invoices, shipments or attributes. | | `update_product_prices` | Write | Change the regular price of up to 100 products; only after the user confirms each new price. | | `set_special_prices` | Write | Schedule sale (special) prices for up to 100 products; only after the user confirms prices and dates. | | `update_stock` | Write | Set a product's stock quantity and in-stock flag; only after the user confirms the new quantity. | Exact input schemas come from `tools/list` once Magento is connected; the free plan is enough to check. Missing something? Your agent can ask for it with `request_feature`. --- All integrations: https://cogny.com/integrations/tools/index.md Plans, approvals, limits and data protection: https://cogny.com/buying-guide.md What Cogny is: https://cogny.com/llms.txt