Leadmagic

@pipeworx/leadmagic

LeadMagic の B2B データ API（leadmagic.io）を通じて、名前と会社のドメインから勤務先メールアドレスを検索します。返されるメールアドレスはすべて、LeadMagic 側ですでに SMTP 検証済みです。enrich-waterfall の検索ローテーションの一部です（fleet #2860）。

Pipeworx の一部です。AI エージェントを 1882 以上の稼働中データソースに接続する MCP ゲートウェイです。これは独立した非公式のインテグレーションであり、上流プロバイダーとは提携関係になく、承認も受けておらず、公開もされていません。

ツール

• leadmagic_find_email(first_name, last_name, domain, _apiKey) — 勤務先メールアドレス、雇用確認、会社の各フィールドを返します。該当なしが確認された場合、LeadMagic 独自の課金では無料です。

認証

BYO のみです。LeadMagic API キーを _apiKey（ヘッダー X-API-Key）として渡してください。https://leadmagic.io で取得できます。プラットフォームキーはありません（D4）。

データソース

• https://api.leadmagic.io/v1/people/email-finder — メールアドレス検索。

検証に関する注記（fleet #2860、2026-10-08、ベンダーキー未保有）

• 認証ヘッダーとライブエンドポイントをエッジプローブで確認済みです。 /v1/people/email-finder へのキーなしの POST は、LeadMagic 独自の構造化された problem+json 本文とともに HTTP 401 を返しました。本文では、X-API-Key（大文字と小文字を区別しない）または Authorization: Bearer <key> が使用可能な 2 つの形式として示されています。このパックでは X-API-Key を使用します。
• レスポンスの形式はベンダーのドキュメントのみで確認しています（https://leadmagic.io/docs/api-reference/email-finder、2026-10-08 に確認）：
  • 該当あり：{ email, status: "valid", credits_consumed: 1, message, employment_verified, company_name, company_industry, mx_provider }
  • 該当なし：{ email: null, status: null, credits_consumed: 0, message, first_name, last_name, domain } 該当なしの場合も email: null を含む全フィールドが埋まった 200 レスポンスです。このパックでは、ウォーターフォールの共通ルール（findymail が自社 API について記載しているのと同じ落とし穴）に従い、レスポンス全体ではなく email の値で該当の有無を判定します。
• 未検証（キー未保有）： ライブ呼び出しにおける "valid" 以外の status 値の正確な一覧（ドキュメントには 1 つの例のみ記載）と、不正な形式のドメインで 4xx が返るのか、該当なしとして正常に処理されるのか。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "leadmagic": {
      "url": "https://gateway.pipeworx.io/leadmagic/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/leadmagic/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx 共通のメタツール（ask_pipeworx、discover_tools、search_within、remember/recall など、ゲートウェイ全体で利用できるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック固有のツールとともに共通ツールが約 30 個表示されます。接続の initialize レスポンスに正確な範囲が示されており、その日の状況を確認する際の信頼できる情報源となります。

これは意図的なもので、偶然の多重化ではありません。メタツールを使うと、このパックでは扱えない質問にも ask_pipeworx を通じてカタログ全体から対応できるため、MCP サーバーを 2 つ目に追加する必要はありません。現在、メタツールなしでパックのエンドポイントに接続する方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

このパックのツールだけでなく、すべてのパックのツールを直接一覧表示するには、Pipeworx のフルゲートウェイに接続してください。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ 1882 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使って、すべてのツールを利用できます。

MCP クライアントをお持ちでない場合：HTTP で呼び出す

このパックでは独自の API キー（_apiKey）を使います。こちらでキーを用意していないため、キーなしで実行できる curl の例はありません。ツールの詳細を確認するには GET https://gateway.pipeworx.io/v1/tools/leadmagic_find_email を使います。ツールを検索するには POST https://gateway.pipeworx.io/v1/tools/search_packs に {"query":"..."} を送信します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行でき、Pipeworx アカウントやゲートウェイとの往復通信は不要です。

{
  "mcpServers": {
    "leadmagic": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-leadmagic"]
    }
  }
}

または、直接実行して起動することを確認できます。

npx -y @pipeworx/mcp-leadmagic

標準入力／標準出力を介して MCP で通信し、initialize／tools/list／tools/call に対して、このパックのツールのみを使って応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックのエンドポイントでも、完全なゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Leadmagic data" })

ゲートウェイが適切なツールを選択し、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT