README

Sylius Mate Extension

Dev-only Symfony AI Mate extension exposing the Sylius runtime domain to AI assistants via MCP.

About

The Sylius Mate Extension is an AI Mate extension for Sylius. It exposes the Sylius runtime domain — resources, hooks, grids, routes, services, Twig helpers, mailer configuration — to AI assistants over the Model Context Protocol (MCP).

Every tool runs against the host project's booted Symfony kernel, so listings, inspections, and audits reflect the real container, real grid configuration, real route map, real installed plugins. Agents generate Sylius code against the actual shape of your application instead of hallucinating Twig helpers, routes, or resource patterns.

The extension is dev-only. Install it as a require-dev dependency; never ship it to production.

Documentation

See INSTRUCTIONS.md for the full description of every MCP tool, when to call it, and the hard rules agents must follow (Twig helper verification, route lookup, resource scaffolding, mutating-tool confirmation).

General Sylius documentation is available at docs.sylius.com.

Installation

Add the extension as a dev dependency of your Sylius project:

$ composer require --dev sylius/sylius-mate-extension

Initialize the Mate environment and discover the extension:

$ vendor/bin/mate init
$ vendor/bin/mate discover

Extension discovery runs automatically after Composer install and update. Run vendor/bin/mate discover manually to refresh discovery state and regenerate agent instruction artifacts.

Available Tools

Tools are grouped by domain. Full reference in INSTRUCTIONS.md.

• Resource — sylius_domain_list_resources, sylius_domain_resource_template, sylius_resource_inspect
• Grid — sylius_domain_list_grids, sylius_grid_actions_audit
• Hook — sylius_hooks_list, sylius_hooks_find_for_template, sylius_hooks_list_hookables, sylius_hooks_resolve_for_visibility
• Twig — sylius_twig_list_functions, sylius_twig_function_verify, sylius_test_render_template
• Route — sylius_routes_show, sylius_route_inspect
• Mailer / Email — sylius_email_capture_status, sylius_mailer_verify_template, sylius_email_template_skeleton
• Service configuration — sylius_services_yaml_profile, sylius_services_yaml_audit, sylius_services_yaml_patch_exclude
• Project — sylius_project_profile, sylius_installed_plugins, sylius_project_audit
• Translation — sylius_translation_create
• Admin / Playwright — sylius_admin_restock_via_http, sylius_playwright_recipe
• Cache — sylius_cache_clear

Development

$ composer install
$ vendor/bin/phpunit

Useful Mate commands while developing:

$ vendor/bin/mate debug:capabilities
$ vendor/bin/mate debug:extensions
$ vendor/bin/mate mcp:tools:list

Contributing

Would like to help us build a more capable Sylius developer experience? Start from reading our Contribution Guide.

Bug Tracking

If you want to report a bug or suggest an idea, please use GitHub issues.

Community Support

Get Sylius support on Slack, Forum or Stack Overflow.

MIT License

The Sylius Mate Extension is released under the terms of the MIT License.