sylius-mcp — know beforehand what the server can do.
The bundle registers shop tools for the MCP server and publishes the Server Card per SEP-1649 at /.well-known/mcp/server-card.json. From it an agent learns the transport and the tool surface before it connects, and finds the protected resource metadata without being turned away first.
An announced capability with nothing behind it costs more than its absence.
Without a Server Card, an agent gets started by way of failures: connect, be turned away, learn the metadata from the rejection, connect again. That works, but it costs round trips and turns every first contact into error handling. The card per SEP-1649 puts the transport, the tool surface and the protected resource metadata up front, at /.well-known/mcp/server-card.json.
The tools capability is only announced when something is actually registered. A promise without cover is worse than none at all: the agent connects on the strength of exactly that promise, requests the list and gets it back empty — with no clue whether that is a misconfiguration on the server side or intentional. A capability that is not announced, by contrast, is a clear statement it can act on.
This ties the card to what the shop has really registered, rather than to a separate configuration that someone has to keep in step.
Source code & documentation
Composer package
MIT · Sylius 2.0+ · PHP 8.2+
composer require koh/sylius-mcp
Built, tested and released under MIT. Public distribution via Packagist is being prepared (coming soon).
Part of the family
MIT
This package belongs to koh/sylius-agent-ready — seventeen bundles that make a Sylius shop usable for AI agents. Each one can be used on its own.