List incoming leads
Chats waiting in the Incoming leads stage to be accepted, declined or linked.
MCP tool kommo_read → list_incoming_leads
read
Returns chats that have not become leads yet, newest first, with the channel, the contact name, the first message and when it arrived. It works only when the Incoming leads stage is enabled for the pipeline; otherwise it returns an empty list. Follow next_cursor until it is null.
Parameters
| Name | Type | Description |
|---|---|---|
| pipeline_id integer | integer | Only chats for this pipeline. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "kommo_read",
"arguments": {
"operation": "list_incoming_leads",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"incoming": [
{
"chat_id": "c8f2a6d1",
"channel": "WhatsApp",
"contact_name": "Tom Becker",
"first_message": "How much is a landing page for a dental clinic?",
"received_at": "2026-10-20T07:41:00+02:00"
},
{
"chat_id": "c1d7e9a3",
"channel": "Instagram",
"contact_name": "promo_deals_99",
"first_message": "Earn 500 a day from home https://example.com/x",
"received_at": "2026-10-20T06:12:00+02:00"
}
],
"next_cursor": null
},
"isError": false
}