horoshop-mcp-server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@horoshop-mcp-server list orders from today"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Unofficial Horoshop MCP Server
An unofficial MCP server for stores built on Horoshop.
This project connects AI agents, internal assistants, and MCP-compatible clients to the Horoshop API through a practical Model Context Protocol server. It is designed for teams that run e-commerce operations on Horoshop and want language models to interact with store data in a controlled, tool-based way.
This project is not affiliated with, endorsed by, or maintained by Horoshop. It is a community-built integration for the Horoshop ecosystem.
Why This Exists
Horoshop gives merchants a hosted e-commerce platform at horoshop.ua, but AI tools still need a reliable way to access store operations such as orders, catalog data, and order status updates. MCP is a good fit for that layer because it lets LLMs call clearly defined tools instead of improvising against raw APIs.
This server turns the Horoshop API into MCP tools that can be used from clients like Claude Desktop, Cursor, and other agent frameworks that support MCP over stdio.
Related MCP server: SellerChamp MCP Server
Real Use Cases
This server is useful when you want AI to do real operational work around a Horoshop store, for example:
customer support assistants that look up an order, confirm its current status, and hand back structured answers to an operator
back-office agents that review new orders and move them into the next processing state
catalog helpers that inspect product data before content updates or merchandising tasks
internal dashboards where AI can answer questions like "show me the latest orders from today" or "find the product by ID and summarize its current state"
automation flows that need a safe bridge between natural-language prompts and Horoshop API methods
store operations copilots that combine Horoshop data with CRM, ERP, shipping, or analytics tooling
What The Server Does
The current implementation provides a compact but useful starting point:
authenticates against the Horoshop API using either a token or login/password credentials
exposes MCP tools for listing and fetching orders
exposes MCP tools for listing and fetching products
supports updating order status from an MCP client
includes a generic passthrough tool for calling arbitrary Horoshop API functions
This gives you enough to start with real workflows while keeping the codebase small enough to extend quickly.
Example Agent Workflows
With this MCP server, an agent can support workflows such as:
"Find order
12345and tell me whether it has already moved to the shipped status.""List the newest orders and summarize which ones need manual attention."
"Fetch product
9876and prepare a short product brief for a support manager.""Update order
12345to status7after warehouse confirmation.""Call a custom Horoshop API function that is not wrapped yet, then return the raw payload for inspection."
Environment
Copy .env.example to .env and configure:
HOROSHOP_BASE_URL: your Horoshop store domain, for examplehttps://your-store.example.comHOROSHOP_LOGIN: API login created in the Horoshop admin panelHOROSHOP_PASSWORD: API password created in the Horoshop admin panelHOROSHOP_TOKEN: optional token if you already use token-based access
You need either:
HOROSHOP_TOKEN
or:
HOROSHOP_LOGINHOROSHOP_PASSWORD
Install
npm installRun
npm run build
npm startFor development:
npm run devMCP Configuration Example
{
"mcpServers": {
"horoshop": {
"command": "node",
"args": [
"D:/usr/www/mcp-dev/horoshop/dist/index.js"
],
"env": {
"HOROSHOP_BASE_URL": "https://your-store.example.com",
"HOROSHOP_LOGIN": "api-login",
"HOROSHOP_PASSWORD": "api-password"
}
}
}
}Available Tools
horoshop_auth: verify authentication and confirm token accesshoroshop_list_orders: list orders using Horoshop order export functionshoroshop_get_order: fetch one order by IDhoroshop_list_products: list products using Horoshop catalog export functionshoroshop_get_product: fetch one product by IDhoroshop_update_order_status: change the status of an orderhoroshop_call_api: call any Horoshop API function with arbitrary JSON parameters
Who This Is For
This project is a strong fit for:
Horoshop merchants who want AI assistants to work with store operations
agencies building AI-enabled tooling for Horoshop clients
developers integrating Horoshop into MCP-based automation stacks
teams that want a base server they can customize for their own business rules
Current Scope
This repository focuses on the operational core first: authentication, orders, products, status updates, and a raw API escape hatch.
That means it is intentionally useful on day one, but not yet a complete wrapper for the full Horoshop API surface. The generic horoshop_call_api tool is included specifically so you can validate store-specific behavior and extend the server safely as new requirements appear.
Notes
The server assumes the Horoshop API endpoint pattern:
https://<domain>/api/<function>/
If your store exposes different function names or request shapes than the defaults currently wrapped in this repository, use horoshop_call_api first and then extend src/index.ts.
Source
Horoshop website: https://horoshop.ua/
Available Tools
7 toolshoroshop_authVerify Horoshop authenticationC
Authenticates with Horoshop and returns token metadata.
Inputs: force_refresh.
horoshop_call_apiCall Horoshop APIC
Calls any Horoshop API function with arbitrary JSON parameters.
Inputs: function_name (required), params.
horoshop_get_orderGet orderB
Returns a single order by id using the Horoshop API.
Inputs: order_id (required).
horoshop_get_productGet productB
Returns a product by id using the Horoshop API.
Inputs: product_id (required).
horoshop_list_ordersList ordersC
Returns orders using the Horoshop orders/export endpoint.
Inputs: filters.
horoshop_list_productsList productsC
Returns products using the Horoshop catalog/export endpoint.
Inputs: filters.
horoshop_update_order_statusUpdate order statusC
Updates an order status using the Horoshop API.
Inputs: order_id (required), status_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Most tools are clearly distinct (list vs get, orders vs products), and auth is separate. However, horoshop_call_api is a catch-all that could overlap with any tool, introducing some ambiguity about when to use it versus the specific tools.
All tools follow the consistent pattern horoshop_ + verb + noun (e.g., list_orders, get_order, update_order_status). The only minor deviation is horoshop_auth, but it is still a recognizable action and fits the style.
With 7 tools, the count is well-scoped for a typical e-commerce API integration. Each tool covers a distinct core operation without unnecessary bloat or sparseness.
The core workflows for orders (list, get, update status) and products (list, get) are covered. Missing product creation/update and order creation are notable, but the horoshop_call_api fallback fills these gaps, making the surface reasonably complete.
Maintenance
Related MCP Connectors
Hosted MCP for e-commerce: live product catalog, stock, and pricing for AI agents.
Unified MCP server for 70+ eCommerce platforms: products, orders, customers, and more.
Official MCP server for Agentwork — delegate tasks to AI agents with human-in-the-loop
MCP server for Pinchwork - an agent-to-agent task marketplace with credits-based economy
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceA Shopify-focused MCP server that enables AI agents to manage store operations like order tracking, product discovery, and checkout link generation. It facilitates customer-facing interactions including shipping estimates and real-time inventory searches.-
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI agents to manage multi-marketplace e-commerce operations by connecting to the SellerChamp API. It supports inventory reporting, cross-listing analysis, order management, and bulk updates across platforms like Amazon, eBay, and Shopify.MIT
- AlicenseBqualityDmaintenanceA production-grade MCP server for the WooCommerce REST API, enabling AI assistants to manage products, orders, customers, and store settings.3417 PyPI1MIT
- FlicenseNot gradedqualityDmaintenanceA proof of concept MCP server that gives AI agents business context for e-commerce operations including orders, inventory, logistics, returns, claims, and payments.2-