PHPackages                             sylius/mcp-server-plugin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. sylius/mcp-server-plugin

ActiveSylius-plugin

sylius/mcp-server-plugin
========================

Sylius MCP Server Plugin

v0.2.0(4w ago)171.1k↓100%4[2 PRs](https://github.com/Sylius/McpServerPlugin/pulls)proprietaryPHPPHP ^8.2CI failing

Since Jul 3Pushed 2w agoCompare

[ Source](https://github.com/Sylius/McpServerPlugin)[ Packagist](https://packagist.org/packages/sylius/mcp-server-plugin)[ GitHub Sponsors](https://github.com/sylius)[ RSS](/packages/sylius-mcp-server-plugin/feed)WikiDiscussions main Synced today

READMEChangelog (3)Dependencies (32)Versions (6)Used By (0)

 [    ![Sylius Logo.](https://camo.githubusercontent.com/ea9dddc934264aa7ec01cf3202c500f3d8b04448bce2571bdc74230efddda88f/68747470733a2f2f6d656469612e73796c6975732e636f6d2f73796c6975732d6c6f676f2d3830302e706e67)  ](https://sylius.com)

MCP Server Plugin
=================

[](#mcp-server-plugin)

[![](https://camo.githubusercontent.com/9b437c7f32af7f569d4c0d8e750fd3e94c19a1a7ad491228a34cf567b0ea8af4/68747470733a2f2f73796c6975732e636f6d2f6173736574732f62616467652d6f6666696369616c2d73796c6975732d706c7567696e2e706e67)](https://sylius.com/plugins/)

 A Sylius plugin that exposes a Model Context Protocol (MCP) server for enabling interaction with your store via Large Language Models (LLMs) like ChatGPT.

Installation
============

[](#installation)

Requirements
------------

[](#requirements)

We work on stable, supported and up-to-date versions of packages. We recommend you to do the same.

PackageVersionPHP^8.2sylius/sylius^2.1MySQL^8.4NodeJS^20.x---

#### Beware!

[](#beware)

This installation instruction assumes that you're using Symfony Flex.

1. Require plugin with composer:

```
  composer require sylius/mcp-server-plugin
```

**Clear application cache by using command:**

```
  bin/console cache:clear
```

---

Without Symfony Flex
--------------------

[](#without-symfony-flex)

1. Require the plugin:

```
composer require sylius/mcp-server-plugin
```

2. Import the plugin configuration in `config/packages/sylius_mcp_server.yaml`:

```
imports:
    - { resource: "@SyliusMcpServerPlugin/config/config.yaml" }
```

3. Import the routes in `config/routes.yaml`:

```
sylius_mcp_server:
    resource: '@SyliusMcpServerPlugin/config/routes.yaml'
```

4. Clear application cache:

```
bin/console cache:clear
```

---

Documentation
-------------

[](#documentation)

### What is MCP Server?

[](#what-is-mcp-server)

The Model Context Protocol (MCP) is a standardized way to connect language models (like ChatGPT) with external tools, APIs, and systems. It allows an AI model to make structured tool calls — similar to calling functions — during a conversation.

The MCP Server acts as a bridge between the language model and your application logic. It exposes a list of tools (like “search for a product” or “create an order”) and executes them in response to requests from the AI.

This plugin integrates Sylius with an MCP Server, enabling AI agents to interact with your store (e.g., search products, check prices, start checkout).

We use the official [symfony/mcp-bundle](https://symfony.com/doc/current/ai/bundles/mcp-bundle.html) to provide the MCP server runtime.

```
┌────────────────┐                  ┌───────────────┐       ┌────────┐
│  MCP Client    │◄────────────────►│  MCP Server   │◄─────►│ Sylius │
│ (OpenAi, etc.) │  (Stdio/HTTP)    │ (Tools, etc.) │ (API) │        │
└────────────────┘                  └───────────────┘       └────────┘

```

To learn more, see the official MCP introduction at [modelcontextprotocol.io](https://modelcontextprotocol.io/introduction).

### Running the MCP Server

[](#running-the-mcp-server)

#### Stdio Transport

[](#stdio-transport)

```
  bin/console mcp:server
```

#### HTTP Transport

[](#http-transport)

The HTTP endpoint is available at `/_mcp`.

### MCP Server Configuration

[](#mcp-server-configuration)

For more options, refer to the [symfony/mcp-bundle documentation](https://symfony.com/doc/current/ai/bundles/mcp-bundle.html).

### Sylius API

[](#sylius-api)

Tools communicate with the Sylius API through pre-configured HTTP clients:

```
sylius_mcp_server.http_client.api_shop:
    base_uri: '%sylius_mcp_server.api.shop_base_uri%'
    headers:
        - 'Accept: application/ld+json'
        - 'Content-Type: application/ld+json'
sylius_mcp_server.http_client.api_shop_merge_patch:
    base_uri: '%sylius_mcp_server.api.shop_base_uri%'
    headers:
        - 'Accept: application/ld+json'
        - 'Content-Type: application/merge-patch+json'
```

The default API base URI is , and can be overridden using the environment variable `SYLIUS_MCP_SERVER_API_SHOP_BASE_URI`.

### Tools

[](#tools)

The following tools are available out of the box:

NameDescriptionadd\_item\_to\_orderAdds an item to the order.complete\_checkoutCompletes the checkout process. (Final step)create\_orderCreates a new order.fetch\_channelFetches a channel by code.fetch\_currencyFetches a currency by code.fetch\_orderFetches an order by its token.fetch\_productFetches a product by its code.fetch\_product\_variantFetches a product variant by its code.list\_payment\_methodsLists all available payment methods.list\_shipping\_methodsLists all available shipping methods.search\_productsSearches for products by name.search\_product\_variantsSearches for product variants by name.select\_payment\_methodSelects a payment method for the order. (Step 3 of checkout)select\_shipping\_methodSelects a shipping method for the order. (Step 2 of checkout)update\_order\_addressUpdates the order address. (Step 1 of checkout)These tools currently operate in guest mode only — `fetch_order` returns data only if the order has no associated customer account.

#### Adding custom tools

[](#adding-custom-tools)

You can extend the server with your own tools by creating PHP classes annotated with the `#[McpTool]` attribute.

To learn how to define and structure a tool, see the [symfony/mcp-bundle documentation](https://symfony.com/doc/current/ai/bundles/mcp-bundle.html).

Register your tools as services with autoconfiguration in `config/services.yaml`:

```
services:
    App\Mcp\Tool\:
        resource: '../src/Mcp/Tool/*'
        autoconfigure: true
```

### Usage Example

[](#usage-example)

You can use the server directly in [OpenAI Playground](https://platform.openai.com/playground/prompts), exposing it via [ngrok](https://ngrok.com/) or similar tunneling tools.

#### Example with OpenAI Playground

[](#example-with-openai-playground)

1. Add a new tool in the OpenAI Playground. [![add_tool](doc/images/playground_one.png)](doc/images/playground_one.png)
2. Configure the tool with the following settings:

    - **URL**: `http://localhost:8080/_mcp` (or your ngrok URL)
    - **Label**: Sylius
    - **Authentication**: None [![configure_tool](doc/images/playground_two.png)](doc/images/playground_two.png)

#### Example with API Call

[](#example-with-api-call)

```
  curl https://api.openai.com/v1/responses \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -d '{
      "model": "gpt-4.1",

      "tools": [
        {
          "type": "mcp",
          "server_label": "Sylius",
          "server_url": "$YOUR_MCP_SERVER_URL",
          "require_approval": "never"
        }
      ],

      "input": [
        {
          "role": "user",
          "content": [
            {
              "type": "input_text",
              "text": "Find me red shoes"
            }
          ]
        }
      ],
      "max_output_tokens": 1024
    }'
```

Security issues
---------------

[](#security-issues)

If you think that you have found a security issue, please do not use the issue tracker and do not post it publicly. Instead, all security issues must be sent to `security@sylius.com`

Community
---------

[](#community)

For online communication, we invite you to chat with us &amp; other users on [Sylius Slack](https://sylius-devs.slack.com/).

License
-------

[](#license)

This plugin's source code is completely free and released under the terms of the MIT license.

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance95

Actively maintained with recent releases

Popularity29

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 75% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~118 days

Total

3

Last Release

28d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/719423?v=4)[Sylius eCommerce](/maintainers/sylius)[@Sylius](https://github.com/Sylius)

![](https://www.gravatar.com/avatar/4b4a5a1a9293502aa8573551fab020963a9050c5cca4524433b6d94214d3b480?d=identicon)[GSadee](/maintainers/GSadee)

---

Top Contributors

[![Wojdylak](https://avatars.githubusercontent.com/u/33687392?v=4)](https://github.com/Wojdylak "Wojdylak (18 commits)")[![camilleislasse](https://avatars.githubusercontent.com/u/34024380?v=4)](https://github.com/camilleislasse "camilleislasse (4 commits)")[![Rafikooo](https://avatars.githubusercontent.com/u/40125720?v=4)](https://github.com/Rafikooo "Rafikooo (2 commits)")

---

Tags

syliussylius-plugin

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/sylius-mcp-server-plugin/health.svg)

```
[![Health](https://phpackages.com/badges/sylius-mcp-server-plugin/health.svg)](https://phpackages.com/packages/sylius-mcp-server-plugin)
```

###  Alternatives

[bitbag/cms-plugin

CMS plugin for Sylius applications.

2461.1M5](/packages/bitbag-cms-plugin)[sylius/invoicing-plugin

Invoicing plugin for Sylius.

90999.0k2](/packages/sylius-invoicing-plugin)[sylius/refund-plugin

Plugin provides basic refunds functionality for Sylius application.

691.6M13](/packages/sylius-refund-plugin)[stefandoorn/sitemap-plugin

Sitemap Plugin for Sylius

851.0M](/packages/stefandoorn-sitemap-plugin)[sylius/paypal-plugin

PayPal plugin for Sylius.

441.4M4](/packages/sylius-paypal-plugin)[monsieurbiz/sylius-rich-editor-plugin

A Rich Editor plugin for Sylius.

74368.7k6](/packages/monsieurbiz-sylius-rich-editor-plugin)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
