home / mcp / saleor mcp server

Saleor MCP Server

MCP Server for the Saleor Dashboard

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "ashwin2912-saleor-dashboard-mcp": {
      "command": "poetry",
      "args": [
        "run",
        "bm-mcp"
      ],
      "env": {
        "SALEOR_EMAIL": "[email protected]",
        "SALEOR_API_URL": "http://localhost:8000/graphql/",
        "SALEOR_PASSWORD": "your-password"
      }
    }
  }
}

You can connect to a Saleor MCP Server to query products, orders, customers, and more from Saleor using a Model Context Protocol client. This guide shows you how to install, configure, and start the MCP server and how to use it with an MCP client.

How to use

After you have the MCP server running, you can use an MCP client to ask for Saleor data. The server exposes endpoints that let you retrieve products with optional filters, view product details, and interact with other Saleor data such as orders and customers. Use the client to call the available tools and read formatted responses for easy consumption.

Available tool you can use: - get_products: Retrieve products with optional filtering. You can specify limit, channel, and category_id to tailor the results. The server returns a formatted list with product names, prices, and availability.

How to install

Prerequisites include Python 3.10 or higher and a preferred package manager. You also need Poetry (recommended) or pip, and a Saleor instance that is running locally for development.

Step by step commands to set up locally on your machine:

# 1. Clone the MCP server repository
# Replace with your actual repository path
# git clone https://github.com/ashwin2912/saleor-dashboard-mcp.git
# cd saleor-dashboard-mcp

# 2. Install dependencies
poetry install

# Or install via pip if you prefer
pip install -r requirements.txt
pip install -e .

Additional setup and configuration

Configure environment variables for the Saleor connection and server behavior in a local environment file. The following settings are used by the MCP server to connect to Saleor and to control logging and limits.

# Saleor API Configuration
SALEOR_API_URL=http://localhost:8000/graphql/
[email protected]
SALEOR_PASSWORD=your-password

# Optional: Advanced Settings
LOG_LEVEL=INFO
TOKEN_REFRESH_THRESHOLD=300
SERVER_NAME=saleor
DEFAULT_PRODUCT_LIMIT=20
MAX_PRODUCT_LIMIT=100

Available tools

get_products

Retrieve products with optional filtering and receive a formatted list including names, prices, and availability.