Skip to content
MCP server

Horoshop MCP

Unofficial server for Horoshop (Хорошоп) stores: catalog, orders, SEO, feeds, admin. 118…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.3.0
Listing updated
5 days ago

About Horoshop MCP

Horoshop MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Unofficial server for Horoshop (Хорошоп) stores: catalog, orders, SEO, feeds, admin. 118 tools.

Install

Run in a terminal

claude mcp add horoshop-mcp --env HOROSHOP_STORES_FILE='<HOROSHOP_STORES_FILE>' -- npx -y https://github.com/IgorShutko/horoshop-mcp/releases/download/v0.3.0/horoshop-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "horoshop-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/IgorShutko/horoshop-mcp/releases/download/v0.3.0/horoshop-mcp.mcpb"
      ],
      "env": {
        "HOROSHOP_STORES_FILE": "<HOROSHOP_STORES_FILE>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "horoshop-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/IgorShutko/horoshop-mcp/releases/download/v0.3.0/horoshop-mcp.mcpb"
      ],
      "env": {
        "HOROSHOP_STORES_FILE": "<HOROSHOP_STORES_FILE>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "horoshop-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/IgorShutko/horoshop-mcp/releases/download/v0.3.0/horoshop-mcp.mcpb"
      ],
      "env": {
        "HOROSHOP_STORES_FILE": "<HOROSHOP_STORES_FILE>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "horoshop-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/IgorShutko/horoshop-mcp/releases/download/v0.3.0/horoshop-mcp.mcpb"
      ],
      "env": {
        "HOROSHOP_STORES_FILE": "<HOROSHOP_STORES_FILE>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "horoshop-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/IgorShutko/horoshop-mcp/releases/download/v0.3.0/horoshop-mcp.mcpb"
      ],
      "env": {
        "HOROSHOP_STORES_FILE": "<HOROSHOP_STORES_FILE>"
      }
    }
  }
}

Configuration

  • HOROSHOP_STORES_FILEAbsolute path to a JSON file mapping store name to { baseUrl, login, password }.Required
  • HOROSHOP_DEFAULT_STOREStore used when a tool call omits the store argument. Set automatically when only one store is configured.
  • HOROSHOP_TIMEOUT_MSPer-request timeout in milliseconds. Default 120000, because catalog imports with images are slow.

Pricing

Open source

Prices change. Check igorshutko.github.io before you buy.

Horoshop MCP FAQ

Is Horoshop MCP free?

Yes. Horoshop MCP is open source, so you can use and self-host it for free.

How do I add Horoshop MCP to Claude Code?

Run this command in your terminal: claude mcp add horoshop-mcp --env HOROSHOP_STORES_FILE='<HOROSHOP_STORES_FILE>' -- npx -y https://github.com/IgorShutko/horoshop-mcp/releases/download/v0.3.0/horoshop-mcp.mcpb