Inxmail Mcp

inxmail-mcp

Inxmail Commerce Transactional API 用の MCP サーバーです。イベント、送信、バウンス、ブロックリスト、ブラックリスト、リアクション、配信追跡を Claude から直接管理できます。

クイックスタート

1. インストール

npm install -g inxmail-mcp
# or use npx (no install needed)

2. API 認証情報を取得する

Inxmail Commerce の管理パネルで、API Login Data の下に API キーを作成します。次の情報が取得できます。

• API Key ID（ユーザー名）
• API Secret（パスワード）

インスタンス名は、Inxmail Commerce API URL のサブドメインです。

• https://your-instance.api.inxmail-commerce.com/ -> instance = your-instance

3. Claude Code 用に設定する

claude mcp add inxmail-mcp -e INXMAIL_INSTANCE=your-instance -e INXMAIL_API_KEY_ID=your-key-id -e INXMAIL_API_SECRET=your-secret -- npx -y inxmail-mcp

または、ソースから設定します。

claude mcp add inxmail-mcp -e INXMAIL_INSTANCE=your-instance -e INXMAIL_API_KEY_ID=your-key-id -e INXMAIL_API_SECRET=your-secret -- node /path/to/inxmail-mcp/build/index.js

4. Claude Desktop 用に設定する

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "inxmail": {
      "command": "npx",
      "args": ["-y", "inxmail-mcp"],
      "env": {
        "INXMAIL_INSTANCE": "your-instance",
        "INXMAIL_API_KEY_ID": "your-key-id",
        "INXMAIL_API_SECRET": "your-secret"
      }
    }
  }
}

利用可能なツール

主なユースケース

ツール	説明
check_email_delivery	メールの配信状況を確認します。送信、バウンス、リアクション、ブロック状況を確認できます
check_email_blocked	メールがブロックされているか確認します（ブロックリストのハードバウンスと、ブラックリストの明示的なブロック）
get_server_info	利用可能なすべてのリソースへのリンクを含む API エントリーポイントを取得します

イベント

ツール	説明
trigger_event	トランザクションメールのイベントをトリガーします
get_event_state	トランザクション ID を指定して、トリガーされたイベントの状態／結果を取得します
list_event_types	設定済みのイベントタイプをすべて一覧表示します
get_event_type	ID を指定して、単一のイベントタイプを取得します

送信

ツール	説明
list_sendings	フィルターを指定して、送信済みのトランザクションメールを一覧表示します
get_sending	ID を指定して、特定の送信の詳細を取得します

リアクションと追跡

ツール	説明
list_reactions	受信者のリアクション（開封とクリック）を一覧表示します
list_deliveries	配信状況の情報を一覧表示します

バウンスと苦情

ツール	説明
list_bounces	バウンスしたトランザクションメールを一覧表示します
list_complaints	フィードバックループの苦情を一覧表示します

ブロックリスト（ハードバウンス）

ツール	説明
list_blocklist	ハードバウンスによってブロックされたメールアドレスを一覧表示します
get_blocklist_entry	特定のメールがブロックリストに登録されているか確認します
remove_from_blocklist	メールをブロックリストから削除します

ブラックリスト（明示的なブロック）

ツール	説明
list_blacklist	明示的にブラックリストに登録されたメールアドレスを一覧表示します
get_blacklist_entry	特定のメールがブラックリストに登録されているか確認します
add_to_blacklist	メールアドレスをブラックリストに追加します
remove_from_blacklist	メールをブラックリストから削除します

メールリレー

ツール	説明
list_relay_sendings	メールリレーの送信を一覧表示します
get_relay_sending	特定のメールリレー送信の詳細を取得します
list_relay_reactions	メールリレーのリアクション（開封、クリック）を一覧表示します
list_relay_bounces	メールリレーのバウンスを一覧表示します
list_relay_complaints	メールリレーの苦情を一覧表示します

生メール

ツール	説明
send_raw_mail	完全な RFC 5322 メールを送信します（Base64 エンコード）

エラーログ

ツール	説明
list_error_logs	エラーログのエントリーを一覧表示します
get_error_log	ID を指定して単一のエラーログエントリーを取得します
mark_error_log_read	エラーログのエントリーを既読にします

プロンプトの例

"Is [email protected] blocked or blacklisted?"

"Check the delivery status for [email protected]"

"List all bounces from last week"

"Trigger a welcome email event for [email protected]"

"Show me all event types configured in the system"

"List recent complaints from the last 30 days"

開発

git clone https://github.com/shahabazdev/inxmail-mcp.git
cd inxmail-mcp
npm install
npm run build

テスト

npm test          # run all tests
npx vitest        # run in watch mode

Vitest でユニットテストを実行します。対象は以下のとおりです。

• API クライアント（認証、リクエストメソッド、クエリパラメーター、ページネーション、エラー処理）
• ツールの登録（29 個すべてのツールが登録されていること、重複がないこと）

環境変数

変数	必須	説明
INXMAIL_INSTANCE	はい	インスタンスのサブドメイン（例：your-instance）
INXMAIL_API_KEY_ID	はい	API キー ID
INXMAIL_API_SECRET	はい	API シークレット

ライセンス

MIT