Saleor MCP Server

A Model Context Protocol implementation for interacting with Saleor e-commerce platform

Welcome to Saleor MCP

Transform how you interact with your Saleor store data

The Model Context Protocol (MCP) is a way to plug Saleor's API into an LLM, letting you ask questions about your store data in the context of the LLM itself. This lets you take an agent that you already use, like Cursor, and pull in additional information from Saleor to help with tasks like business analysis, inventory management, and customer insights.

Connecting Saleor to LLMs allows you to easily get answers to questions like:

  • "Which products are running low on stock?"
  • "Customer insights from this month"
  • "Show recent orders that need attention"

This provides an easy interface to learn insights about your Saleor store without needing to navigate through different dashboards or write complex queries.

Getting Started

Quick setup guide to get you up and running

To get started with the Saleor MCP server, visit our GitHub repository which contains detailed installation instructions, configuration guides, and examples.

View on GitHub

Note: The repository includes setup instructions for various MCP clients, authentication configuration, and example usage scenarios.

Available Tools

Pre-configured functions for common Saleor operations

Tools are pre-configured functions that can be used to help with common tasks. Each tool provides specific functionality for interacting with your Saleor store data.

Fetch the list of channels from Saleor.This tools retrieves the list of channels. For each channel it returns information such as: ID, name, slug, currency code, default country, whether the channel is active, and the list of warehouses.

No additional arguments required

在商城中创建一个商品分类。

Arguments:

  • name (required) str: 分类名称
  • parent_id str | None: 父分类 ID（可选，创建子分类用）

在商城中创建一个商品，含默认变体；提供 price 后自动定价可售。

Arguments:

  • name (required) str: 商品名称
  • product_type_id (required) str: 商品类型 ID（用 list_product_types 查询）
  • channel_id str | None: 渠道 ID；不传且给 price 时自动选默认渠道
  • category_id str | None: 分类 ID（用 list_categories 查询）
  • price float | None: 售价（元）；提供则自动建变体并定价，商品即可售
  • sku str | None: 库存编码（可选）
  • description str | None: 商品描述（纯文本，自动转富文本）

Return the current domain of the connected Saleor instance.

No additional arguments required

Fetch list of customers from Saleor GraphQL API.This tool retrieves customer information such as: ID, active status, language code, last login, date joined, and default shipping/billing address country.

Arguments:

  • first int | None: Number of customers to fetch (max 100 per request)
  • after str | None: Cursor for pagination - fetch customers after this cursor
  • sort_by saleor_mcp.saleor_client.input_types.UserSortingInput | None: Sort customers by specific field
  • filter saleor_mcp.tools.customers.CustomerFilterInput | None: Filter customers by specific criteria

删除商城中的一个商品（不可恢复）。

Arguments:

  • product_id (required) str: 商品 ID

删除商品的一张图片（不可恢复）。

Arguments:

  • media_id (required) str: 商品媒体 ID

抓取一个外部商城商品页，提取名称/价格/图片/描述（只读公开信息）。

Arguments:

  • url (required) str: 外部商城商品页 URL（如淘宝/京东/独立商城商品详情页）

把素材目录里的一个商品文件夹导入商城：图片 + info.json（名称/价格/描述/分类）→ 建品传图。

Arguments:

  • folder (required) str: 素材子目录名（list_assets 查看；目录含图片和可选 info.json）
  • product_type_id (required) str: 商品类型 ID
  • channel_id str | None: 渠道 ID；不传时自动选默认渠道
  • price_override float | None: 价格覆盖；不传则用 info.json 的 price，都没有则报错
  • max_images int: 最多导入图片张数

抓取外部商城商品 → 自动创建商品 + 上传图片，一步完成。

Arguments:

  • url (required) str: 外部商城商品页 URL
  • product_type_id (required) str: 商品类型 ID（list_product_types 查询）
  • channel_id str | None: 渠道 ID；不传时自动选默认渠道
  • category_id str | None: 分类 ID（可选）
  • price float | None: 价格覆盖；不传则用抓取到的价格，抓不到则报错
  • name str | None: 名称覆盖；不传则用抓取到的名称
  • max_images int: 最多导入图片张数

列出素材根目录下的商品素材（每个子目录 = 一个待导入商品）。

Arguments:

  • path str | None: 子目录（相对素材根目录）；不传列出全部

查询商城商品分类列表（id 与 name），供建品时选择。

Arguments:

  • first int: 最多返回数量

查询商城商品类型（建品必填 product_type_id）。

Arguments:

  • first int: 最多返回数量

Fetch total count of orders from Saleor GraphQL API.This tool retrieves the total count of orders based on the provided filter criteria.

Arguments:

  • filter saleor_mcp.tools.orders.OrderFilterInput | None: Filter and search orders by specific criteria

Fetch list of orders from Saleor GraphQL API.This tool retrieves the list of orders. For each order it returns information such as: ID, number, status, creation date, last update date, payment status, total amount, shipping and billing address country, order lines which include: quantity, product SKU, variant name, product ID, product name, unit price.

Arguments:

  • first int | None: Number of orders to fetch (max 100 per request)
  • after str | None: Cursor for pagination - fetch orders after this cursor
  • sort_by saleor_mcp.saleor_client.input_types.OrderSortingInput | None: Sort orders by specific field
  • filter saleor_mcp.tools.orders.OrderFilterInput | None: Filter and search orders by specific criteria

Fetch list of products from Saleor GraphQL API.This tool retrieves product information such as: ID, name, slug, external reference, product type, category, date of creation, date of last update, and pricing.

Arguments:

  • first int | None: Number of products to fetch (max 100 per request)
  • after str | None: Cursor for pagination - fetch products after this cursor
  • channel str | None: Slug of a channel for which the data should be returned. If not provided, general product data is returned.
  • sort_by saleor_mcp.saleor_client.input_types.ProductOrder | None: Sort products by specific field
  • search str | None: Search products with full-text search

Fetch list of stocks from Saleor GraphQL API.This tool retrieves stock information such as: ID, quantity, allocated quantity, warehouse information, and associated product variant details.

Arguments:

  • first int | None: Number of stocks to fetch (max 100 per request)
  • after str | None: Cursor for pagination - fetch stocks after this cursor
  • filter saleor_mcp.saleor_client.input_types.StockFilterInput | None: Filter stocks by specific criteria

更新商品的基本信息（名称/描述/分类）。

Arguments:

  • product_id (required) str: 商品 ID
  • name str | None: 新名称
  • description str | None: 新描述（纯文本）
  • category_id str | None: 新分类 ID

给指定商品添加一张图片（从 URL 下载并上传入库）。

Arguments:

  • product_id (required) str: 商品 ID
  • image_url (required) str: 图片 URL（下载后上传入库）
  • alt str | None: 图片替代文本

Fetch warehouse details from Saleor GraphQL API.This tool retrieves detailed warehouse information including: ID, name, slug, address details, click and collect options, associated shipping zones with their channels and countries, and metadata.

Arguments:

  • id str | None: ID of the warehouse to fetch details for

Built with ❤️ and 🤖 by Saleor Commerce.

Version: 0.1.3