# Saleor

Headless GraphQL commerce API; the Builder hosts a read-only MCP for products, orders, and customers.

API-only commerce core written in Python. Everything (catalog, channels, checkout, orders, promotions) is driven through one GraphQL API; there is no bundled storefront. Saleor publishes saleor-mcp, hosted at mcp.saleor.app, which lets an agent read products, orders, and customers but runs no mutations.

Alternative to: Shopify, commercetools

- Capabilities: adaptable, operable
- Vertical: ecommerce
- Shape: business-app
- Form factor: api
- Execution model: deterministic
- Provenance: human-written (recorded, never ranked)
- Repo: https://github.com/saleor/saleor (BSD-3-Clause), 23287 stars, last commit 2026-09-02
- Last activity: 2026-09-02
- Page: apps/saleor--saleor.html
- JSON: apps/saleor--saleor.json

## Use it when

- I want a commerce backend I can talk to only through GraphQL, and I will build or pull my own storefront
- my agent needs to read catalog and order data from a Saleor Cloud store without being able to change anything

## Gotchas

- No storefront in this repo; saleor/storefront is a separate Next.js project
- The hosted MCP at mcp.saleor.app only connects to *.saleor.cloud instances; self-hosters run saleor-mcp themselves
- The MCP is read-only and needs a token with MANAGE_PRODUCTS and MANAGE_ORDERS

## Editions

- Saleor OSS: Free, open source
  - source: https://github.com/saleor/saleor
  - container: docker compose up
- Saleor Cloud Sandbox: Free, closed source
  - hosted: https://cloud.saleor.io/signup
- Saleor Cloud Select: $1,599 per month, closed source
  - hosted: https://saleor.io/pricing
- Saleor Cloud Volume: $3,999 per month, closed source
  - hosted: https://saleor.io/pricing

## Adaptable: make it yours

Effort: light-edit (8 things to edit)

Run the core from Docker with .env; the named env vars cover secrets, database/cache/broker URLs, email, and the dashboard origin. Store behavior (channels, pricing, shipping) is configured through the API or dashboard, not files. Adapting to a real shop also means pulling or building a separate storefront, which is why this is not config-only.

- Env vars: SECRET_KEY, CACHE_URL, CELERY_BROKER_URL, DASHBOARD_URL, DEFAULT_FROM_EMAIL, EMAIL_URL, HTTP_IP_FILTER_ALLOW_LOOPBACK_IPS
- Config files: .env
- Prompt files: none
- Accounts you'll need: Saleor Cloud (hosted editions only)

## Operable: what an agent can drive

Operability: official. Interface: mcp at https://mcp.saleor.app/ (published by the builder, both).

### Reach (partial coverage)

- Read products and catalog: reachable. saleor-mcp README: fetch data about products; token needs MANAGE_PRODUCTS
- Read orders: reachable. saleor-mcp README: fetch data about orders; token needs MANAGE_ORDERS
- Read customers: reachable. saleor-mcp README: fetch data about customers
- Create and update products: not reachable. saleor-mcp README: 'The MCP is read-only - it doesn't trigger any mutations'; use the GraphQL API
- Fulfil, cancel, or refund orders: not reachable. read-only MCP; GraphQL mutations only
- Run a checkout: not reachable. read-only MCP; checkout mutations live in the GraphQL API
- Manage promotions and vouchers: not reachable. read-only MCP
- Configure channels, warehouses, shipping: not reachable. read-only MCP
- Install apps and webhooks: not reachable. read-only MCP

## Code stack

- Languages: Python
- Frameworks: Django, GraphQL (Ariadne)
- Package manager: none
- Database: PostgreSQL
- Hosting target: Docker, Saleor Cloud

## Skills

contributor: Repo tooling for Saleor contributors: Django migrations, GraphQL API changes, commits, PR checklist.
- Paths: .claude/skills/*/SKILL.md

## Evidence and confidence

- formFactor: README: 'Headless and API only - APIs are the only way to interact' (confidence 0.95)
- executionModel: no model dependency in the core; deterministic commerce engine (confidence 0.95)
- operability: saleor/saleor-mcp under the same GitHub org, hosted at mcp.saleor.app (confidence 0.95)
- effort: .env.example names 7 vars; storefront must be added separately (confidence 0.7)
- editions: saleor.io/pricing: OSS free, Sandbox free non-commercial, Select $1,599/mo, Volume $3,999/mo, Enterprise custom (confidence 0.85)
- active: pushedAt 2026-09-02; saleor-mcp pushed 2026-09-01
- reach:  (confidence 0.85)

## Open questions

- Which Saleor Cloud plans include MCP access
- Exact tool names exposed by saleor-mcp (README describes scope, not names)

## Sources

- https://github.com/saleor/saleor (sourcing:ecommerce:github)
- https://github.com/saleor/saleor-mcp (sourcing:ecommerce:github)
- https://saleor.io/pricing (analysis)