Pyro Storefront 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., "@Pyro Storefront MCP Server Підбери салют до 3500 грн, калібр від 30 мм, від 30 пострілів."
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.
Pyro Storefront MCP Server 🎆
Офіційний клієнтський MCP-сервер (Model Context Protocol) для інтернет-магазину піротехніки та салютів pyro.ua.
Дозволяє автономним ІІ-агентам (Claude Desktop, Cursor, Cline, Windsurf, ChatGPT Desktop) підбирати феєрверки за технічними характеристиками (калібр, кількість пострілів, тривалість, бюджет), перевіряти складські залишки, знаходити найближчі відділення і поштомати Нової Пошти та безпечно оформляти замовлення з миттєвим онлайн-чекаутом через Monobank.
⚡ Швидке підключення (1-Click Run)
Сервер повністю автономний, зібраний у єдиний виконуваний бандл і не потребує ручного встановлення залежностей.
🟣 1. Claude Desktop
Додайте в конфігураційний файл claude_desktop_config.json:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"pyro-storefront": {
"command": "npx",
"args": ["-y", "github:pyroua/pyro-storefront-mcp"]
}
}
}🔵 2. Cursor / Windsurf
Додайте в .cursor/mcp.json:
{
"mcpServers": {
"pyro-storefront": {
"command": "npx",
"args": ["-y", "github:pyroua/pyro-storefront-mcp"]
}
}
}Related MCP server: Commerce MCP Server
🛠️ Доступні інструменти (Tools)
Інструмент | Опис |
| Пошук піротехніки за бюджетом, калібром (мм), кількістю пострілів та ключовими словами |
| Детальні ТТХ товару: опис, фото, відео роботи, безпечна дистанція, інструкція |
| Пакетна перевірка залишків на складі та розрахунок підсумкової вартості |
| Пошук відділень і поштоматів Нової Пошти в обраному місті України |
| Оформлення роздрібного замовлення з генерацією захищеного посилання на оплату Monobank |
| Перевірка статусу замовлення та ТТН за номером замовлення та 4 останніми цифрами телефону |
💬 Приклади запитів для вашого AI-асистента
«Підбери салют на день народження до 3500 грн, від 30 мм калібру, не менше ніж на 30 пострілів. Покажи відео та ціну.»
«Знайди поштомати Нової Пошти у Києві біля станції метро Мінська.»
«Оформи замовлення на салют №508 на ім'я Ігор Шульга (+380501234567) з доставкою до поштомату №1263 у Києві. Мені є 18 років.»
«Який статус мого замовлення №72901? Мій номер закінчується на 4567.»
🛡️ Безпека та захист даних (Enterprise Gold Standard)
DLP & Нульовий витік комерційної таємниці: Сервер має сувору ізоляцію від внутрішніх систем. Собівартість, маржа та дані постачальників недоступні клієнтському MCP.
Захист від перебору (Anti-Enumeration): Метод
track_orderвимагає обов'язкового збігу останніх 4 цифр телефону. Номери телефонів у відповідях маскуються (+380 50 *** ** 67).Age Gate (18+): Замовлення створюються виключно за умови явної підтвердженої згоди клієнта про досягнення повноліття (
confirmed_legal_age: true).Ідемпотентність: Запобігання повторним списанням та дублюванню замовлень завдяки
Idempotency-Key.
💻 Локальна розробка
# Клонування репозиторію
git clone https://github.com/pyroua/pyro-storefront-mcp.git
cd pyro-storefront-mcp
# Встановлення залежностей
npm install
# Збірка самодостатнього бандла
npm run bundle
# Локальний запуск
node dist/index.js📄 Ліцензія
Available Tools
6 toolscheck_stock_availabilityA
Пакетная проверка доступности товаров на складе и расчет итоговой суммы заказа перед чекаутом
Inputs: items (required).
create_orderC
Оформление заказа в pyro.ua с мгновенной ссылкой на оплату картой (Monobank) или наложенным платежом
Inputs: city (required), phone (required), last_name (required), cart_items (required), +10 more.
get_firework_detailsA
Получить полные характеристики салюта (калибр, видео работы, время, безопасная дистанция, инструкция)
Inputs: product_id (required).
search_delivery_branchesA
Поиск отделений и почтоматов Новой Почты в указанном городе для доставки заказа
Inputs: city_name (required), branch_type.
search_fireworksB
Поиск пиротехники и салютов в каталоге pyro.ua по бюджету, калибру, количеству залпов и времени работы
Inputs: q, page, limit, caliber, +5 more.
track_orderA
Отслеживание статуса готовности заказа и номера ТТН Новой Почты с защитой от перебора (DLP)
Inputs: order_id (required), phone_last4 (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool maps to a distinct stage or resource: catalogue search, item details, stock validation, delivery branch lookup, order creation, and order tracking. The only potential overlap is between search_fireworks and get_firework_details, but their purpose is clearly separated by list-level vs. detail-level access.
All tools follow a consistent verb_noun snake_case pattern: get_, search_, check_, track_, create_. This makes the toolset predictable and easy to reason about, with no mixed conventions or vague generic verbs.
Six tools is well-scoped for a storefront server: search, details, stock, delivery, ordering, and tracking each earn their place. The surface is neither bloated nor too thin for the stated purpose.
The core customer journey is covered end-to-end: find products, inspect them, verify stock, choose a delivery branch, place an order, and track it. Minor gaps exist such as no explicit order details endpoint or cancellation flow, but agents can complete the main purchase workflow without dead ends.
Maintenance
Related MCP Connectors
Ukraine payments for AI agents — LiqPay cards / Apple Pay via LiqPay. Never holds funds.
Demo AI-first shop: search products, fill a cart and prepare the order (test payments).
AI-agent product catalog: search, lookup & purchase routing over verified merchant data.
Run your online shop from your AI: products, prices, stock and orders. Payouts via your own Stripe.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to accept payments in Ukraine via LiqPay (cards, Apple Pay, Google Pay). Provides tools to create hosted checkout links and query payment status.MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to browse product catalogs, search products with filters, and initiate checkouts, generating order summaries and checkout URLs.-
- AlicenseAqualityBmaintenanceEnables AI assistants to search real products, purchase with user approval, track deliveries, and run a seller business end to end via the Firestarter commerce platform.8941 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables product discovery, session-scoped carts, and confirmation-gated checkout through natural language, with deterministic routing and safety features.ISC