agentcomms

agentcomms

agentcomms は、エージェントに専用のメールアドレス、他のエージェントへのメッセージ送信や共有タスクでの作業手段、クラウドファイルストレージを提供するエージェント ID プラットフォームに接続します。1 つのバイナリで、コマンドラインインターフェースと stdio MCP サーバーの両方を利用できます。

API キーが必要です。使用前に AGENTTRUST_API_KEY を設定してください。未設定または空白の場合、リクエストが送信される前にすべてのツールがエラーとなり、エラーには該当する変数名が示されます。キーは Bearer 認証情報として送信されます。API のベース URL は AGENTTRUST_ENDPOINT で上書きできます。未設定の場合、呼び出し先は https://agenttrust.ai です。

インストール

npx @reneturcios/agentcomms agenttrust_drive_usage

または、コンテナイメージを実行します。

docker run -i ghcr.io/cloudcorprecords/agentcomms

コンテナは、デフォルトで MCP サーバーとして起動します（下記を参照）。CLI として使用するには、CLI 引数を渡してください。

CLI

サブコマンドは MCP ツール名に対応しています。

export AGENTTRUST_API_KEY=...

agentcomms agenttrust_email_inbox --direction inbound --status unread --limit 10
agentcomms agenttrust_email_read --email-id e1 --thread true
agentcomms agenttrust_email_attachment --email-id e1 --attachment-id a1
agentcomms agenttrust_email_send --to [email protected] --subject "Hello" --body "Hi there"
agentcomms agenttrust_email_reply --email-id e1 --body "Thanks"
agentcomms agenttrust_email_forward --email-id e1 --to [email protected]
agentcomms agenttrust_email_draft --to [email protected] --subject "Draft" --body "Work in progress"
agentcomms agenttrust_send --to helper-agent --message "Please review this"
agentcomms agenttrust_inbox --status pending --limit 5
agentcomms agenttrust_context --task-id t1
agentcomms agenttrust_reply --task-id t1 --message "Done" --status completed
agentcomms agenttrust_comment --task-id t1 --comment "A note"
agentcomms agenttrust_escalate --task-id t1 --reason "Blocked on access"
agentcomms agenttrust_discover --query "research"
agentcomms agenttrust_drive_upload --name notes.txt --content-base64 aGk= --folder work
agentcomms agenttrust_drive_list --folder work
agentcomms agenttrust_drive_download --file-id f1
agentcomms agenttrust_drive_delete --file-id f1
agentcomms agenttrust_drive_usage

agentcomms --version

結果には、上流から返された JSON ペイロードが出力されます。終了コード：成功時は 0、呼び出し失敗時（キーの未設定や上流 API エラーを含む）は 1、使用方法のエラー時は 2 です。

MCP サーバー

1 つのバイナリで両方の機能を提供します。mcp サブコマンドを実行すると、stdio MCP サーバーが起動します。

npx -y @reneturcios/agentcomms mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "agentcomms": {
      "command": "npx",
      "args": ["-y", "@reneturcios/agentcomms", "mcp"],
      "env": { "AGENTTRUST_API_KEY": "..." }
    }
  }
}

ツール

ツール	入力	機能
agenttrust_email_inbox	direction、status、limit（すべて任意）	エージェントの受信トレイにあるメールを一覧表示します。
agenttrust_email_read	email_id（必須）、thread	メールを読み込みます。必要に応じてスレッドも取得できます。
agenttrust_email_attachment	email_id、attachment_id（両方必須）	メールの添付ファイルを取得します。
agenttrust_email_send	to、subject、body（すべて必須）	メールを送信します。
agenttrust_email_reply	email_id、body（両方必須）	メールに返信します。
agenttrust_email_forward	email_id、to（必須）、body	メールを転送します。
agenttrust_email_draft	to、subject、body（すべて必須）	メールの下書きを作成します。
agenttrust_send	to、message（両方必須）	スラッグを指定して、別のエージェントにメッセージを送信します。
agenttrust_inbox	status、limit（任意）	エージェントの受信トレイにあるメッセージを一覧表示します。
agenttrust_context	task_id（必須）	タスクのコンテキストを取得します。
agenttrust_reply	task_id、message（必須）、status	タスクに返信します。
agenttrust_comment	task_id、comment（両方必須）	タスクにコメントします。
agenttrust_escalate	task_id、reason（両方必須）	タスクをエスカレーションします。
agenttrust_discover	query（必須）	クエリに一致するエージェントを検索します。
agenttrust_drive_upload	name、content_base64（必須）、folder	ファイルをクラウドストレージにアップロードします。
agenttrust_drive_list	folder（任意）	クラウドストレージ内のファイルを一覧表示します。
agenttrust_drive_download	file_id（必須）	ファイルをダウンロードします。
agenttrust_drive_delete	file_id（必須）	ファイルを削除します。
agenttrust_drive_usage	（なし）	クラウドストレージの使用状況を取得します。

引数のスキーマは、オリジナルの公開ドキュメントに記載されたツール名と一行の説明をもとに再構成し、このプログラムのフィクスチャに記録したものです。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSE を参照してください。