> ## 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.

# Prospect to meeting

> Search, research, resolve a saved contact ID, and email a prospect.

Find a contact, enrich verified email, and send a meeting request.

## Prerequisites

* MCP access enabled
* Credits for `research_contacts`
* Connect access for `send_email` (or use `create_email_draft` only)
* A connected sender address (`list_email_accounts` or `seamless://email-accounts`)

<Note>
  `research_contacts` saves contacts to your org. `send_email` requires the **saved** `contactId` from `get_my_contacts`, not IDs returned by `search_contacts`.
</Note>

## Sequence

```mermaid theme={null}
sequenceDiagram
  participant Agent
  participant MCP as Seamless MCP
  Agent->>MCP: search_contacts
  MCP-->>Agent: searchResultIds
  Agent->>MCP: research_contacts
  MCP-->>Agent: enriched, saved contacts
  Agent->>MCP: get_my_contacts
  MCP-->>Agent: saved contactId
  Agent->>MCP: send_email
  MCP-->>Agent: sent
```

## Tool calls

### 1. search\_contacts

```json theme={null}
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "search_contacts",
    "arguments": {
      "companyName": ["Acme Corp"],
      "jobTitle": ["VP Sales"],
      "limit": 5
    }
  },
  "id": 1
}
```

### 2. research\_contacts

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

### 3. get\_my\_contacts

Retrieve the saved `contactId` for the researched person.

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

### 4. Read seamless\://templates/variables

Use merge tags `{first_name}`, `{company}`, `{title}` in the email body.

### 5. send\_email

```json theme={null}
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "send_email",
    "arguments": {
      "contactId": 456,
      "from": "you@company.com",
      "to": "prospect@acme.com",
      "subject": "Quick intro, {first_name}",
      "body": "<p>Hi {first_name}, I'd like to schedule 15 minutes to discuss {company}.</p>"
    }
  },
  "id": 4
}
```

<Warning>
  Confirm with the user before calling `send_email` or any `write` tool that sends outbound email.
</Warning>

## Run with Claude Code

```text theme={null}
Use the Seamless MCP server to:
1. Search for VP of Sales contacts at Acme Corp in Texas
2. Research the top 3 results for verified email (waitForResults: true)
3. Call get_my_contacts and pick the saved contactId for each researched person
4. Read seamless://templates/variables for merge tags
5. Draft a short meeting-request email using {first_name} and {company}
6. Ask me to approve before calling send_email with from, to, and contactId
```