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

Give an MCP-compatible tool access to the Saleor GraphQL schema.

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

Saleor publishes five Agent Skills with focused implementation guidance:

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

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

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

The Documentation MCP above answers questions from the Saleor documentation. To work with the Saleor GraphQL schema through MCP, run a GraphQL MCP server separately and point it at a downloaded Saleor schema.

For example, with mcp-graphql:

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

Download the schema from the documentation or from the Saleor repository. The main branch schema can contain unreleased changes, so prefer the schema matching your Saleor version.

Configuration locations vary by client:

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