> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seamless.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Job change trigger

> Detect a job change, research the new role, and send outbound.

When a contact changes roles, research their new position and send timely outbound.

## Prerequisites

* Saved contacts via `get_my_contacts` or search
* Credits for `research_contacts`
* Connect for `send_email`

<Note>
  After `research_contacts`, use `get_my_contacts` for the saved `contactId` required by `send_email`.
</Note>

## Sequence

```mermaid theme={null}
sequenceDiagram
  participant Agent
  participant MCP as Seamless MCP
  Agent->>MCP: get_my_contacts
  MCP-->>Agent: contacts with title changes
  Agent->>MCP: search_contacts
  MCP-->>Agent: updated profile
  Agent->>MCP: research_contacts
  MCP-->>Agent: verified email at new company
  Agent->>MCP: get_my_contacts
  MCP-->>Agent: saved contactId
  Agent->>MCP: send_email
  MCP-->>Agent: sent
```

## Tool calls

### 1. get\_my\_contacts

```json theme={null}
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_my_contacts",
    "arguments": {
      "startDate": "2026-05-11T00:00:00Z",
      "endDate": "2026-05-18T23:59:59Z"
    }
  },
  "id": 1
}
```

### 2. search\_contacts

```json theme={null}
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "search_contacts",
    "arguments": {
      "fullname": ["Jane Smith"],
      "companyName": ["NewCo Inc"]
    }
  },
  "id": 2
}
```

### 3. research\_contacts

```json theme={null}
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "research_contacts",
    "arguments": {
      "searchResultIds": ["<id>"],
      "waitForResults": true
    }
  },
  "id": 3
}
```

### 4. get\_my\_contacts

```json theme={null}
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_my_contacts",
    "arguments": {
      "limit": 10
    }
  },
  "id": 4
}
```

### 5. send\_email

```json theme={null}
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "send_email",
    "arguments": {
      "contactId": 456,
      "from": "you@company.com",
      "to": "jane@newco.com",
      "subject": "Congrats on the new role, {first_name}",
      "body": "<p>Hi {first_name}, congrats on joining {company}.</p>"
    }
  },
  "id": 5
}
```

## Run with Claude Code

```text theme={null}
Using Seamless MCP:
1. Pull my saved contacts from the last 7 days (ISO startDate/endDate on get_my_contacts)
2. Flag any who appear to have a new title or company
3. For Jane Smith at NewCo Inc: search with fullname, research with waitForResults
4. Call get_my_contacts for her saved contactId
5. Draft a congrats + meeting email using {first_name} and {company}
6. Ask me to approve before send_email with from, to, and contactId
```