Skip to main content
Glama
keycrm-mcp

keycrm-mcp

by IgorShutko

KeyCRM MCP: неофіційний MCP-сервер для KeyCRM

Українська · Русский · English

CI License: MIT Python MCP Tools Routes

KeyCRM MCP: ШІ-агент працює з KeyCRM через 24 інструменти і 572 маршрути внутрішнього API

KeyCRM MCP (keycrm-mcp): безкоштовний MCP-сервер з відкритим кодом, який підключає ШІ-агентів Claude, Cursor, Codex та інших до KeyCRM. Сервер працює на вашому комп'ютері й дає агенту ліди та воронки, замовлення, покупців, товари, склад, задачі, чати, фінанси й налаштування. Він поєднує офіційний OpenAPI з внутрішнім API вебінтерфейсу: 572 маршрути, яких в офіційній документації немає.

Неофіційний проєкт. KeyCRM MCP не є продуктом компанії KeyCRM, не пов'язаний з нею і нею не підтримується. Внутрішній API недокументований: KeyCRM може змінити його з будь-яким оновленням інтерфейсу. Нові сценарії спершу перевіряйте на тестовому акаунті.

  • 24 інструменти замість сотень дрібних: кожен покриває цілу сутність через параметр action.

  • Два канали до одного акаунта. Офіційний OpenAPI для замовлень, покупців і каталогу, внутрішній API для всього іншого. Сервер сам обирає потрібний.

  • 572 маршрути внутрішнього API в каталозі з пошуком. Якщо окремого інструмента немає, агент знаходить маршрут і викликає його напряму.

  • Запобіжники. Видалення карток воронки заблоковане на рівні сервера, небезпечні масові запити теж. Перед ризикованою дією агент робить локальний знімок акаунта.

  • Локально. Сервер працює через stdio, доступи лежать у змінних середовища, телеметрії немає.

Зміст

Документація (російською): швидкий старт · довідник інструментів · карта двох API · як відновлювали внутрішній API · рецепти на Python · статус усіх 572 маршрутів.

Related MCP server: Kommo MCP Server

Швидкий старт

1. Що потрібно. uv (він сам поставить Python 3.11 або новіший) і Git.

2. Доступи. Піддомен акаунта (для myshop.keycrm.app це myshop), e-mail і пароль користувача KeyCRM. Сервер перевірений під обліковим записом власника акаунта.

3. Підключіть ШІ-клієнт. Клонувати репозиторій не потрібно.

Claude Code:

claude mcp add keycrm -s user -e KEYCRM_DOMAIN=myshop -e KEYCRM_EMAIL=you@example.com -e KEYCRM_PASSWORD=REPLACE_ME -- uvx --from git+https://github.com/IgorShutko/keycrm-mcp keycrm-mcp

Codex:

codex mcp add keycrm --env KEYCRM_DOMAIN=myshop --env KEYCRM_EMAIL=you@example.com --env KEYCRM_PASSWORD=REPLACE_ME -- uvx --from git+https://github.com/IgorShutko/keycrm-mcp keycrm-mcp

Claude Desktop (claude_desktop_config.json), Cursor (~/.cursor/mcp.json), Windsurf та більшість інших клієнтів:

{
  "mcpServers": {
    "keycrm": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/IgorShutko/keycrm-mcp", "keycrm-mcp"],
      "env": {
        "KEYCRM_DOMAIN": "myshop",
        "KEYCRM_EMAIL": "you@example.com",
        "KEYCRM_PASSWORD": "REPLACE_ME"
      }
    }
  }
}

Щоб закріпити версію, додайте тег до адреси: git+https://github.com/IgorShutko/keycrm-mcp@v0.1.0. Перший запуск завантажує залежності, це займає до пів хвилини.

4. Спробуйте. Попросіть агента:

  • «Перевір підключення до KeyCRM і покажи, скільки в акаунті лідів, замовлень і товарів.»

  • «Покажи воронку: скільки карток у кожному статусі та яка конверсія.»

  • «Знайди картку за телефоном +380501234567 і скажи, на якому вона статусі.»

  • «Які картки зависли без руху понад 7 днів? Згрупуй за менеджерами.»

  • «Створи лід у воронці 1: Іван, +380501234567, бюджет 5000, наступний контакт завтра о 12:00.»

  • «Хто і що змінював у картці 63? Покажи історію.»

Можливості

Інструмент

Що робить

crm_status

Профіль, стан обох каналів, лічильники акаунта. З нього варто починати сесію.

leads

Ліди та воронки: список, створення, оновлення, перенесення між статусами, товари в картці, копіювання.

orders

Замовлення: список, створення, статуси, оплати, витрати, товари, мітки, джерела.

clients

Покупці: пошук, створення, оновлення, історія замовлень і лідів.

products

Товари, категорії, склади.

tasks

Задачі: список, пошук, створення, завершення, прострочені.

conversations

Чати: список, повідомлення, непрочитані, надсилання.

users

Користувачі, ролі, права.

report

Звіти: продажі, ліди, воронка з конверсією, навантаження менеджерів, завислі картки.

audit

Історія змін: хто, що і коли міняв в акаунті, у сутності або за менеджером.

settings

Налаштування акаунта за розділами.

finance

Рахунки, оплати, типи витрат, способи оплати, курси валют, фіскалізація, білінг.

delivery

Довідники Нової Пошти, Укрпошти та Rozetka Delivery: міста, відділення, вулиці, розрахунок вартості.

stocks

Залишки, рухи, інвентаризації, складська статистика.

documents

Документи за Twig-шаблоном: перегляд і справжній PDF.

files

Вкладення замовлень: завантаження частинами до 250 МБ, скачування, відкріплення.

custom_fields

Додаткові поля: опис полів і значення в картках.

comments

Коментарі до лідів, замовлень, покупців і угод.

automations

Тригери й автоматизації, лише читання.

publications

Публікації товарів на маркетплейсах.

crm_api

Запит до будь-якого маршруту обох API, із захистом від небезпечних масових шляхів.

crm_endpoints

Пошук у каталозі 572 внутрішніх маршрутів.

crm_capabilities

Які модулі акаунта активні, ліміти, відомі проблеми й небезпечні місця.

crm_snapshot

Локальний JSON-знімок карток, замовлень, товарів, покупців і довідників перед ризикованою дією.

Усі дії та параметри кожного інструмента: довідник інструментів (російською).

Налаштування

Сервер бере параметри зі змінних середовища або з файлу .env поруч із кодом (шаблон: .env.example).

Змінна

За замовчуванням

Призначення

KEYCRM_DOMAIN

немає, обов'язкова

Піддомен акаунта: myshop для myshop.keycrm.app.

KEYCRM_EMAIL

немає

Логін для внутрішнього API.

KEYCRM_PASSWORD

немає

Пароль для внутрішнього API.

KEYCRM_API_TOKEN

знаходиться автоматично

Ключ офіційного OpenAPI. Якщо порожньо, сервер бере його з налаштувань акаунта через внутрішній API.

KEYCRM_DATA_DIR

папка з кодом

Куди зберігати знімки (backups/) і скачані файли та PDF (exports/). Для запуску через uvx вкажіть свою папку.

KEYCRM_OPENAPI_BASE

https://openapi.keycrm.app/v1

Адреса офіційного API.

Якщо доступів немає, сервер усе одно запускається і показує інструменти, а виклики пояснюють, чого бракує.

Захист від помилкових змін

  • Картки воронки сервер не видаляє. leads(action="remove") повертає помилку з поясненням. Причина: внутрішній маршрут масового видалення за неточного фільтра стирає всі картки вибраних колонок. Так під час розробки зникли 26 карток, їх відновили зі знімка. Розбір: docs/INCIDENT.md.

  • Небезпечні масові шляхи закриті. crm_api не пропускає /batch/leads/execute/remove і будь-які batch-запити з параметром column_ids.

  • Знімок перед ризиком. crm_snapshot зберігає акаунт у локальний JSON. Ключі, токени й паролі в знімку замасковані.

  • Чесні помилки. Сервер повертає статус і текст відповіді KeyCRM, а не вигадує результат. При 401 він сам входить заново, при 429 чекає і повторює до трьох разів.

  • Автоматизації лише для читання. Воронки, статуси, поля, джерела й тригери API не створює: їх налаштовують в інтерфейсі KeyCRM.

Обмеження платформи

Ці обмеження йдуть від KeyCRM, а не від сервера, і виміряні на живому акаунті:

  • Сторінка списку не більша за 50 записів. Внутрішні списки приймають page і per_page, параметр limit здебільшого ігнорують.

  • orderBy не сортує. На /leads, /tasks і /catalog/products порядок однаковий для asc і desc, на кількох інших списках параметр дає 500. Сортуйте на своєму боці.

  • Внутрішній список замовлень може бути порожнім, навіть коли замовлення існують. Тому orders.list читає офіційний API.

  • Ліміти різні. Офіційний ключ: 20 запитів на хвилину. Внутрішній API витримує близько 120.

  • Частина маршрутів відповідає 500 на боці KeyCRM: /finance/payments, /finance/transactions, /delivery/addresses/suggest.

  • Вимкнені модулі повертають порожні списки. Якщо в акаунті не активовані замовлення, чати чи компанії, порожня відповідь не означає втрату даних. Перевірте через crm_capabilities.

  • Масове видалення замовлень асинхронне: об'єкт зникає через 2-5 секунд.

  • Усі дати в UTC.

Повний перелік з подробицями: docs/REVERSE_ENGINEERING.md і docs/API_REFERENCE.md (російською).

Безпека

  • Тримайте доступи у змінних середовища або у файлі .env. Не вставляйте їх у запити до агента чи в аргументи інструментів. .env, backups/ і exports/ додані до gitignore.

  • Сервер звертається лише до <ваш-піддомен>.api.keycrm.app та openapi.keycrm.app. Телеметрії немає.

  • Токени зберігаються тільки в пам'яті процесу.

  • Знімки crm_snapshot містять телефони, суми й листування клієнтів відкритим текстом. Зберігайте папку backups/ локально.

  • Якщо ключ API потрапив у чужі руки, перевипустіть його в налаштуваннях KeyCRM. Якщо пароль, змініть пароль.

  • Повідомляючи про помилку, не вставляйте в issue реальні дані клієнтів чи доступи.

  • Модель безпеки і куди писати про вразливість: SECURITY.md.

Як це працює

flowchart TD
  AI["ШІ-клієнт<br/>Claude · Cursor · Codex"] -->|"MCP, stdio"| S["keycrm-mcp<br/>24 інструменти"]
  S --> G{"Небезпечний<br/>масовий запит?"}
  G -->|"так"| B["Відмова з поясненням"]
  G -->|"ні"| CH["Два канали до акаунта"]
  CH --> O["Офіційний OpenAPI<br/>замовлення, покупці, каталог"]
  CH --> I["Внутрішній API<br/>572 маршрути вебінтерфейсу"]
  O --> K["Ваш акаунт KeyCRM"]
  I --> K
  1. Офіційний OpenAPI (openapi.keycrm.app/v1): авторизація ключем Bearer. Документований і стабільний, але покриває лише частину CRM: 59 операцій. Ключ сервер знаходить сам у налаштуваннях акаунта.

  2. Внутрішній API (<піддомен>.api.keycrm.app): той самий, яким користується вебінтерфейс KeyCRM. Вхід за e-mail і паролем через POST /auth/login, токен живе 24 години й оновлюється автоматично. Карта з 572 маршрутів у 41 групі відновлена з JavaScript-збірки інтерфейсу версії v33.0.10 і лежить у endpoints.json.

Як саме відновлювали внутрішній API, де він поводиться не так, як офіційний, і як повторити розвідку на новій версії: docs/REVERSE_ENGINEERING.md (російською).

Часті запитання

Що таке KeyCRM MCP?

KeyCRM MCP реалізує протокол Model Context Protocol для KeyCRM. Підключений до нього ШІ-агент читає та змінює CRM через 24 інструменти: ліди й воронки, замовлення, покупці, товари, склад, задачі, чати, фінанси, документи й налаштування. Сервер з відкритим кодом працює локально.

Чи є KeyCRM MCP офіційним продуктом KeyCRM?

Ні. KeyCRM MCP розробляється незалежно і не пов'язаний з компанією KeyCRM. Сервер використовує офіційний OpenAPI, а все, чого там немає, робить тими самими запитами, які надсилає вебінтерфейс. Ці внутрішні запити можуть змінитися будь-коли.

Чим KeyCRM MCP відрізняється від офіційного API KeyCRM?

Офіційний OpenAPI має 59 операцій і покриває замовлення, покупців, товари й частину воронок. Внутрішній API вебінтерфейсу має 572 маршрути: задачі, коментарі, історія змін, додаткові поля, файли, документи, довідники доставки, складська аналітика, налаштування. KeyCRM MCP працює з обома й сам обирає надійніший канал для кожної дії.

Які ШІ-асистенти працюють з KeyCRM MCP?

Будь-який MCP-клієнт, який уміє запускати локальний stdio-сервер: Claude Code, Claude Desktop, Cursor, OpenAI Codex, Windsurf, VS Code з GitHub Copilot, Gemini CLI, Zed, Cline та інші.

Що потрібно, щоб підключити KeyCRM?

uv, Git, піддомен акаунта, e-mail і пароль користувача KeyCRM. Додайте сервер у ШІ-клієнт однією командою з розділу «Швидкий старт».

Чи безпечно давати ШІ-агенту доступ до CRM?

Сервер закриває найнебезпечніше: видалення карток воронки і масові запити, які можуть стерти зайве. Перед ризикованою дією агент може зробити локальний знімок акаунта. Решта записів виконується одразу, тому нові сценарії спершу перевіряйте на тестовому акаунті, а в клієнті залиште підтвердження перед викликом інструментів запису.

Чи можна викликати маршрут, для якого немає окремого інструмента?

Так. crm_endpoints шукає в каталозі 572 маршрутів, а crm_api виконує запит до будь-якого з них. Статус перевірки кожного маршруту: docs/ENDPOINTS_STATUS.md.

Скільки коштує KeyCRM MCP?

KeyCRM MCP безкоштовний і поширюється за ліцензією MIT. Платите лише за свій тариф KeyCRM і за ШІ-клієнт, яким користуєтеся.

Розробка

git clone https://github.com/IgorShutko/keycrm-mcp.git
cd keycrm-mcp
uv run python test_offline.py

test_offline.py не потребує акаунта: перевіряє, що сервер імпортується, реєструє всі 24 інструменти й зрозуміло повідомляє про відсутні доступи. Ту саму перевірку запускає CI на Python 3.11 і 3.13.

Решта тестів працює з живим акаунтом: скопіюйте .env.example у .env і впишіть доступи. Запускайте їх лише на тестовому акаунті.

  • test_smoke.py: 92 перевірки через stdio, зокрема повний цикл створення, оновлення і видалення покупця, товару та замовлення з прибиранням за собою.

  • test_domains.py: 90 перевірок доменних інструментів.

  • test_actions.py: 83 виклики читання всіх дій, результат у docs/ACTION_MATRIX.md.

Без MCP-клієнта працює crm_cli.py: uv run python crm_cli.py status, uv run python crm_cli.py search-endpoints tags.

MCP-клієнти запускають сервер один раз, тому після зміни коду перезапустіть клієнт. Не публікуйте реальні дані клієнтів в issues, логах і тестових файлах.

Автор і контакти

KeyCRM MCP створює та підтримує Ігор Шутко, агенція Target+. Споріднений проєкт: Хорошоп MCP для магазинів на Хорошопі.

Помилки та побажання: GitHub Issues.

Ліцензія

MIT.

Available Tools

24 tools
auditA

Change history (історія змін, /auditing).

actions: list - recent changes of the whole account (paginated, newest first) by_entity - changes of one object: entity_type (order/lead/task/manufacturing) + entity_id by_manager - changes made by a manager: manager_id Each record has action, model_type, model_ids, initiator and a changes list.

Inputs: page, limit, action, entity_id, +2 more. Returns: result

automationsA

Automation triggers (автоматизації), read only.

Actions: list - all triggers, compact; event / group / is_active filter locally get - trigger_id required; one trigger from the list Creation, editing and toggling are not exposed: a trigger changes live CRM behaviour.

Inputs: event, group, action, is_active, +1 more. Returns: result

clientsA

Buyers / clients (покупці).

IMPORTANT: POST /clients ignores phone and email. Contacts live in separate profiles: POST /clients/{id}/profiles {"client_id", "field": "phone"|"email", "value"}. create() accepts phone/email and writes the profiles right after the client, update() does the same when phone/email are passed.

actions: list - paginated clients with meta get - full client (phones, emails, profile list, shipping addresses) create - data{full_name, note, manager_id, ...} plus optional phone/email update - data{...} plus optional phone/email delete - DELETE /clients/{id} search - by name/phone/email set_profile - client_id + field ("phone"/"email"/custom) + value orders - order history of the client leads - pipeline cards of the client

Inputs: data, page, email, field, +6 more. Returns: result

commentsA

Object comments (коментарі): list, add, edit, delete.

entity_type: lead, order, client or deal; entity_id is the CRM id of that object. Actions: list - comments of the object, paginated add - message required (or pass a full body in data) edit - comment_id required, new message or data body delete - comment_id required (the CRM keeps a soft-deleted flag)

Inputs: data, page, tone, limit, +5 more. Returns: result

conversationsC

Chats (переписки): list, get, messages, unread, send (reply into a chat).

Inputs: data, page, limit, action, +1 more. Returns: result

crm_apiA

Raw request to any KeyCRM endpoint (escape hatch).

api='internal' -> https://.api.keycrm.app (572 routes, ids are CRM ids) api='official' -> https://openapi.keycrm.app/v1 (documented, filter[field]=value, 20 req/min) method: GET/POST/PUT/PATCH/DELETE, path starts with '/', query are plain query params (use 'filter[status_id]' style keys for official filters).

Inputs: api, body, path, query, +1 more. Returns: result

crm_capabilitiesA

What this CRM account can do right now.

Returns active modules (orders, leads, conversations, ...), plan-level flags, the API request limit and the list of known broken or quirky endpoints, so the model does not waste calls on dead routes.

Inputs: no named parameters. Returns: result

crm_endpointsA

Search the reverse-engineered endpoint catalog (572 internal API routes).

Use it to find the exact path+method before calling crm_api, e.g. query="tags", group="finance", query="export".

Inputs: group, limit, query. Returns: result

crm_snapshotA

Save a local JSON snapshot of the account before any risky operation.

Dumps pipeline cards (with contacts), orders, products, clients, users, sources, statuses and settings into keycrm-mcp/backups/.json. Use it before experiments with write endpoints: this is how the 26 lost cards were recovered on 01.11.2026.

Inputs: folder. Returns: result

crm_statusA

Check KeyCRM connectivity and show account summary.

Returns the authenticated profile, which channels work (internal/official), the API token owner and live counters for orders, pipeline cards, clients, products and users. Start every session with this call.

Inputs: no named parameters. Returns: result

custom_fieldsA

Custom fields (кастомні поля): definitions and values.

Actions: list - all custom fields; model filters them (lead / order / client) values - entity_id + model required; values of that object field - field_id required; one definition from the list Note the values path order: /config/custom-fields/{entity_id}/{model}/values.

Inputs: model, action, field_id, entity_id. Returns: result

deliveryA

Delivery (доставка): connected services, prep centers, templates, carrier lookups.

Actions: services - connected delivery services (empty on this tenant) prep_centers - packing/prep centers, paginated prep_centers_active - active prep centers shipment_templates - waybill templates warehouses - carrier warehouse/office list: Nova Poshta, Ukrposhta and Meest need location_ref (from locations), Rozetka takes query locations - carrier city/place search for service + query streets - Nova Poshta street search: query + location_ref suggest - address suggestion by query (500 on this tenant) price - POST shipment-price for order_id on service (dry run) print - GET waybill document for order_id on service (text preview) service: novaposhta, novaposhta_international, ukrposhta, meest_express, rozetka, rozetka_delivery, dhl_express, fedex, ups. This tool never creates a shipment; that would push data to a carrier.

Inputs: data, page, limit, query, +5 more. Returns: result

documentsA

Printed documents (документи): templates, preview, print.

Actions: list - document templates of the account (empty on this tenant) by_scope - scope required (order / lead / client), templates for it export_template / export_formats - xlsx export template and formats print_layouts - list printing layouts (config/print) preview - data required: {"type": "order", "structure": }; structure may be a dict/list and is stringified for you; returns rendered HTML view preview_pdf- same body, returns a short text head of the PDF (the client truncates binary bodies) print - template_id + scope + model_id, returns document text head attach - template_id + scope + model_id + data, attaches a document Document writes are limited to preview/print/attach; templates are not created or edited here.

Inputs: data, scope, action, model_id, +1 more. Returns: result

filesA

Files and attachments (файли) of orders.

actions: list_order - attachments of an order (GET /orders/{id}, field attachments) validate - size limit check before upload: order_id + path attach_order - upload a file to an order: order_id + path (local file) or content_base64, optional filename/mime; multipart, single chunk, limit 250 MB per order download - save a file by file_id into keycrm-mcp/exports/, returns local path, size and content type detach - remove attachment from its entity (attachment_id) delete_file - delete file itself (file_id), cascades attachments

Note: deleting an order does NOT delete its files, remove orphans with delete_file explicitly.

Inputs: mime, path, action, file_id, +4 more. Returns: result

financeA

Finance (фінанси): bills, payments, dictionaries, currency, billing.

Read only on purpose: creating or moving money objects is risky, so the tool never writes. Actions: bills / accounts - list finance bills (рахунки), filters passed as-is payments - list payments (answers 500 on this tenant, server side) payment_config - payment form config: min/max amounts, methods, managers expense_types - expense type dictionary payment_methods - payment method dictionary payment_gateways - connected payment gateways currency_rates - account currency rate table rates_common - common currency rates; currency="USD,UAH" narrows it fiscals - fiscal receipts / registers transactions - bank transactions (answers 500 on this tenant) transactions_config / transactions_unlinked - bank import config / unlinked rows billing - account balance, tariff and usage counters billing_invoices / billing_payments - subscription invoices and charges Example filters: {"filter[status]": "new"}; keys are sent as-is.

Inputs: page, limit, action, filters, +1 more. Returns: result

leadsA

Pipeline cards (лиды / сделки / заявки).

actions: list - cards with pagination; filters go through the official API ({"status_id": 1, "pipeline_id": 1, "created_between": ["...","..."]}) get - full card (contact, source, products, payments) create - required: status_id, communicate_at, currency_code optional: title, pipeline_id, source_id, manager_id, contact{...} update - PUT /leads/{id} with a partial body move - set status_id (moves between pipelines too) pipelines - list of pipelines with their statuses desk - kanban board: statuses grouped with cards complete - convert card into an order (PUT /leads/{id}/order) add_product / copy remove - BLOCKED on purpose: the batch endpoint removes whole status columns when ids do not match exactly. Delete cards in the UI.

Inputs: ids, data, page, limit, +6 more. Returns: result

ordersA

Work with orders (замовлення).

actions: list - official /order with filters + pagination (compact rows) get - full order by id (client, products, payments, shipping, tags) create - body needs source_id (+ buyer {full_name, phone/email} + products[]) update - PUT /orders/{id} with a partial body set_status - move order to status_id add_product / update_product / remove_product - product_id for last two add_tag / remove_tag - tag_id remove - delete orders by ids[] statuses / groups / totals / tags / sources - dictionaries (include_disabled=True shows hidden statuses and tags too) filters example: {"status_id": [1,2], "created_between": ["2026-10-01","2026-11-01"]}

Inputs: ids, data, page, limit, +8 more. Returns: result

productsC

Catalog products (товари).

actions: list (with stock quantity), get, create (name required), update, delete, categories (tree), warehouses, search.

Inputs: data, page, limit, action, +2 more. Returns: result

publicationsA

Marketplace publications (публікації): list, variations.

Actions: list - publications with marketplace/status/product columns variations - publication_id required, per-marketplace variations Empty on this tenant (no marketplaces connected). Sync/load actions are omitted on purpose: they push products to a live marketplace.

Inputs: page, limit, action, filters, +1 more. Returns: result

reportA

Aggregate report over a date range (UTC, YYYY-MM-DD).

kind='sales' - orders: count, revenue (grand_total), average check, breakdown by status_id / manager_id / payment_status. kind='leads' - pipeline cards: count, sum of products_total, breakdown by status_id / pipeline_id / manager_id, plus finished/active split. kind='funnel' - live funnel: cards per status per pipeline, closed share and conversion percent (no date range needed, taken from the pipeline board). kind='managers' - load per manager: cards, closed, active, conversion, products_total. kind='stale' - cards with no updates for more than days (default 7) days.

Inputs: days, kind, date_to, group_by, +2 more. Returns: result

settingsB

Account settings (config/settings). section: general, orders, products, leads, currencies, shipment, notifications, companies, suppliers, ai, manufacturing, conversations, tables, order_fields, allowed_fields or empty for the whole object (large).

Inputs: section. Returns: result

stocksA

Stock (склад): stock rows, movements, inventories, warehouses, stat, history.

Actions: list - stock rows per offer (sku, quantity, in_reserve, available, price) movements - stock movements, paginated movement - one movement by movement_id inventories - movement_id required: inventory lines of that movement warehouses - warehouses (read only here, stock writes are in crm_api) stat - totals: quantity / purchased_price / price, positive vs negative filters - filter bounds for the stock table history - offer_id required: movement history of one offer filters keys are sent as-is, e.g. {"filter[warehouse_id]": 1}.

Inputs: page, limit, action, search, +3 more. Returns: result

tasksA

Tasks (задачі). Creating a task really works on this account.

The API wants this body: name, priority, type, description, status, scheduled_at (ISO), assigned_to_id, tasked, attachments, period, checklist, settings.

actions: list - paginated tasks; tab="actual" (open) or "closed", mine=True only own tasks get - task by id for_entity - tasks attached to a card/order/client: entity_type (lead/order/client/task) + entity_id expired_count create - title, description, assigned_to_id, scheduled_at (ISO), priority, task_type; or pass data{} to override the whole body update - data{} with fields to change complete - mark as done (status=done) delete - DELETE /tasks/{id}

Inputs: tab, data, mine, page, +11 more. Returns: result

usersC

Team: list (members with roles), roles, permissions.

Inputs: action. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 24 tools

    Disambiguation4/5

    Tools are grouped by resource domain (orders, leads, clients, products, stocks, finance, delivery) and each has a clearly distinct purpose, with meta tools (crm_status, crm_capabilities, crm_snapshot, crm_endpoints, crm_api) distinguished by role. There is minor cross-tool overlap in sub-actions: 'warehouses' appears in products, stocks, and delivery, and 'list' recurs everywhere, but the surrounding domain context disambiguates them. crm_api as a raw escape hatch could in principle shadow any domain tool, though it is framed as a last resort.

    Naming Consistency4/5

    All names are lowercase snake_case noun phrases naming the resource domain (orders, leads, clients, products, stocks, comments, custom_fields, documents), which is a coherent, predictable convention for action-dispatch tools. The only deviation is the 'crm_' prefix on the five meta/utility tools, which is a sensible grouping rather than an inconsistency. It does not use a verb_noun pattern, but the top-level style itself is consistent.

    Tool Count4/5

    24 tools is on the heavy side, but each is a domain-level dispatcher containing many actions, so the count reflects a compact grouping rather than one-tool-per-endpoint sprawl. For a full CRM spanning orders, leads, clients, products, stock, finance, delivery, tasks, chats, files, and reporting, the surface is well scoped. A few tools (publications, automations) are thin on this tenant but still conceptually justified.

    Completeness4/5

    Coverage is broad and deep: full CRUD on orders, clients, products, tasks, comments, plus read surfaces for finance, delivery, stocks, documents, audit, reports, and settings. Intentional read-only or blocked operations (finance writes, delivery shipment creation, automation toggles, lead removal) are explicitly documented with risk rationale, which is good design rather than a silent gap. Remaining gaps are minor: order payment creation, custom-field definition writes, and document template management are not exposed.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to manage KiotViet retail and F\&B operations including products, orders, customers, invoices, and inventory through the Public API. Features 36 integrated tools with automatic token refresh, middleware chain support, and configurable presets for different access levels.
      3
      MIT
    • F
      license
      B
      quality
      D
      maintenance
      Enables AI assistants to autonomously interact with Kommo CRM, providing tools for managing pipelines, leads, contacts, and custom fields via the Kommo API v4.
      27
      1
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables LLMs like Claude to interact with Pipedrive CRM data through a standardized interface, providing 22 tools for managing deals, persons, organizations, activities, and more.
      22
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to manage GoHighLevel workspaces through natural language, with 508 tools across 18 domains for complete CRM, marketing, and workflow automation.
      Apache 2.0