Serveur MCP

EmailKind fournit un serveur Model Context Protocol (MCP) qui permet aux agents IA et outils comme Claude Desktop, Cursor ou Windsurf de classifier des emails nativement — sans ecrire de code d'integration.

Endpoint

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

Le serveur MCP utilise le transport Streamable HTTP avec JSON-RPC 2.0 sur des requetes HTTP POST standard. L'authentification utilise le meme header Authorization: Bearer sk_live_xxx que l'API REST.

Configuration

Claude Desktop

Ajoutez a votre claude_desktop_config.json :

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

Cursor / Windsurf

Ajoutez dans vos parametres MCP :

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

Outils disponibles

classify

Classifier une adresse email ou un domaine. Retourne le fournisseur, les flags de classification, les enregistrements MX, le score de confiance et optionnellement l'enrichissement entreprise.

Parametres :

| Parametre | Type | Requis | Description | |---|---|---|---| | email | string | Non* | Adresse email a classifier | | domain | string | Non* | Domaine a classifier | | enrich | boolean | Non | Inclure la resolution du nom d'entreprise |

*Au moins un des parametres email ou domain doit etre fourni.

Exemple de prompt : "Classifie l'email [email protected] et dis-moi si c'est un email professionnel"

Exemple de reponse :

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

Classifier plusieurs emails et/ou domaines en un seul appel (jusqu'a 100 elements).

Parametres :

| Parametre | Type | Requis | Description | |---|---|---|---| | emails | string[] | Non* | Liste d'adresses email | | domains | string[] | Non* | Liste de domaines | | enrich | boolean | Non | Inclure l'enrichissement entreprise |

*Au moins un des parametres emails ou domains doit etre fourni.

Exemple de prompt : "Classifie ces emails et dis-moi lesquels sont professionnels : [email protected], [email protected], [email protected]"

Utilisation & Facturation

Les appels MCP consomment le meme quota API que les appels REST. Chaque appel classify compte comme 1 requete. Chaque element d'un appel classify_batch compte comme 1 requete. Les limites de debit et quotas du plan s'appliquent de maniere identique.

Test

Vous pouvez tester l'endpoint MCP avec curl :

# Initialiser
curl -X POST https://emailkind.com/v1/mcp \
  -H "Authorization: Bearer sk_live_VOTRE_CLE" \
  -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"}}}'

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

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