truelist-mcp
MCP (Model Context Protocol) server for Truelist email validation. Lets AI assistants like Claude, Cursor, and VS Code Copilot validate email addresses for deliverability.
Power your agent
URL của chính nhà phát hành. Không phải endpoint của PlugMCP.
Host a copy with our keys and logs.
https://api.truelist.io/mcpNút Claude ở trên mở Claude với tên và URL đã được điền sẵn. Bạn vẫn cần xác nhận tại đó.
claude mcp add --transport http io.truelist-mcp https://api.truelist.io/mcpRun in a terminal.
{ "mcpServers": { "io.truelist-mcp": { "command": "npx", "args": [ "-y", "mcp-remote", "https://api.truelist.io/mcp" ] } }}claude_desktop_config.json
URL từ xa hay một lệnh trên máy của bạn? Hai cách cài đặt khác nhau thế nào
Chạy trên PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
MởTừ nhà phát hành
MCP (Model Context Protocol) server for Truelist email validation. Lets AI assistants like Claude, Cursor, and VS Code Copilot validate email addresses for deliverability.
Validate email addresses for deliverability and manage email validation batches with Truelist.
This package exposes Truelist's email validation API as MCP tools. Once configured, your AI assistant can:
Start free — 100 validations + 10 enhanced credits, no credit card required. Get your API key → Works with the free plan.
npm install -g truelist-mcp
Or run directly with npx:
npx truelist-mcp
You need a Truelist API key. Get one at truelist.io.
Add to your claude_desktop_config.json:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"truelist": {
"command": "npx",
"args": ["truelist-mcp"],
"env": {
"TRUELIST_API_KEY": "your-api-key"
}
}
}
}
Add to your .claude/settings.json or run:
claude mcp add truelist -- npx truelist-mcp
Then set the environment variable:
export TRUELIST_API_KEY=your-api-key
Add to your Cursor MCP settings (.cursor/mcp.json in your project or global settings):
{
"mcpServers": {
"truelist": {
"command": "npx",
"args": ["truelist-mcp"],
"env": {
"TRUELIST_API_KEY": "your-api-key"
}
}
}
}
Add to your VS Code settings (.vscode/mcp.json in your project):
{
"servers": {
"truelist": {
"command": "npx",
"args": ["truelist-mcp"],
"env": {
"TRUELIST_API_KEY": "your-api-key"
}
}
}
}
Validate a single email address for deliverability.
Input:
{
"email": "[email protected]"
}
Output:
{
"email": "[email protected]",
"state": "ok",
"sub_state": "email_ok",
"suggestion": null,
"domain": "example.com",
"canonical": "[email protected]",
"mx_record": "mx.example.com",
"first_name": "Jane",
"last_name": "Doe",
"verified_at": "2026-02-21T12:00:00Z",
"is_valid": true,
"is_deliverable": true
}
States:
Sub-states:
Validate multiple email addresses in a single batch (max 50).
Input:
{
"emails": [
"[email protected]",
"[email protected]",
"[email protected]"
]
}
Output:
[
{
"email": "[email protected]",
"state": "ok",
"sub_state": "email_ok",
"is_valid": true
},
{
"email": "[email protected]",
"state": "email_invalid",
"sub_state": "failed_mx_check",
"is_valid": false
},
{
"email": "[email protected]",
"state": "ok",
"sub_state": "email_ok",
"is_valid": true
}
]
Check your Truelist account info including name, email, plan, and admin status.
Input: none
Output:
{
"email": "[email protected]",
"name": "Your Name",
"uuid": "a3828d19-...",
"timeZone": "America/New_York",
"isAdminRole": true,
"paymentPlan": "pro"
}
The server requires a TRUELIST_API_KEY environment variable. Make sure it's set in your MCP configuration's env block or exported in your shell.
npx truelist-mcp runs without errors when TRUELIST_API_KEY is setVerify your API key is correct and active at truelist.io.
Truelist enforces rate limits on the API. If you hit rate limits, the SDK will automatically retry with exponential backoff. For batch validation, emails are validated concurrently so large batches may trigger rate limits.
Sign up for a free Truelist account to get your API key. The free plan includes 100 validations and 10 enhanced credits — no credit card required.
MIT
Validate email addresses for deliverability and manage email validation batches with Truelist.
{ "mcpServers": { "io.truelist-mcp": { "url": "https://api.truelist.io/mcp", "headers": {} } }}Công cụ
Chưa có danh sách công cụ. Máy chủ từ xa sẽ có danh sách sau lần kiểm tra tình trạng đầu tiên.
Câu hỏi thường gặp
Sao chép cấu hình http cho Cursor, Claude Desktop, Claude Code hoặc VS Code trên trang này. Cấu hình dùng bản cài đặt của nhà phát hành, không phải proxy của PlugMCP.
Nhà phát hành liệt kê các biến môi trường sau: TRUELIST_API_KEY.
Truelist được truy cập qua HTTP.
Kiểm tra lần cuối: 2026-11-10. Validate email addresses for deliverability and manage email validation batches with Truelist.