CampaignKit MCP

How to Install and Use CampaignKit MCP

If you want to add smart email validation to your app or project, CampaignKit MCP is a great tool. It helps you check if email addresses are real and valid using a secure AI-friendly protocol. Here’s how you can install and start using CampaignKit MCP step-by-step with simple examples.

Step 1: Get Your CampaignKit API Key

Before you start, you need an API key from CampaignKit. This key lets you securely connect to the MCP server.

Here’s what to do:

1. Sign in to CampaignKit
2. Go to Settings → API Keys
3. Click Create New API Key
4. Copy your new API key (this is what you’ll use in your requests)

This API key will be passed as a Bearer token in your request headers.

---

Step 2: Connect to the MCP Server using Server-Sent Events (SSE)

CampaignKit MCP works over HTTPS using Server-Sent Events (SSE). This means your app keeps a live connection open to get real-time email validation responses.

A simple connection example in JavaScript looks like this:

const url = 'https://mcp.campaignkit.cc/validate_email'; // example endpoint
const eventSource = new EventSource(url, {
  headers: {
    Authorization: 'Bearer YOUR_API_KEY_HERE'
  }
});

eventSource.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log('Validation result:', data);
};

eventSource.onerror = (error) => {
  console.error('Connection error:', error);
};

Replace 'YOUR_API_KEY_HERE' with the API key you copied earlier.

---

Step 3: Validate a Single Email Address

Once connected, you can use the validate_email tool to check one email address right away. The server expects a JSON-RPC 2.0 request message.

Here’s an example request you send over the SSE connection:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "validate_email",
  "params": {
    "email": "[email protected]"
  }
}

The server will reply with a detailed validation result including syntax, MX, and mailbox checks. Each validation costs 1 credit.

---

Step 4: Create a Batch Validation Job for Many Emails

If you have a list of emails to validate, CampaignKit MCP lets you create a batch job. This runs validation in the background so you don’t wait for each one.

Example request to create a job:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "create_validation_job",
  "params": {
    "emails": [
      "[email protected]",
      "[email protected]",
      "[email protected]"
    ]
  }
}

This will start processing the list. You are charged 1 credit per email checked.

---

Step 5: Check Your Job Status and Get Results

To see how your batch job is doing, use get_job_status:

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "get_job_status",
  "params": {
    "job_id": "job-12345"
  }
}

Once completed, retrieve the results with get_job_results:

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "get_job_results",
  "params": {
    "job_id": "job-12345",
    "page": 1,
    "page_size": 50
  }
}

These two calls are free and help you track email validations easily.

---

Step 6: Monitor Your Validation Stats

You can also ask for your account’s validation statistics anytime with get_validation_stats:

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "get_validation_stats",
  "params": {}
}

This provides insight into how many emails you validated and your usage history.

---

By following these steps, you’ll have CampaignKit MCP set up to validate emails efficiently using AI technology. Always keep your API key safe, handle errors politely, and monitor your credits to keep the service running smoothly.

Happy validating!