Truelist

truelist-mcp

Truelistのメールアドレス検証用MCP（Model Context Protocol）サーバーです。Claude、Cursor、VS Code CopilotなどのAIアシスタントで、メールアドレスが配信可能かどうかを検証できます。

これは何ですか？

このパッケージは、Truelistのメールアドレス検証APIをMCPツールとして公開します。設定すると、AIアシスタントで次のことができます。

• メールアドレスが有効で配信可能かどうかを確認する
• 複数のメールアドレスを一括で検証する
• Truelistアカウントの情報とプランを確認する

無料で開始 — 100回の検証と10件の拡張クレジットを利用でき、クレジットカードは不要です。 APIキーを取得 → 無料プランで利用できます。

インストール

npm install -g truelist-mcp

または、npxで直接実行します。

npx truelist-mcp

設定

TruelistのAPIキーが必要です。truelist.ioで取得してください。

Claude Desktop

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

Claude Code

.claude/settings.jsonに追加するか、次を実行します。

claude mcp add truelist -- npx truelist-mcp

次に、環境変数を設定します。

export TRUELIST_API_KEY=your-api-key

Cursor

CursorのMCP設定に追加します（プロジェクト内の.cursor/mcp.jsonまたはグローバル設定）。

{
  "mcpServers": {
    "truelist": {
      "command": "npx",
      "args": ["truelist-mcp"],
      "env": {
        "TRUELIST_API_KEY": "your-api-key"
      }
    }
  }
}

VS Code (GitHub Copilot)

VS Codeの設定に追加します（プロジェクト内の.vscode/mcp.json）。

{
  "servers": {
    "truelist": {
      "command": "npx",
      "args": ["truelist-mcp"],
      "env": {
        "TRUELIST_API_KEY": "your-api-key"
      }
    }
  }
}

ツール

validate_email

単一のメールアドレスが配信可能かどうかを検証します。

入力:

{
  "email": "[email protected]"
}

出力:

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

状態:

状態	意味
ok	メールアドレスは配信可能です
email_invalid	メールアドレスは配信できません
risky	メールアドレスは配信可能な場合がありますが、リスク要因があります
accept_all	ドメインがすべてのアドレスを受け入れるため、配信可能かどうかは不確かです
unknown	配信可能かどうかを判定できませんでした

サブ状態:

サブ状態	意味
email_ok	問題は見つかりませんでした
accept_all	ドメインがすべてのアドレスを受け入れます
is_disposable	一時的なメールアドレス、または使い捨てメールアドレスです
is_role	役割ベースのアドレスです（info@、support@など）
failed_mx_check	ドメインにメールサーバーがありません
failed_smtp_check	SMTP検証に失敗しました
failed_spam_trap	既知のスパムトラップアドレスです
failed_no_mailbox	メールボックスが存在しません
failed_greylisted	サーバーに一時的に拒否されました
failed_syntax_check	メールアドレスの構文が無効です
unknown	サブ状態を判定できませんでした

validate_emails

複数のメールアドレスを1回のバッチで検証します（最大50件）。

入力:

{
  "emails": [
    "[email protected]",
    "[email protected]",
    "[email protected]"
  ]
}

出力:

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

名前、メールアドレス、プラン、管理者ステータスなど、Truelistアカウントの情報を確認します。

入力: なし

出力:

{
  "email": "[email protected]",
  "name": "Your Name",
  "uuid": "a3828d19-...",
  "timeZone": "America/New_York",
  "isAdminRole": true,
  "paymentPlan": "pro"
}

環境変数

変数	必須	説明
TRUELIST_API_KEY	はい	truelist.ioで取得したTruelistのAPIキー

トラブルシューティング

「TRUELIST_API_KEY environment variable is required」

サーバーにはTRUELIST_API_KEY環境変数が必要です。MCP設定のenvブロックで設定するか、シェルでエクスポートしてください。

Claude/Cursorにツールが表示されない

1. MCP設定を変更した後、AIアシスタントを再起動します
2. TRUELIST_API_KEYを設定した状態でnpx truelist-mcpを実行し、エラーが発生しないことを確認します
3. お使いのプラットフォームに対応した設定ファイルのパスが正しいことを確認します

認証エラー

truelist.ioでAPIキーが正しく、有効であることを確認してください。

レート制限

TruelistはAPIにレート制限を設けています。レート制限に達した場合、SDKは指数バックオフで自動的に再試行します。一括検証ではメールアドレスを並行して検証するため、大規模なバッチではレート制限が発生する場合があります。

はじめに

Truelist の無料アカウントに登録して、API キーを取得してください。無料プランには、100 件の検証と 10 件の拡張クレジットが含まれます。クレジットカードは不要です。

ライセンス

MIT