Potarix Enricher

Potarix MCP サーバー

Potarix Enricher の MCP ラッパーです。AI エージェントが企業のウェブサイトを特定し、確認済みのメールアドレスを検索して、企業の連絡先一覧をすべて取得できます。また、人間がカード情報を一度入力すれば、エージェントだけで登録してクレジットを購入できます。

ツール

ツール	機能	料金
lookup_company_website	企業名 → ウェブサイトの URL	2 クレジット
find_person_email	個人名 + 企業名／ドメイン → 確認済みメールアドレス	25 クレジット
find_decision_maker_email	カテゴリ + ドメイン → 購買担当者と思われる人物の名前 + メールアドレス	25 クレジット
find_linkedin_email	LinkedIn プロフィール URL → 確認済みメールアドレス	10 クレジット
find_company_emails	ドメイン → 公開されている企業の連絡先一覧	25 クレジット
find_all	企業名 1 件 → ウェブサイト + 意思決定者 + 企業のメールアドレス一覧	上記の合計
check_balance	クレジット、メールアドレス、保存済みカードのステータス、キー数	無料
start_checkout	初回にカードを追加するための Stripe URL を取得	該当なし
topup_credits	保存済みカードに請求してクレジットを追加	該当なし

1 クレジット = $0.01 です。トライアルアカウントには 25 クレジットが無料で付与されます。各エンドポイントの料金は、プロバイダーにかかる最悪の原価を下回らないよう設定されています。検索に成功しても赤字にならず、途中で終了したウォーターフォール呼び出しでは利益が得られます。

接続方法は 2 通り

トランスポート	エンドポイント	最適な用途
Streamable HTTP（ホスト型）	https://api.potarix.com/mcp	リモートエージェント（Claude、ChatGPT）— インストール不要
stdio（npm パッケージ）	npx -y potarix-mcp	ローカル／デスクトップクライアント

どちらも同じ 9 つのツールを公開します。ホスト型サーバーはステートレスでマルチテナントです。各リクエストは個別の Authorization: Bearer ptk_live_... ヘッダーで認証されるため、ユーザーごとのデプロイは不要です。

ホスト型（Streamable HTTP）

Streamable HTTP に対応する任意の MCP クライアントから https://api.potarix.com/mcp に接続し、キーをベアラートークンとして送信します。

{
  "mcpServers": {
    "potarix": {
      "url": "https://api.potarix.com/mcp",
      "headers": { "Authorization": "Bearer ptk_live_your_key" }
    }
  }
}

インストール（stdio）

npm install -g potarix-mcp

グローバルにインストールせずに実行することもできます。

npx -y potarix-mcp

設定

Potarix API キーを設定します。

export POTARIX_API_KEY=ptk_live_your_key

任意の設定：

export POTARIX_API=https://api.potarix.com/enricher

Claude Desktop

{
  "mcpServers": {
    "potarix": {
      "command": "npx",
      "args": ["-y", "potarix-mcp"],
      "env": {
        "POTARIX_API_KEY": "ptk_live_your_key"
      }
    }
  }
}

Claude Code

claude mcp add potarix npx -- -y potarix-mcp

次に、Claude Code の実行環境に POTARIX_API_KEY を追加します。

開発

npm install
npm run build
npm run smoke        # stdio transport: connect + tools/list

# Streamable HTTP transport:
npm run start:http   # serves on http://127.0.0.1:8080/mcp (set PORT to change)
# in another shell:
POTARIX_MCP_URL=http://127.0.0.1:8080/mcp npm run smoke:http

環境変数：

変数	デフォルト値	用途
POTARIX_API_KEY	—	API キー（stdio のみ。HTTP ではリクエストごとにベアラーヘッダーから読み取ります）
POTARIX_MCP_TRANSPORT	stdio	Streamable HTTP サーバーを実行する場合は http を指定します（または --http を渡します）
PORT / HOST	8080 / 127.0.0.1	HTTP のバインドアドレス
POTARIX_MCP_PATH	/mcp	HTTP リクエストパス
POTARIX_MCP_ALLOWED_HOSTS	—	ホストの許可リスト（カンマ区切り）。設定すると DNS リバインディング対策が有効になります
POTARIX_API	https://api.potarix.com/enricher	API ベース URL の上書き設定

レジストリへの公開

このリポジトリには、公式 MCP Registry 用の server.json が含まれています。このエントリーは複数の接続方法を備えており、ホスト型の Streamable HTTP リモート（https://api.potarix.com/mcp）と npm の stdio パッケージ（potarix-mcp）の両方を宣言しています。これにより、1 件のレジストリレコードで 2 通りの接続方法を案内できます。

レジストリは npm パッケージを取得して、公開されている mcpName がサーバーの name と一致するかを検証します。そのため、server.json の packages[].version に記載されたバージョンで、npm パッケージを先に公開する必要があります。

公開手順（まずバージョンを更新し、次に npm、最後にレジストリ）：

# 1. Bump package.json + server.json to the same new version (e.g. 0.1.3).
#    server.json must be a NEW version each publish (versions are immutable).
# 2. Build + publish the npm artifact (carries mcpName for ownership proof):
npm publish
# 3. Push the multi-surface server.json to the official MCP Registry:
mcp-publisher login github
mcp-publisher publish

package.json のパッケージ mcpName は server.json と一致している必要があります。

io.github.Potarix/potarix-mcp