ic_get_conversation

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

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

Get complete conversation thread by ID. Returns all messages, timestamps, participants, and metadata.

Parameters

NameTypeRequiredDescription
idstringyesConversation ID

Example call

Arguments

{
  "id": "123456789"
}

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_get_conversation","arguments":{"id":"123456789"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('ic_get_conversation', {
  "id": "123456789"
});

Response shape

FieldTypeDescription
idstringConversation ID
created_atnumberUnix timestamp when created
updated_atnumberUnix timestamp when last updated
sourceobjectSource of conversation
participantsobjectParticipants in conversation
statestringConversation state
conversation_partsobject
errorstringError code if connection required
messagestringError message if connection required
Full JSON Schema
{
  "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"
    },
    "conversation_parts": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string"
        },
        "data": {
          "type": "array",
          "description": "Array of message parts",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "type": {
                "type": "string"
              },
              "body": {
                "type": "string"
              },
              "created_at": {
                "type": "number"
              },
              "author": {
                "type": "object"
              }
            }
          }
        }
      }
    },
    "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.

Regenerated from source · build September 22, 2026