Skip to content
Back to search

widgetis-mcp

MCP server for Widgetis: an AI agent changes the widgets of a Horoshop online store (free-shipping bar, cart upsell, popups)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/widgetis--widgetis-mcp/badge.svg)](/listings/widgetis--widgetis-mcp)

HTML

<a href="/listings/widgetis--widgetis-mcp"><img src="/api/listings/widgetis--widgetis-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 128 lines
  1. # Widgetis MCP: віджети магазину на Хорошоп через AI-агента
  2. [Widgetis](https://widgetis.com/?utm_source=github&utm_medium=referral&utm_campaign=mcp-repo) робить готові віджети для інтернет-магазинів на Хорошоп (Horoshop): смугу «до безкоштовної доставки залишилось N грн», рекомендації в кошику, акцію 1+1=3, таймери, попапи, значки довіри та інші. Цей MCP-сервер дає AI-агенту (Claude Code, Cursor, VS Code або інший MCP-клієнт з HTTP-транспортом) ті самі дії, що власник магазину робить у кабінеті Widgetis: увімкнути віджет, змінити поріг, колір чи текст.
  3. *English version below.*
  4. ```
  5. Ви: «Постав поріг безкоштовної доставки 1500 грн і зміни текст смуги»
  6. Агент ──▶ agents.widgetis.com/mcp ──▶ кабінет Widgetis ──▶ віджет на сайті оновлено
  7. ```
  8. ## Що вміє
  9. | Інструмент | Що робить |
  10. | --- | --- |
  11. | `get_my_site` | Ваш магазин: домен, чи стоїть скрипт Widgetis на сторінках, які віджети є |
  12. | `describe_widget` | Як працює віджет і які налаштування та тексти можна змінити |
  13. | `get_widget` | Поточний стан віджета: увімкнений чи ні, налаштування, тексти |
  14. | `enable_widget` | Увімкнути віджет на сайті |
  15. | `disable_widget` | Вимкнути віджет (налаштування зберігаються) |
  16. | `update_widget_config` | Змінити налаштування: поріг, кольори, позицію, умови показу |
  17. | `set_widget_translations` | Змінити тексти віджета для однієї мови (ua, ru, en) |
  18. Кожна зміна перевіряється за схемою віджета ще до збереження. Агент не може записати поле, якого немає, або значення поза межами.
  19. ## Як підключити
  20. 1. Зареєструйтесь на [widgetis.com](https://widgetis.com/?utm_source=github&utm_medium=referral&utm_campaign=mcp-repo) і додайте свій магазин на Хорошоп.
  21. 2. У кабінеті відкрийте сторінку віджетів, картка **«Ключ для AI-агента»**, кнопка **«Створити ключ»**. Ключ доступний на всіх тарифах, і на безкоштовному Free теж.
  22. ![Картка «Ключ для AI-агента» в кабінеті Widgetis з кнопкою «Створити ключ»](docs/images/agent-key-create.png)
  23. 3. Скопіюйте ключ одразу: кабінет показує його один раз. Ключ починається з `wgt_site_` і діє 90 днів. Поруч готові команда для Claude Code і налаштування для Cursor, кнопка «Скопіювати» бере їх разом із ключем.
  24. ![Створений ключ: команда для Claude Code і налаштування для Cursor](docs/images/agent-key-issued.png)
  25. <details><summary>Те саме на телефоні</summary>
  26. <img src="docs/images/agent-key-phone.png" alt="Картка ключа в кабінеті Widgetis на телефоні" width="320">
  27. </details>
  28. 4. Додайте сервер у свій клієнт.
  29. **Claude Code**
  30. ```bash
  31. claude mcp add --scope user --transport http widgetis https://agents.widgetis.com/mcp \
  32. --header "Authorization: Bearer wgt_site_ВАШ_КЛЮЧ"
  33. ```
  34. **Cursor** (`~/.cursor/mcp.json`) та інші клієнти з `mcpServers`:
  35. ```json
  36. {
  37. "mcpServers": {
  38. "widgetis": {
  39. "type": "http",
  40. "url": "https://agents.widgetis.com/mcp",
  41. "headers": { "Authorization": "Bearer wgt_site_ВАШ_КЛЮЧ" }
  42. }
  43. }
  44. }
  45. ```
  46. **VS Code** (`.vscode/mcp.json`):
  47. ```json
  48. {
  49. "servers": {
  50. "widgetis": {
  51. "type": "http",
  52. "url": "https://agents.widgetis.com/mcp",
  53. "headers": { "Authorization": "Bearer wgt_site_ВАШ_КЛЮЧ" }
  54. }
  55. }
  56. }
  57. ```
  58. Нічого встановлювати не треба: сервер працює у нас. Покрокова інструкція зі скріншотами: [AI-агент для віджетів Хорошоп](https://widgetis.com/blog/ai-agent-dlya-vidzhetiv-horoshop?utm_source=github&utm_medium=referral&utm_campaign=mcp-repo).
  59. ## Приклади запитів агенту
  60. - «Які віджети зараз увімкнені на моєму сайті?»
  61. - «Увімкни смугу безкоштовної доставки від 2000 грн, колір зелений»
  62. - «Зміни текст попапу на "Знижка 10% на перше замовлення" для української та російської версій»
  63. - «Вимкни таймер акції, акція закінчилась»
  64. ## Безпека
  65. - Ключ діє лише для одного магазину: агент міняє будь-які налаштування й тексти віджетів цього магазину на будь-якому тарифі, і на Free теж. Скільки віджетів увімкнено одночасно, задає тариф.
  66. - Ключ можна відкликати в кабінеті будь-коли, він перестає працювати одразу.
  67. - Сервер не зберігає ключ: кожен запит несе свій ключ і йде лише до API Widgetis.
  68. - Ліміти: 120 запитів на хвилину з одного ключа; після 10 невірних ключів адреса блокується на 10 хвилин.
  69. ## Посилання
  70. - Сайт: [widgetis.com](https://widgetis.com/?utm_source=github&utm_medium=referral&utm_campaign=mcp-repo)
  71. - Каталог віджетів: [widgetis.com/widgets](https://widgetis.com/widgets?utm_source=github&utm_medium=referral&utm_campaign=mcp-repo)
  72. - Тарифи: [widgetis.com/pricing](https://widgetis.com/pricing?utm_source=github&utm_medium=referral&utm_campaign=mcp-repo)
  73. - Підтримка: [Telegram @widgetis](https://t.me/widgetis), hello@widgetis.com
  74. ---
  75. ## English
  76. **Widgetis MCP server** lets an AI agent manage the widgets of an online store on [Horoshop](https://horoshop.ua), a Ukrainian e-commerce platform. [Widgetis](https://widgetis.com/?utm_source=github&utm_medium=referral&utm_campaign=mcp-repo) provides ready-made store widgets: a free-shipping progress bar, cart recommendations, a 1+1=3 promotion, countdown timers, popups, trust badges and more.
  77. The server is hosted at `https://agents.widgetis.com/mcp` (streamable HTTP). It exposes seven tools: `get_my_site`, `describe_widget`, `get_widget`, `enable_widget`, `disable_widget`, `update_widget_config`, `set_widget_translations`. Every write is validated against the widget's JSON Schema before it is saved.
  78. **Connect:** create a key in the Widgetis cabinet (widgets page, card «Ключ для AI-агента», button «Створити ключ», every plan including Free). The key is shown once, next to a ready command for Claude Code and a config for Cursor:
  79. ![The issued key with the Claude Code command and the Cursor config](docs/images/agent-key-issued.png)
  80. Then:
  81. ```bash
  82. claude mcp add --scope user --transport http widgetis https://agents.widgetis.com/mcp \
  83. --header "Authorization: Bearer wgt_site_YOUR_KEY"
  84. ```
  85. A key works for one store only and changes any setting or text of that store's widgets on every plan, Free included; the plan sets how many widgets are on at once. It can be revoked at any time. The server keeps no credentials.
  86. The cabinet, the widgets and the support are in Ukrainian. Questions: hello@widgetis.com or [Telegram @widgetis](https://t.me/widgetis).
  87. ## License
  88. The documentation in this repository is published under the MIT License, see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.