mcp-dir Kommo MCP
An MCP server for Kommo CRM (formerly amoCRM) that enables AI agents to read and write leads, contacts, companies, tasks, notes, pipelines, tags, custom fields, users, events, conversations, and catalog data via the official API v4. It supports 42 tools for managing sales workflows across WhatsApp, Instagram, and Telegram.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://api.mcp.ai/p_kommoWhat its tools do
48 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (16)
Can change data (32)
kommo_leads_listkommo_leads_getkommo_leads_createkommo_leads_updatekommo_contacts_listkommo_contacts_getkommo_contacts_createkommo_contacts_updatekommo_companies_listkommo_companies_getkommo_companies_createkommo_companies_updatekommo_tasks_listkommo_tasks_getkommo_tasks_createkommo_tasks_updatekommo_customers_listkommo_customers_getkommo_customers_createkommo_customers_updatekommo_notes_listkommo_notes_list_by_entitykommo_notes_createkommo_tags_listkommo_tags_createkommo_links_listkommo_links_linkkommo_links_unlinkkommo_requestreport_bugmarketplaceauthenticate
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- List leads in the sales pipeline that have been stalled for more than 7 days
- Create a new lead for Maria with a phone number and a follow-up task for tomorrow
- Show open conversations in the inbox and identify the responsible agent
Source and maintenance
- Maintenance checked
Protocol and capabilities
- Server
- mcp-ai 0.9.409
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 48 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
48 advertised
kommo_list_accounts
Lista as contas Kommo conectadas a este install (id/subdomínio, label). Use o id/subdomínio em `account` nas outras tools.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"account": {
"type": "string"
}
}
}{
"title": "kommo_list_accounts",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}kommo_account
Dados da conta Kommo conectada (id, nome, subdomínio, moeda, fuso, e opcionalmente usuários/campos/pipelines via `with`).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"with": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_account",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}kommo_leads_list
Leads do Kommo. action: list (busca paginada com filtros), get (por id), create (cria, body em `data`), update (atualiza; com `id` = 1 item, sem `id` = bulk com array em `data`). [Flattened action: list] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"with": {
"type": "string"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_leads_list",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_leads_get
Leads do Kommo. action: list (busca paginada com filtros), get (por id), create (cria, body em `data`), update (atualiza; com `id` = 1 item, sem `id` = bulk com array em `data`). [Flattened action: get] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"with": {
"type": "string"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_leads_get",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_leads_create
Leads do Kommo. action: list (busca paginada com filtros), get (por id), create (cria, body em `data`), update (atualiza; com `id` = 1 item, sem `id` = bulk com array em `data`). [Flattened action: create] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"with": {
"type": "string"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_leads_create",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_leads_update
Leads do Kommo. action: list (busca paginada com filtros), get (por id), create (cria, body em `data`), update (atualiza; com `id` = 1 item, sem `id` = bulk com array em `data`). [Flattened action: update] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"with": {
"type": "string"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_leads_update",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_contacts_list
Contacts do Kommo. action: list (busca paginada com filtros), get (por id), create (cria, body em `data`), update (atualiza; com `id` = 1 item, sem `id` = bulk com array em `data`). [Flattened action: list] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"with": {
"type": "string"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_contacts_list",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_contacts_get
Contacts do Kommo. action: list (busca paginada com filtros), get (por id), create (cria, body em `data`), update (atualiza; com `id` = 1 item, sem `id` = bulk com array em `data`). [Flattened action: get] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"with": {
"type": "string"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_contacts_get",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_contacts_create
Contacts do Kommo. action: list (busca paginada com filtros), get (por id), create (cria, body em `data`), update (atualiza; com `id` = 1 item, sem `id` = bulk com array em `data`). [Flattened action: create] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"with": {
"type": "string"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_contacts_create",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_contacts_update
Contacts do Kommo. action: list (busca paginada com filtros), get (por id), create (cria, body em `data`), update (atualiza; com `id` = 1 item, sem `id` = bulk com array em `data`). [Flattened action: update] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"with": {
"type": "string"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_contacts_update",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_companies_list
Companies do Kommo. action: list (busca paginada com filtros), get (por id), create (cria, body em `data`), update (atualiza; com `id` = 1 item, sem `id` = bulk com array em `data`). [Flattened action: list] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"with": {
"type": "string"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_companies_list",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_companies_get
Companies do Kommo. action: list (busca paginada com filtros), get (por id), create (cria, body em `data`), update (atualiza; com `id` = 1 item, sem `id` = bulk com array em `data`). [Flattened action: get] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"with": {
"type": "string"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_companies_get",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_companies_create
Companies do Kommo. action: list (busca paginada com filtros), get (por id), create (cria, body em `data`), update (atualiza; com `id` = 1 item, sem `id` = bulk com array em `data`). [Flattened action: create] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"with": {
"type": "string"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_companies_create",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_companies_update
Companies do Kommo. action: list (busca paginada com filtros), get (por id), create (cria, body em `data`), update (atualiza; com `id` = 1 item, sem `id` = bulk com array em `data`). [Flattened action: update] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"with": {
"type": "string"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_companies_update",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_tasks_list
Tasks do Kommo. action: list (busca paginada com filtros), get (por id), create (cria, body em `data`), update (atualiza; com `id` = 1 item, sem `id` = bulk com array em `data`). [Flattened action: list] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"with": {
"type": "string"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_tasks_list",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_tasks_get
Tasks do Kommo. action: list (busca paginada com filtros), get (por id), create (cria, body em `data`), update (atualiza; com `id` = 1 item, sem `id` = bulk com array em `data`). [Flattened action: get] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"with": {
"type": "string"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_tasks_get",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_tasks_create
Tasks do Kommo. action: list (busca paginada com filtros), get (por id), create (cria, body em `data`), update (atualiza; com `id` = 1 item, sem `id` = bulk com array em `data`). [Flattened action: create] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"with": {
"type": "string"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_tasks_create",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_tasks_update
Tasks do Kommo. action: list (busca paginada com filtros), get (por id), create (cria, body em `data`), update (atualiza; com `id` = 1 item, sem `id` = bulk com array em `data`). [Flattened action: update] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"with": {
"type": "string"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_tasks_update",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_customers_list
Clientes (módulo de vendas recorrentes/RFM do Kommo). action: list | get | create | update. Requer o módulo de clientes ativo na conta. [Flattened action: list] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"with": {
"type": "string"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_customers_list",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_customers_get
Clientes (módulo de vendas recorrentes/RFM do Kommo). action: list | get | create | update. Requer o módulo de clientes ativo na conta. [Flattened action: get] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"with": {
"type": "string"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_customers_get",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_customers_create
Clientes (módulo de vendas recorrentes/RFM do Kommo). action: list | get | create | update. Requer o módulo de clientes ativo na conta. [Flattened action: create] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"with": {
"type": "string"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_customers_create",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_customers_update
Clientes (módulo de vendas recorrentes/RFM do Kommo). action: list | get | create | update. Requer o módulo de clientes ativo na conta. [Flattened action: update] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"with": {
"type": "string"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_customers_update",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_notes_list
Notas de uma entidade. action: list (todas as notas do tipo de entidade), list_by_entity (notas de 1 registro), create (adiciona nota; `data` = JSON). Tipos comuns: common, call_in, call_out, sms_in/out, attachment. [Flattened action: list] Bulk support: accepts entity_ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entity_type"
],
"properties": {
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
},
"entity_id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"entity_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"entity_type": {
"enum": [
"leads",
"contacts",
"companies",
"customers"
],
"type": "string"
}
}
}{
"title": "kommo_notes_list",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_notes_list_by_entity
Notas de uma entidade. action: list (todas as notas do tipo de entidade), list_by_entity (notas de 1 registro), create (adiciona nota; `data` = JSON). Tipos comuns: common, call_in, call_out, sms_in/out, attachment. [Flattened action: list_by_entity] Bulk support: accepts entity_ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entity_type"
],
"properties": {
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
},
"entity_id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"entity_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"entity_type": {
"enum": [
"leads",
"contacts",
"companies",
"customers"
],
"type": "string"
}
}
}{
"title": "kommo_notes_list_by_entity",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_notes_create
Notas de uma entidade. action: list (todas as notas do tipo de entidade), list_by_entity (notas de 1 registro), create (adiciona nota; `data` = JSON). Tipos comuns: common, call_in, call_out, sms_in/out, attachment. [Flattened action: create] Bulk support: accepts entity_ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entity_type"
],
"properties": {
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
},
"entity_id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"entity_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"entity_type": {
"enum": [
"leads",
"contacts",
"companies",
"customers"
],
"type": "string"
}
}
}{
"title": "kommo_notes_create",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_tags_list
Tags de um tipo de entidade. action: list (com busca) | create (cria tags; `data` = JSON, ex.: [{"name":"vip"}]). [Flattened action: list]
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entity_type"
],
"properties": {
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"limit": {
"type": "number"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
},
"entity_type": {
"enum": [
"leads",
"contacts",
"companies",
"customers"
],
"type": "string"
}
}
}{
"title": "kommo_tags_list",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_tags_create
Tags de um tipo de entidade. action: list (com busca) | create (cria tags; `data` = JSON, ex.: [{"name":"vip"}]). [Flattened action: create]
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entity_type"
],
"properties": {
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"limit": {
"type": "number"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
},
"entity_type": {
"enum": [
"leads",
"contacts",
"companies",
"customers"
],
"type": "string"
}
}
}{
"title": "kommo_tags_create",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_pipelines_list
Funis (pipelines) e seus estágios. action: list (todos os funis) | get (funil por id) | statuses (estágios de um funil). [Flattened action: list] Bulk support: accepts pipeline_ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"type": "number"
},
"limit": {
"type": "number"
},
"account": {
"type": "string"
},
"pipeline_id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"pipeline_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
}
}
}{
"title": "kommo_pipelines_list",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}kommo_pipelines_get
Funis (pipelines) e seus estágios. action: list (todos os funis) | get (funil por id) | statuses (estágios de um funil). [Flattened action: get] Bulk support: accepts pipeline_ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"type": "number"
},
"limit": {
"type": "number"
},
"account": {
"type": "string"
},
"pipeline_id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"pipeline_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
}
}
}{
"title": "kommo_pipelines_get",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}kommo_pipelines_statuses
Funis (pipelines) e seus estágios. action: list (todos os funis) | get (funil por id) | statuses (estágios de um funil). [Flattened action: statuses] Bulk support: accepts pipeline_ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"type": "number"
},
"limit": {
"type": "number"
},
"account": {
"type": "string"
},
"pipeline_id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"pipeline_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
}
}
}{
"title": "kommo_pipelines_statuses",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}kommo_custom_fields
Campos personalizados de um tipo de entidade (leads/contacts/companies/customers). Use os codes/ids retornados nos bodies de create/update.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entity_type"
],
"properties": {
"page": {
"type": "number"
},
"limit": {
"type": "number"
},
"account": {
"type": "string"
},
"entity_type": {
"enum": [
"leads",
"contacts",
"companies",
"customers"
],
"type": "string"
}
}
}{
"title": "kommo_custom_fields",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}kommo_users_list
Usuários da conta. action: list | get (por id). `with`=role,group para incluir permissões/grupos. [Flattened action: list] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"page": {
"type": "number"
},
"with": {
"type": "string"
},
"limit": {
"type": "number"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_users_list",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}kommo_users_get
Usuários da conta. action: list | get (por id). `with`=role,group para incluir permissões/grupos. [Flattened action: get] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"page": {
"type": "number"
},
"with": {
"type": "string"
},
"limit": {
"type": "number"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_users_get",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}kommo_events
Eventos/atividades da conta (mudança de estágio, criação, etc.). Filtrável por tipo, entidade e período (`filter` JSON).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"type": "number"
},
"with": {
"type": "string"
},
"limit": {
"type": "number"
},
"order": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_events",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}kommo_talks_list
Conversas (talks) do inbox unificado. action: list (filtrável por contact_id/entity_id/only_in_work via `filter` JSON) | get (por id). É o diferencial do Kommo: o histórico de conversa por WhatsApp/Instagram/Telegram. [Flattened action: list] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"page": {
"type": "number"
},
"limit": {
"type": "number"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_talks_list",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}kommo_talks_get
Conversas (talks) do inbox unificado. action: list (filtrável por contact_id/entity_id/only_in_work via `filter` JSON) | get (por id). É o diferencial do Kommo: o histórico de conversa por WhatsApp/Instagram/Telegram. [Flattened action: get] Bulk support: accepts ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"page": {
"type": "number"
},
"limit": {
"type": "number"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
}
}
}{
"title": "kommo_talks_get",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}kommo_catalogs_list
Catálogos (listas: produtos, etc.). action: list (todos os catálogos) | elements (itens de um catálogo, filtrável/buscável). [Flattened action: list] Bulk support: accepts catalog_ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"type": "number"
},
"limit": {
"type": "number"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
},
"catalog_id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"catalog_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
}
}
}{
"title": "kommo_catalogs_list",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}kommo_catalogs_elements
Catálogos (listas: produtos, etc.). action: list (todos os catálogos) | elements (itens de um catálogo, filtrável/buscável). [Flattened action: elements] Bulk support: accepts catalog_ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"type": "number"
},
"limit": {
"type": "number"
},
"query": {
"type": "string"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
},
"catalog_id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"catalog_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
}
}
}{
"title": "kommo_catalogs_elements",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}kommo_links_list
Vínculos entre entidades (ex.: ligar um contato a um lead). action: list (vínculos de um registro) | link | unlink (`data` = JSON com to_entity_id/to_entity_type). [Flattened action: list] Bulk support: accepts entity_ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entity_type",
"entity_id"
],
"properties": {
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"limit": {
"type": "number"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
},
"entity_id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"entity_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"entity_type": {
"enum": [
"leads",
"contacts",
"companies",
"customers"
],
"type": "string"
}
}
}{
"title": "kommo_links_list",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_links_link
Vínculos entre entidades (ex.: ligar um contato a um lead). action: list (vínculos de um registro) | link | unlink (`data` = JSON com to_entity_id/to_entity_type). [Flattened action: link] Bulk support: accepts entity_ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entity_type",
"entity_id"
],
"properties": {
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"limit": {
"type": "number"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
},
"entity_id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"entity_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"entity_type": {
"enum": [
"leads",
"contacts",
"companies",
"customers"
],
"type": "string"
}
}
}{
"title": "kommo_links_link",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_links_unlink
Vínculos entre entidades (ex.: ligar um contato a um lead). action: list (vínculos de um registro) | link | unlink (`data` = JSON com to_entity_id/to_entity_type). [Flattened action: unlink] Bulk support: accepts entity_ids for batched execution.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entity_type",
"entity_id"
],
"properties": {
"data": {
"type": "string"
},
"page": {
"type": "number"
},
"limit": {
"type": "number"
},
"filter": {
"type": "string"
},
"account": {
"type": "string"
},
"entity_id": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"entity_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"entity_type": {
"enum": [
"leads",
"contacts",
"companies",
"customers"
],
"type": "string"
}
}
}{
"title": "kommo_links_unlink",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}kommo_request
Chamada crua à API v4 do Kommo — qualquer endpoint, com o seu token. Use quando não houver uma tool dedicada (chats/Salesbot/arquivos/Kommo IA/webhooks/fontes/widgets/templates). `path` relativo (ex.: "/leads/unsorted", "/salesbot"). Docs: https://developers.kommo.com
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"method",
"path"
],
"properties": {
"body": {
"type": "string"
},
"path": {
"type": "string"
},
"method": {
"enum": [
"GET",
"POST",
"PATCH",
"DELETE"
],
"type": "string"
},
"account": {
"type": "string"
},
"query_params": {
"type": "string"
}
}
}{
"title": "kommo_request",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}show_version
Show the current MCP platform and adapter versions.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"title": "Show Version",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}report_bug
Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"message"
],
"properties": {
"context": {
"type": "string",
"default": ""
},
"message": {
"type": "string"
},
"conversation": {
"type": "string",
"default": "[]"
}
}
}{
"title": "Report Bug",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}connect
Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"title": "Connection Status",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}toolkit_info
Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"title": "Toolkit Info",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}marketplace
The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "number",
"default": 10
},
"query": {
"type": "string",
"default": ""
},
"action": {
"enum": [
"search",
"describe",
"install",
"uninstall",
"subscribe",
"cancel",
"resume",
"report_bug",
"request_mcp",
"list_tools",
"invoke",
"search_prompts",
"get_prompt",
"publish_prompt"
],
"type": "string",
"default": "search"
},
"mcp_id": {
"type": "string",
"default": ""
},
"message": {
"type": "string",
"default": ""
},
"tool_id": {
"type": "string",
"default": ""
},
"arguments": {
"type": "string",
"default": "{}"
},
"immediate": {
"type": "boolean",
"default": false
},
"tier_slug": {
"type": "string",
"default": ""
},
"prompt_body": {
"type": "string",
"default": ""
},
"prompt_slug": {
"type": "string",
"default": ""
},
"prompt_tool": {
"type": "string",
"default": ""
},
"prompt_vars": {
"type": "string",
"default": "{}"
},
"conversation": {
"type": "string",
"default": "[]"
},
"prompt_title": {
"type": "string",
"default": ""
},
"request_name": {
"type": "string",
"default": ""
},
"cancel_reason": {
"enum": [
"too_expensive",
"missing_features",
"switched_service",
"unused",
"customer_service",
"too_complex",
"low_quality",
"other"
],
"type": "string"
},
"cancel_comment": {
"type": "string",
"default": ""
},
"prompt_targets": {
"type": "array",
"items": {
"enum": [
"claude",
"chatgpt",
"cursor",
"lovable"
],
"type": "string"
},
"default": []
},
"report_context": {
"type": "string",
"default": ""
},
"prompt_category": {
"type": "string",
"default": ""
},
"request_details": {
"type": "string",
"default": ""
},
"prompt_description": {
"type": "string",
"default": ""
}
}
}{
"title": "Marketplace",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}authenticate
MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"token": {
"type": "string"
}
}
}{
"title": "Authenticate",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 618 ms
- 95th percentile latency
- 618 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 618 ms · metadata changed · 48 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http kommo-mcp https://api.mcp.ai/p_kommoCodex
codex mcp add kommo-mcp --url https://api.mcp.ai/p_kommoCursor
{
"mcpServers": {
"kommo-mcp": {
"url": "https://api.mcp.ai/p_kommo"
}
}
}Cline
{
"mcpServers": {
"kommo-mcp": {
"type": "streamableHttp",
"url": "https://api.mcp.ai/p_kommo",
"disabled": false
}
}
}VS Code
{
"servers": {
"kommo-mcp": {
"type": "http",
"url": "https://api.mcp.ai/p_kommo"
}
}
}Gemini CLI
gemini mcp add --transport http kommo-mcp https://api.mcp.ai/p_kommoClaude Desktop
https://api.mcp.ai/p_kommoWindsurf
{
"mcpServers": {
"kommo-mcp": {
"serverUrl": "https://api.mcp.ai/p_kommo"
}
}
}Let your agent find its tools
Find servers like mcp-dir Kommo MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.