MCP Server

EmailKind provides a Model Context Protocol (MCP) server that allows AI agents and tools like Claude Desktop, Cursor, or Windsurf to classify emails natively — without writing integration code.

Endpoint

POST https://emailkind.com/v1/mcp

The MCP server uses the Streamable HTTP transport with JSON-RPC 2.0 over standard HTTP POST requests. Authentication uses the same Authorization: Bearer sk_live_xxx header as the REST API.

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "emailkind": {
      "url": "https://emailkind.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_YOUR_KEY"
      }
    }
  }
}

Cursor / Windsurf

Add to your MCP settings:

{
  "emailkind": {
    "url": "https://emailkind.com/v1/mcp",
    "headers": {
      "Authorization": "Bearer sk_live_YOUR_KEY"
    }
  }
}

Available Tools

classify

Classify an email address or domain. Returns provider, classification flags, MX records, confidence score, and optional company enrichment.

Parameters:

| Parameter | Type | Required | Description | |---|---|---|---| | email | string | No* | Email address to classify | | domain | string | No* | Domain to classify | | enrich | boolean | No | Include company name resolution |

*At least one of email or domain must be provided.

Example prompt: "Classify the email [email protected] and tell me if it's a business email"

Example response:

{
  "success": true,
  "domain": "stripe.com",
  "provider": {
    "id": "google_workspace",
    "name": "Google Workspace",
    "type": "business"
  },
  "classification": {
    "is_business": true,
    "is_free": false,
    "is_disposable": false,
    "is_education": false,
    "is_custom_domain": true
  },
  "confidence": 0.98
}

classify_batch

Classify multiple emails and/or domains in a single call (up to 100 items).

Parameters:

| Parameter | Type | Required | Description | |---|---|---|---| | emails | string[] | No* | List of email addresses | | domains | string[] | No* | List of domains | | enrich | boolean | No | Include company enrichment |

*At least one of emails or domains must be provided.

Example prompt: "Classify these emails and tell me which ones are business: [email protected], [email protected], [email protected]"

Usage & Billing

MCP calls consume the same API quota as REST API calls. Each classify call counts as 1 request. Each item in a classify_batch call counts as 1 request. Rate limits and plan quotas apply identically.

Testing

You can test the MCP endpoint with curl:

# Initialize
curl -X POST https://emailkind.com/v1/mcp \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

# List tools
curl -X POST https://emailkind.com/v1/mcp \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# Call classify
curl -X POST https://emailkind.com/v1/mcp \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"classify","arguments":{"email":"[email protected]","enrich":true}}}'