The Problem We Solved

Anyone who runs a Magento store knows the friction. Need to check yesterday's revenue? Log into the admin, navigate to Reports, set the date range, wait for it to load. Need to look up a customer's order? Admin → Customers → find account → click → Orders tab → scroll.

Multiply that by every person in your organization who needs data from the store — the CEO checking the morning pulse, the support agent looking up an order, the operations manager checking the fulfilment queue, the SEO specialist auditing product metadata.

We wanted a single interface where anyone on the team could ask questions in plain language and get instant, structured answers from the live store.

How It Works

MageMCP is a standalone Python service — not embedded in Magento. It connects via REST and GraphQL APIs that already exist on every Magento instance.

`c_*` Customer Tools

18 tools

GraphQL

Storefront operations — product search, cart management, full checkout flow

c_search_products c_get_product c_get_categories c_get_cart c_add_to_cart c_apply_coupon c_set_shipping_address c_place_order

`admin_*` Admin Tools

42 tools

REST API

Back-office operations — order management, customer lookup, inventory, bulk updates

admin_search_orders admin_get_order admin_cancel_order admin_create_invoice admin_create_shipment admin_search_customers admin_get_inventory admin_update_product admin_update_cms_page admin_generate_coupons

Built for Production, Not Just Demos

PII Redaction

Customer and order data is masked by default — masked email, initials only, last-4 phone. Full data requires explicit pii_mode=full.

Audit Logging

Every tool invocation logged as structured JSONL with trace ID, duration, parameters, and result.

Idempotency

Write tools accept idempotency keys to prevent duplicate operations on retry.

Rate Limiting

Server-side sliding window per tool prevents runaway API calls.

Confirmation Prompts

Every write operation requires explicit confirmation. First call shows what will happen. Second call executes.

Input Validation

Strict Pydantic schemas on every parameter. No raw strings hitting the API.

Real Use Cases by Role

CEO

"Give me yesterday's numbers and how they compare to last week." Ten-second pulse check before the first meeting.

Customer Support

Look up a customer by partial email, pull order history, check return status, add internal comments — all without switching between admin tabs.

Operations Manager

Morning briefing: pending orders, held orders, yesterday's uninvoiced orders. Trigger bulk shipment creation for a batch of orders.

SEO Specialist

Audit all products missing meta titles/descriptions, generate content, and bulk-update in one conversation.

E-commerce Manager

Verify a new product launch is complete — stock, images, pricing, category assignment across all store views.

Sales Manager

This month vs last month revenue. Promotion performance. Top 10 highest-value abandoned carts for outreach.

CTO

Store configuration audit across all store views. Bulk operation status monitoring. CMS content deployment with before/after verification.

Quick Start

Install

pip install -e .

Configure

export MAGENTO_BASE_URL=https://magento.example.com
export MAGEMCP_ADMIN_TOKEN=your-token

Run

magemcp

Or with Docker

docker compose run --rm -i magemcp

Request a Personalised Demo

See MageMCP connected to your Magento store. We'll set up a live session showing how AI agents can handle your specific workflows — orders, inventory, customer service, or catalog management.

Request Demo

[email protected] — We'll respond within 24 hours

AI Agents for Your Magento Store