Claude AI Integration

Use CampaignKit’s MCP server with Claude AI to validate email addresses, clean lists, and verify contact information directly from your conversations.

Quick Start

Step 1: Get Your API Key

1. Sign in to CampaignKit
2. Navigate to Settings → API Keys
3. Click Create New API Key
4. Copy the generated API key (starts with ck_)

Step 2: Configure Claude Desktop

Add the CampaignKit MCP server to your Claude Desktop configuration:

Configuration File Location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this configuration:

{
  "mcpServers": {
    "campaignkit": {
      "url": "https://api.campaignkit.cc/v1/mcp/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Replace YOUR_API_KEY_HERE with your actual CampaignKit API key.

Step 3: Restart Claude Desktop

Close and reopen Claude Desktop to load the new configuration.

Step 4: Test the Connection

Try asking Claude:

“Can you validate the email address test@example.com?”

If Claude responds with validation results (score, classifier, etc.), you’re all set! 🎉

What You Can Do

Ask Claude to:

• Validate single emails: “Is alice@example.com a valid email?”
• Check email lists: “Validate these 10 email addresses for me”
• Review validation history: “Show me my validation statistics for the last 30 days”
• Get job status: “What’s the status of validation job #123?”

Example Conversations

Quick Validation

You: “Can you check if john.doe@company.com is valid?”

Claude: I’ll validate that email for you.

[Uses validate_email tool]

The email john.doe@company.com has a score of 10/10 and is classified as “valid”:

• ✓ Syntax check passed
• ✓ MX records found
• ✓ Mailbox verified

This email is fully deliverable.

Batch Validation

You: “I have 20 emails from a lead magnet. Can you validate them?”

Claude: Yes! Please provide the email addresses and I’ll create a validation job.

You: [Provides list]

Claude: I’ve created validation job #456 with 20 emails. Let me check the status.

[Uses create_validation_job and get_job_status]

The job is complete! Results:

• Deliverable: 17 (85%)
• Invalid: 2 (10%)
• Risky: 1 (5%)

Would you like to see the detailed results?

Statistics Review

You: “How many emails have I validated this month?”

Claude: [Uses get_validation_stats]

Last 30 days:

• Total: 1,247 validations
• Valid: 1,089 (87%)
• Invalid: 98 (8%)
• Risky: 60 (5%)

Troubleshooting

Claude Can’t Connect

Symptoms: Claude responds “I don’t have access to that tool” or similar

Solutions:

1. Verify API key is correct in configuration file
2. Check JSON syntax is valid (no trailing commas, proper quotes)
3. Ensure configuration file is in the correct location
4. Restart Claude Desktop after making changes

Authentication Errors

Symptoms: “Unauthorized” or “Invalid API key” errors

Solutions:

1. Verify API key starts with ck_ and has no extra spaces
2. Check the Authorization header format: Bearer YOUR_KEY
3. Regenerate API key in CampaignKit settings if needed
4. Update configuration file with new key

Insufficient Credits

Symptoms: “Insufficient credits” error

Solutions:

1. Check your credit balance at app.campaignkit.cc
2. Purchase credits at app.campaignkit.cc/plans
3. Remember: only emails with valid syntax consume credits

Configuration File Issues

Common mistakes:

// ❌ Wrong: Trailing comma
{
  "mcpServers": {
    "campaignkit": { ... },  // Remove this comma
  }
}
 
// ❌ Wrong: Single quotes
{
  'mcpServers': { ... }  // Use double quotes
}
 
// ✅ Correct:
{
  "mcpServers": {
    "campaignkit": {
      "url": "https://api.campaignkit.cc/v1/mcp/sse",
      "headers": {
        "Authorization": "Bearer ck_..."
      }
    }
  }
}

Complete Tool Reference

For detailed information about all available validation tools, parameters, and response formats, see the MCP Server Documentation.

Available Tools:

• validate_email - Validate a single email address
• create_validation_job - Batch validate multiple emails
• get_job_status - Check validation job status
• get_job_results - Retrieve validation results
• get_validation_stats - View validation statistics

Additional Resources

• MCP Server Documentation - Complete technical reference
• API Documentation - REST API guide
• Pricing - Credit costs and plans
• Support - Contact our team

Questions about the Claude AI integration? Contact us through the chat widget or email support@campaignkit.cc.