keycrm-mcp
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., "@keycrm-mcp list the 5 most recent orders and their statuses"
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.
KeyCRM MCP: неофіційний MCP-сервер для KeyCRM
Українська · Русский · English

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-mcpCodex:
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-mcpClaude 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? Покажи історію.»
Можливості
Інструмент | Що робить |
| Профіль, стан обох каналів, лічильники акаунта. З нього варто починати сесію. |
| Ліди та воронки: список, створення, оновлення, перенесення між статусами, товари в картці, копіювання. |
| Замовлення: список, створення, статуси, оплати, витрати, товари, мітки, джерела. |
| Покупці: пошук, створення, оновлення, історія замовлень і лідів. |
| Товари, категорії, склади. |
| Задачі: список, пошук, створення, завершення, прострочені. |
| Чати: список, повідомлення, непрочитані, надсилання. |
| Користувачі, ролі, права. |
| Звіти: продажі, ліди, воронка з конверсією, навантаження менеджерів, завислі картки. |
| Історія змін: хто, що і коли міняв в акаунті, у сутності або за менеджером. |
| Налаштування акаунта за розділами. |
| Рахунки, оплати, типи витрат, способи оплати, курси валют, фіскалізація, білінг. |
| Довідники Нової Пошти, Укрпошти та Rozetka Delivery: міста, відділення, вулиці, розрахунок вартості. |
| Залишки, рухи, інвентаризації, складська статистика. |
| Документи за Twig-шаблоном: перегляд і справжній PDF. |
| Вкладення замовлень: завантаження частинами до 250 МБ, скачування, відкріплення. |
| Додаткові поля: опис полів і значення в картках. |
| Коментарі до лідів, замовлень, покупців і угод. |
| Тригери й автоматизації, лише читання. |
| Публікації товарів на маркетплейсах. |
| Запит до будь-якого маршруту обох API, із захистом від небезпечних масових шляхів. |
| Пошук у каталозі 572 внутрішніх маршрутів. |
| Які модулі акаунта активні, ліміти, відомі проблеми й небезпечні місця. |
| Локальний JSON-знімок карток, замовлень, товарів, покупців і довідників перед ризикованою дією. |
Усі дії та параметри кожного інструмента: довідник інструментів (російською).
Налаштування
Сервер бере параметри зі змінних середовища або з файлу .env поруч із кодом (шаблон: .env.example).
Змінна | За замовчуванням | Призначення |
| немає, обов'язкова | Піддомен акаунта: |
| немає | Логін для внутрішнього API. |
| немає | Пароль для внутрішнього API. |
| знаходиться автоматично | Ключ офіційного OpenAPI. Якщо порожньо, сервер бере його з налаштувань акаунта через внутрішній API. |
| папка з кодом | Куди зберігати знімки ( |
|
| Адреса офіційного 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Офіційний OpenAPI (
openapi.keycrm.app/v1): авторизація ключемBearer. Документований і стабільний, але покриває лише частину CRM: 59 операцій. Ключ сервер знаходить сам у налаштуваннях акаунта.Внутрішній 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.pytest_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 для магазинів на Хорошопі.
Telegram: @shutko_igor
Telegram-канал: @shutko_ads
Помилки та побажання: GitHub Issues.
Ліцензія
MIT.
Available Tools
24 toolsauditA
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
Scored across 24 tools
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.
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.
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.
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
Related MCP Connectors
Connect ChatGPT or Claude to your CRM, store or shipping API. Keys stay out of the chat.
Operate Obriym CRM from your AI assistant: leads, deals, orders, catalog, stock, marketplaces.
Create contacts, move deals, send proposals and invoices, read your inbox, from Claude or ChatGPT.
Give your AI agent 75+ business tools: tasks, projects, CRM, forms, E-Sign, team comms, automations.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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.3MIT
- FlicenseBqualityDmaintenanceEnables AI assistants to autonomously interact with Kommo CRM, providing tools for managing pipelines, leads, contacts, and custom fields via the Kommo API v4.271-
- AlicenseAqualityDmaintenanceEnables LLMs like Claude to interact with Pipedrive CRM data through a standardized interface, providing 22 tools for managing deals, persons, organizations, activities, and more.221MIT
- AlicenseNot gradedqualityDmaintenanceEnables 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