# keeping-crm

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add maksim-tuchka/keeping-crm

# Browse available tools
npx -y @smithery/cli@latest tool list maksim-tuchka/keeping-crm

# Get full schema for a tool
npx -y @smithery/cli@latest tool get maksim-tuchka/keeping-crm list_clients

# Call a tool
npx -y @smithery/cli@latest tool call maksim-tuchka/keeping-crm list_clients '{}'
```

## Direct MCP Connection

Endpoint: `https://keeping-crm--maksim-tuchka.run.tools`

**Required config:**
- `apiKey` (query) — Your personal KeepinCRM API key (Settings → API)

## Tools (59)

- `list_clients` — Отримати список клієнтів/лідів з фільтрами та пагінацією
- `get_client` — Отримати клієнта по ID
- `create_client` — Створити клієнта або ліда
- `update_client` — Оновити дані клієнта
- `delete_client` — Видалити клієнта по ID
- `add_client_comment` — Додати нотатку до журналу дій клієнта
- `list_client_statuses` — Отримати список статусів клієнтів або лідів
- `list_agreements` — Отримати список угод з фільтрами
- `get_agreement` — Отримати угоду по ID
- `create_agreement` — Створити угоду разом з клієнтом та товарами
- `update_agreement` — Оновити дані угоди
- `delete_agreement` — Видалити угоду по ID
- `add_agreement_comment` — Додати нотатку до журналу дій угоди
- `add_agreement_delivery` — Додати доставку (ТТН) до угоди
- `list_agreement_funnels` — Отримати список воронок продажів
- `list_agreement_stages` — Отримати список етапів угод
- `list_agreement_statuses` — Отримати список причин виграшу/програшу угод
- `list_tasks` — Отримати список завдань з фільтрами
- `get_task` — Отримати завдання по ID
- `create_task` — Створити завдання (клієнт буде створений автоматично якщо не знайдений)
- `update_task` — Оновити дані завдання
- `delete_task` — Видалити завдання по ID
- `add_task_comment` — Додати нотатку до журналу дій завдання
- `list_task_categories` — Отримати список типів завдань
- `list_task_statuses` — Отримати список статусів завдань
- `list_payments` — Отримати список фінансових записів
- `create_payment` — Створити фінансовий запис (платіж)
- `list_payment_categories` — Отримати список категорій фінансів
- `list_payment_purses` — Отримати список гаманців
- `list_payment_segments` — Отримати список сегментів платежів
- `list_products` — Отримати список товарів з прайс-листа
- `get_product` — Отримати товар по ID
- `create_product` — Створити товар у прайс-листі
- `update_product` — Оновити товар по ID
- `delete_product` — Видалити товар по ID
- `get_product_by_sku` — Отримати товар по артикулу (SKU)
- `update_product_by_sku` — Оновити товар по артикулу (SKU)
- `delete_product_by_sku` — Видалити товар по артикулу (SKU)
- `list_product_categories` — Отримати список категорій товарів
- `create_product_category` — Створити категорію (папку) для товарів
- `list_materials` — Отримати список матеріалів зі складу
- `get_material` — Отримати матеріал по ID
- `create_material` — Створити матеріал на складі
- `update_material` — Оновити матеріал по ID
- `delete_material` — Видалити матеріал по ID
- `create_material_offer` — Створити модифікацію для матеріалу по ID
- `get_material_by_sku` — Отримати матеріал по артикулу (SKU)
- `update_material_by_sku` — Оновити матеріал по артикулу (SKU)
- `delete_material_by_sku` — Видалити матеріал по артикулу (SKU)
- `create_material_offer_by_sku` — Створити модифікацію для матеріалу по артикулу
- `list_material_categories` — Отримати список категорій матеріалів
- `create_material_category` — Створити категорію (папку) для матеріалів
- `create_transfer` — Створити переміщення залишків на складі (прихід, списання, повернення)
- `list_sources` — Отримати список джерел
- `list_contractors` — Отримати список підрядників
- `create_contractor` — Створити підрядника
- `list_deliveries` — Отримати список доставок
- `list_users` — Отримати список працівників
- `list_offices` — Отримати список філій

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get maksim-tuchka/keeping-crm <tool-name>
```