Agents

Use these resources to give AI agents accurate, task-specific context about Saleor.

If you are an AI agent, start here: llms.txt.

Documentation MCP

Search and read Saleor documentation from an MCP-compatible agent.

Agent Skills

Add Saleor workflows and implementation guidance to your agent.

Saleor MCP

Connect AI assistants and agents to your live Saleor store data.

Documentation MCP

The Documentation MCP is a read-only server for this documentation site. It lets agents:

search the documentation;
read a page as agent-optimized Markdown;
list available pages; and
inspect the documentation navigation.

Connect an MCP-compatible client to:

https://docs.saleor.io/mcp

For clients that use JSON configuration:

{
  "mcpServers": {
    "saleor-docs": {
      "url": "https://docs.saleor.io/mcp"
    }
  }
}

This endpoint searches and reads documentation. It does not connect to a Saleor instance or execute GraphQL operations.

MCP discovery metadata is available at:

Agent Skills

Give your coding agent Saleor workflows and implementation guidance. Run this from your project, then choose the skills and agents to install:

npx skills add saleor/saleor-docs

Skills install into the current project by default. Add -g to make them available across projects.

Browse each skill’s source and supporting files on GitHub:

Skill	Use it for
`saleor-app`	Apps, registration, permissions, payments, and webhooks
`saleor-storefront`	Storefront API patterns, checkout, channels, and variants
`storefront-builder`	Storefront data contracts and user experience
`saleor-configurator`	Store configuration as code
`saleor-core`	Saleor backend internals and implementation details

To install a specific skill:

npx skills add saleor/saleor-docs --skill saleor-app

For more options, see the Skills CLI reference.

For Automated Discovery

Compatible agents can discover the skills and their downloadable bundles at:

https://docs.saleor.io/.well-known/agent-skills/index.json

Saleor MCP

To let AI assistants and agents work with live store data on Saleor Cloud, use the Saleor MCP app.

Self-Hosted Saleor

If you run Saleor yourself, use the open-source, read-only Saleor MCP server. See its README for setup.

GraphQL Schema Only

To give an agent the Saleor GraphQL schema without connecting to a store, point a GraphQL MCP server, such as mcp-graphql, at a downloaded schema:

{
  "mcpServers": {
    "saleor-api": {
      "command": "npx",
      "args": ["mcp-graphql"],
      "env": {
        "SCHEMA": "/path/to/saleor.graphql"
      }
    }
  }
}

Download the schema matching your Saleor version from the documentation or the Saleor repository.

Configuration locations vary by client:

VS Code: .vscode/mcp.json — configuration guide
Cursor: .cursor/mcp.json — configuration guide
JetBrains IDE configuration guide