shopware-mcp: curated MCP tools for Shopware 6 operations

shopware-mcp is a Model Context Protocol server for Shopware 6 that sits between an MCP host and Shopware’s Admin API. The premise is narrow and practical: instead of exposing the full Admin API — roughly two hundred entities, Criteria filters, state machines, and write operations — it exposes twenty curated tools for the questions operators actually ask on a normal day. The tool set covers products, orders and order history, documents, customers, categories, promotions, reviews, payment and shipping methods, plugins, stock, sales channels, scheduled tasks, and trading settings. Responses are described as compact JSON with exact totals, with tool descriptions written for a model and Shopware’s own Criteria filters rather than a custom query language. For a builder, that choice matters: less surface area to learn, and fewer ways for a model to invent syntax the shop cannot execute. Where it goes beyond CRUD Several tools are specific to shop operations rather than generic entity access. checkout_simulate builds a throwaway cart through Shopware’s Store API, as a guest or as a specified customer, and explains cart errors in plain terms — a country the channel does not ship to, an expired code, a payment method hidden by a rule, a parent product that needs a variant. storefront_search applies the same customer view to search visibility. Nothing is ordered and the cart is deleted, according to the README. shop_pulse compares today with the same hours on the same weekday in recent weeks, excluding public holidays, and estimates how unusual a quiet period is. promotions_check reviews promotions that run or start before a given date and flags inactive starts, missing discounts or channels, exhausted codes, redemption limits, and overlapping automatic discounts. promotion_impact replays a discount against recent real orders, and margin_check looks for products sold below purchase price or left with thin margins after automatic discounts. The operational side is a CLI watch mode. shopware-mcp watch polls orders and payments every few minutes and posts to Slack only on change, paired