`ic_list_conversations`

Pack: intercom · Endpoint: https://gateway.pipeworx.io/intercom/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/ic_list_conversations for the schema, then POST the same URL with its arguments for the data.

List conversations with pagination. Returns conversation ID, participants, status, created date, and last message preview.

Parameters

Name	Type	Required	Description
`per_page`	number	no	Results per page (default 20)
`starting_after`	string	no	Pagination cursor

Example call

Arguments

{
  "per_page": 20
}

curl

curl -X POST https://gateway.pipeworx.io/intercom/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ic_list_conversations","arguments":{"per_page":20}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('ic_list_conversations', {
  "per_page": 20
});

More examples

{
  "per_page": 50,
  "starting_after": "WzE2NzM5NDcyMjAwMCwgIjVkNzk4YzJhMjEwMDAwMDAxMDAwMDAwMCJd"
}

Response shape

Field	Type	Description
`conversations`	array	List of conversations
`pages`	object
`error`	string	Error code if connection required
`message`	string	Error message if connection required

Full JSON Schema

{
  "type": "object",
  "properties": {
    "conversations": {
      "type": "array",
      "description": "List of conversations",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Conversation ID"
          },
          "created_at": {
            "type": "number",
            "description": "Unix timestamp when created"
          },
          "updated_at": {
            "type": "number",
            "description": "Unix timestamp when last updated"
          },
          "source": {
            "type": "object",
            "description": "Source of conversation"
          },
          "participants": {
            "type": "object",
            "description": "Participants in conversation"
          },
          "state": {
            "type": "string",
            "description": "Conversation state (open/closed)"
          },
          "preview": {
            "type": "string",
            "description": "Last message preview"
          }
        }
      }
    },
    "pages": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string"
        },
        "next": {
          "type": "object",
          "description": "Next page cursor"
        }
      }
    },
    "error": {
      "type": "string",
      "description": "Error code if connection required"
    },
    "message": {
      "type": "string",
      "description": "Error message if connection required"
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "intercom": {
      "url": "https://gateway.pipeworx.io/intercom/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

ic_list_conversations