Skip to main content

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.

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)
research_contacts saves contacts to your org. send_email requires the saved contactId from get_my_contacts, not IDs returned by search_contacts.

Sequence

Tool calls

1. search_contacts

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

2. research_contacts

{
  "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.
{
  "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

{
  "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
}
Confirm with the user before calling send_email or any write tool that sends outbound email.

Run with Claude Code

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