Plan first, write second
57 of the 71 write tools only show what would change. Applying it is a separate step with dryRun:false.
Horoshop MCP connects Claude, Cursor, Codex and other AI agents to your store on Horoshop, the Ukrainian e-commerce platform. Catalog, orders, SEO, redirects, marketplace feeds, settings. The server runs on your machine and your credentials stay in your own file.
npx -y github:IgorShutko/horoshop-mcp
On Claude Desktop? Download horoshop-mcp.mcpb and open it: the server installs itself, no terminal needed.
Set the SEO title and description for the Sneakers category in Ukrainian and Russian. Show me the plan first.
what a person asks the agent
| Field | Currently in the store | Will become |
|---|---|---|
| title, uk | Кросівки | Кросівки чоловічі та жіночі - купити в Дніпрі | REBUS+ |
| description, uk | empty | Кросівки для міста і залу. Розміри 36-46, приміряння при отриманні, доставка Новою поштою. |
| title, ru | Кроссовки | Кроссовки мужские и женские - купить в Днепре | REBUS+ |
| h1 | Кросівки | unchanged |
Nothing has been saved. To apply it the agent must repeat the call with dryRun:false.
| Section | Examples | Tools |
|---|---|---|
| Setup and diagnostics | store list, access check | 2 |
| Catalog | product export and import, image linking | 4 |
| Orders | orders with UTM, status changes | 3 |
| Categories, customers, product sets | category tree, customers, bundles | 5 |
| Payment, delivery, currency | payment and delivery methods, rates | 5 |
| B2B: groups and price levels | customer groups, price levels | 2 |
| Webhooks | store event subscriptions | 2 |
| Storefront: cart and checkout | the buyer's real cart, coupons | 6 |
| Admin: generic engine | read or save any admin record | 6 |
| Admin: orders and analytics | order editing, waybills, dashboard | 8 |
| Admin: products, prices, images | bulk price changes with rollback, stock | 9 |
| Admin: characteristics and dictionaries | characteristic schemas, templates, translations | 15 |
| Admin: categories, pages, blog, banners, filters | category SEO text, articles, banners | 12 |
| Admin: SEO, sitemap, redirects | canonical, robots.txt, 301s with loop checks | 11 |
| Admin: marketplace feeds | Rozetka, Hotline, Google, Facebook, Kasta | 6 |
| Admin: design and localization | theme, custom CSS, interface languages | 8 |
| Admin: settings, marketing, fiscal receipts | contacts, GTM and Pixel, coupons, Checkbox | 14 |
Plus seven ready-made scenarios your AI client lists in its own menu: store health, category SEO, products without photos, orders digest, feeds, redirects, price change with rollback. Pick one, fill in a field, and the agent follows a proven sequence. The full tool list with every parameter lives in the repository.
57 of the 71 write tools only show what would change. Applying it is a separate step with dryRun:false.
Deleting orders, changing a feed alias, running a price import and bulk price edits all require an explicit confirmation, and price changes return rollback parameters.
Horoshop sometimes answers "saved" having saved nothing. Tools therefore read the result back, often through a different channel.
The server only talks to your store's domain. Values that look like keys or tokens are masked in responses.
Check in a terminal. If the command prints nothing, install Node.
node -vIn the Horoshop control panel create a separate admin for the agent: the same login and password works for both the API and the admin tools.
Save stores.json somewhere only you can read.
{
"myshop": { "baseUrl": "https://myshop.com.ua", "login": "api-user", "password": "REPLACE_ME" }
}Claude Code needs a single command. Ready-made configs for the other clients are in the install guide.
claude mcp add horoshop -s user -e HOROSHOP_STORES_FILE=/abs/path/to/stores.json -- npx -y github:IgorShutko/horoshop-mcp