`ic_search_contacts`

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

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

Search for contacts by name, email, or custom attributes. Returns contact ID, name, email, and metadata.

Parameters

Name	Type	Required	Description
`query`	string	yes	Search by email, name, or other field

Example call

Arguments

{
  "query": "[email protected]"
}

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_search_contacts","arguments":{"query":"[email protected]"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('ic_search_contacts', {
  "query": "[email protected]"
});

More examples

{
  "query": "Sarah Smith"
}

Response shape

Field	Type	Description
`data`	array	Array of contacts matching the search query
`error`	string	Error code if connection required
`message`	string	Error message if connection required

Full JSON Schema

{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "description": "Array of contacts matching the search query",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Contact ID"
          },
          "name": {
            "type": "string",
            "description": "Contact name"
          },
          "email": {
            "type": "string",
            "description": "Contact email address"
          },
          "phone": {
            "type": "string",
            "description": "Contact phone number"
          },
          "custom_attributes": {
            "type": "object",
            "description": "Custom attributes"
          }
        }
      }
    },
    "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_search_contacts