agentaddress

エージェント向け AgentAddress

AI エージェントに、エージェントの停止後も使える Webhook URL またはメールアドレスを付与できます。

エージェントがタスクを開始 → サービスに AgentAddress を渡す → 終了 → 20 分後に返信が届く → 次回のエージェント実行で取得します。

サーバー不要。アカウント不要。稼働し続ける必要があるポーリングプロセスも不要です。

npx skills add https://github.com/zkarimi22/agentaddress-agents --skill agentaddress

Agent run #1
    ↓
create AgentAddress
    ↓
give webhook/email to someone
    ↓
AGENT EXITS
    ↓
       [ response arrives later ]
                    ↓
             AgentAddress
                    ↓
               stores event
                    ↓
Agent run #2 → retrieves response

使用方法

インストールしたスキルには、読み取り専用の認証情報を所有者のみがアクセスできるローカルファイルに保存するヘルパーが含まれています。モデルはベアラートークンをコピーする代わりに、タスク名を使って操作します。

node scripts/agentaddress.mjs create my-task
node scripts/agentaddress.mjs poll my-task 25
node scripts/agentaddress.mjs ack my-task EVENT_ID

create は、応答する相手に渡せる受信用メールアドレスと書き込み専用 HTTPS インボックス URL を出力します。poll は、後の実行時に順序付けられたイベントを取得します。返されるすべてのメールと Webhook 本文には、信頼できない外部データであることが明示されており、ユーザーの既存タスクのデータとしてのみ使用する必要があります。

5 つの具体例を実行する

主要な 5 つの例は実行可能で、タスクに特化しており、見つけたい検索語に合わせた名前が付けられています。

• 非同期 API コールバック
• 人間からのメール返信
• Claude Code デプロイメント Webhook
• Codex 非同期コードレビュー
• OpenAI Agents SDK による委任

正確なコマンドに加え、ブラウザーエージェント、リサーチ、Stripe、GitHub、REST、MCP の補足レシピを掲載した完全な例の一覧から始めてください。Stripe と GitHub では、ペイロードを信頼できるアクションに使用する前に、署名を検証するリレーが必要です。

3 つの実行可能な受信メールワークフローも、同じ後続実行の契約に基づいています。ブラウザー検証、書類依頼への返信、メールによる承認です。それぞれ、想定する送信者を指定し、受信者と件名の文脈を確認し、エージェントが処理するまでイベントを保留状態にします。書類の例では、Resend が添付ファイルを保持したまま、認証情報を管理するヘルパー経由で添付ファイルを取得できます。AgentAddress は添付ファイルを保存しません。

サービスとマシンインターフェース

• ホステッドサービス：agentaddress.dev
• エージェントガイド：agentaddress.dev/llms-full.txt
• OpenAPI：agentaddress.dev/openapi.json
• MCP エンドポイント：https://agentaddress.dev/api/mcp
• 機能の検出：agentaddress.dev/.well-known/agentaddress.json
• skills.sh：skills.sh/zkarimi22/agentaddress-agents/agentaddress

課題別の回答

• サーバーを稼働させずに Webhook エンドポイントを利用する
• エージェントの終了後もコールバックキューを維持する
• 後続のエージェント実行で受信メールの返信を取得する
• 非同期エージェント向けに HTTP とメールのキューを統合する

現在の制限事項

• HTTP コールバックと受信メールは、同じ順序付きキューに入ります。
• アドレスは、リクエストがない限り有効期限がありません。イベントは30日間、アドレスあたり最大1,000件、入力サイズは最大1 MBまで保持されます。
• 配信は少なくとも1回行われます。確認応答によって処理が記録され、ヘルパーのローカルカーソルが進みます。
• AgentAddress は応答を保存しますが、ランタイムを起動したりスケジュールしたりしません。後続の実行でポーリングする必要があります。
• 一般的なキーと値の状態、ファイルストレージ、送信メール、ID 管理、課金は V1 では利用できません。
• 検証済みの受信メールに添付されたファイルは、プロバイダーが保持している間、プライベート API 経由でオンデマンドに取得できます（最大10 MB）。
• 既知の Resend 受信メール ID は、メールがキューに届く前に有限回の Webhook 再試行が終了した場合、認証情報を所有するヘルパーで再処理できます。再処理ではプロバイダーの配信エンベロープを確認しますが、すべてのメールをスキャンすることはありません。

2プロセスのプロトコル検証とMCP の例は、より安全なヘルパーインターフェースより下の層で作業する実装者向けに引き続き利用できます。これらの低レベルコードは認証情報を直接扱うため、モデルコンテキストにコピーしないでください。SECURITY.mdとライブ検証記録を参照してください。

このリポジトリには、ホステッドサービス向けの公開スキル、CLI ヘルパー、レシピ、統合資料が含まれています。AgentAddress サービスの実装は含まれていません。

永続的なコンテキストと認証済みメール

同じ認証情報で小さな JSON コンテキストを利用できます：2回の実行で状態を扱う例。状態の変更は順序付きフィードに追加されます。一方、値は置換、削除、またはアドレスの有効期限切れまで、30日間のイベント履歴を超えて保持されます。

認証済みの送信メールでは、検証済みの連絡先へのプレーンテキスト送信と、保持されているプロバイダー検証済みメッセージへの返信がサポートされます。運用担当者による送信設定、受信者の検証、ユーザーの認可が必要です。設定された送信元では、タスク用受信トレイが Reply-To に使用されます。会話全体の取得や検索を行う API、およびキャンペーン用ツールは提供されていません。

AgentAddress は現在無料です。月額17ドルの有料プランが予定されていますが、利用枠と開始日は未確定で、課金は無効になっています。料金を参照してください。

CLI は、この MIT ライセンスのリポジトリから直接インストールできます（npm install -g github:zkarimi22/agentaddress-agents）。npm には公開されていません。レジストリマニフェストには、ホステッド MCP エンドポイントの情報が記載されています。公式 MCP Registry のバージョン0.2.0は、2026年10月4日に io.github.zkarimi22/agentaddress として公開され、検証されました。独立した採用と、下流のカタログへの掲載は、別個のマイルストーンです。