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

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

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