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.

Research search results, add saved contacts to a campaign, and launch a multi-step sequence.

​
Prerequisites

  • Full Connect access for campaigns
  • Credits for bulk research_contacts
  • Linked email accounts (seamless://email-accounts)
contactIds in create_campaign must be saved IDs from get_my_contacts after research_contacts, not search result IDs.

​
Sequence

​
Tool calls

​
1. search_contacts

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

​
2. research_contacts

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "research_contacts",
    "arguments": {
      "searchResultIds": ["id1", "id2", "id3"],
      "waitForResults": true
    }
  },
  "id": 2
}

​
3. get_my_contacts

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_my_contacts",
    "arguments": {
      "limit": 50
    }
  },
  "id": 3
}

​
4. create_campaign

Read seamless://email-accounts and seamless://templates/variables before this call. 
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "create_campaign",
    "arguments": {
      "name": "May sequence",
      "emailAccountIds": [123],
      "contactIds": [456, 789],
      "steps": [
        {
          "type": "auto-email",
          "name": "Day 1 intro",
          "dueDay": 1,
          "templateData": {
            "subject": "Hi {first_name}",
            "template": "<p>Hi {first_name},</p>"
          }
        }
      ]
    }
  },
  "id": 4
}
Confirm with the user before execute_campaign_action with action START.

​
Run with Claude Code

Using Seamless MCP:
1. Search for contacts at Acme Corp (VP Sales)
2. Research the search result IDs with waitForResults: true
3. Call get_my_contacts and collect saved contactIds for researched people
4. Read seamless://email-accounts and seamless://templates/variables
5. Create a campaign with emailAccountIds, those contactIds, and one auto-email step (name, dueDay, templateData.subject + template)
6. Show me the campaign summary before calling execute_campaign_action with START