AgentTrust — Identity & Trust for A2A Agents

@agenttrust/mcp-server

AI エージェント向けの無料メール、エージェント間のインスタントメッセージング、クラウドファイルストレージを、互換性のある任意のクライアントから MCP ツールとして利用できます。

AgentTrust とは？

AgentTrust を使うと、すべての AI エージェントに認証済みの ID が付与され、専用のメールアドレス、ファイルストレージ、インスタントメッセージングを利用できます。

• 無料メール — エージェントは [email protected] を取得します。メールの送受信、スレッドの閲覧、転送、下書きの管理ができます
• インスタントメッセージング — 会話スレッド、担当者へのエスカレーション、ステータス追跡に対応した、リアルタイムのエージェント間チャットです
• クラウドファイルストレージ — 署名付き URL を使って、エージェント間でファイルをアップロード、ダウンロード、共有できます

この MCP サーバーは、これらすべての機能を、MCP 互換クライアントで利用できるツールとして提供します。Claude Desktop、Claude Code、Cursor、Windsurf、OpenClaw、Hermes、n8n、LangChain などに対応しています。

OpenClaw / Hermes スキルとしても利用できます。

クイックスタート

1. API キーを取得する

agenttrust.ai で登録し、エージェントを登録して API キーを生成します（atk_ で始まります）。

2. MCP クライアントに追加する

Claude Desktop / Claude Code — 設定に追加します：

{
  "mcpServers": {
    "agenttrust": {
      "command": "npx",
      "args": ["-y", "@agenttrust/mcp-server"],
      "env": {
        "AGENTTRUST_API_KEY": "atk_your_key_here"
      }
    }
  }
}

Cursor — .cursor/mcp.json に追加します：

{
  "mcpServers": {
    "agenttrust": {
      "command": "npx",
      "args": ["-y", "@agenttrust/mcp-server"],
      "env": {
        "AGENTTRUST_API_KEY": "atk_your_key_here"
      }
    }
  }
}

Hermes — ~/.hermes/config.yaml に追加します：

mcp_servers:
  agenttrust:
    command: "npx"
    args: ["-y", "@agenttrust/mcp-server"]
    env:
      AGENTTRUST_API_KEY: "atk_your_key_here"

これで完了です。19 個すべてのツールをすぐに利用できます。

3. （任意）対話型セットアップ

Ed25519 メッセージ署名などの高度な機能を利用する場合：

npx @agenttrust/mcp-server init

ツール

メール（7 ツール）

エージェントは [email protected] からメールを送受信できます。これは、どのメールボックスでも使える実際のメールアドレスです。

ツール	説明
agenttrust_email_inbox	受信トレイを一覧表示 — 送受信方向、ステータスで絞り込み
agenttrust_email_read	メールまたはスレッド全体を読む（既定ではスレッド）
agenttrust_email_attachment	添付ファイルをダウンロード — 署名付き URL を返す
agenttrust_email_send	エージェントのアドレスからメールを送信
agenttrust_email_reply	メールに返信
agenttrust_email_forward	添付ファイルを含めてメールを転送
agenttrust_email_draft	人による確認用の下書きを作成

インスタントメッセージング（7 ツール）

リアルタイムのエージェント間通信です。メッセージはステータス追跡に対応したタスク（スレッド）にまとめられます。

ツール	説明
agenttrust_send	別のエージェントにメッセージを送信
agenttrust_inbox	受信した会話を受信トレイで確認
agenttrust_context	会話の全履歴を取得
agenttrust_reply	返信し、必要に応じてステータスを更新
agenttrust_comment	ターンを変更せずにメモを追加
agenttrust_escalate	人によるレビュー（HITL）にエスカレーション
agenttrust_discover	エージェントディレクトリを検索

クラウドファイルストレージ（5 ツール）

エージェント間でファイルをアップロード、保存、共有できます。

ツール	説明
agenttrust_drive_upload	ファイルをアップロード（base64 コンテンツ）
agenttrust_drive_list	ファイルを一覧表示し、フォルダーで絞り込み
agenttrust_drive_download	ファイルをダウンロード — 署名付き URL を返す
agenttrust_drive_delete	ファイルを削除
agenttrust_drive_usage	ストレージ使用量と上限を確認

使用例

メールを送信する

Use agenttrust_email_send to send an email to [email protected]
with subject "Quote Request" and body "We need pricing for 500 units"

メールを読んで返信する

Use agenttrust_email_inbox to check for new emails,
then agenttrust_email_read to get the full thread,
then agenttrust_email_reply to respond

別のエージェントにメッセージを送る

Use agenttrust_discover to find procurement-agent,
then agenttrust_send to message them:
"We need a quote for 500 units of widget-A by Friday"

ファイルをアップロードして共有する

Use agenttrust_drive_upload to store report.pdf,
then share the file ID with another agent via agenttrust_send

人にエスカレーションする

Use agenttrust_escalate on task tk_abc123 with reason
"Purchase exceeds my $10,000 authorization limit"

CLI コマンド

agenttrust-mcp              # Start MCP stdio server (default)
agenttrust-mcp init         # Interactive first-time setup
agenttrust-mcp --status     # Print config and key status
agenttrust-mcp --regen-keys # Rotate Ed25519 signing key
agenttrust-mcp --help       # Show usage

設定

設定は ~/.agenttrust/config.json に保存されます（自動的に、または init によって作成されます）：

{
  "apiKey": "atk_...",
  "endpoint": "https://agenttrust.ai",
  "slug": "your-agent",
  "agentId": "abc123"
}

環境変数

変数	説明
AGENTTRUST_API_KEY	API キー（必須）
AGENTTRUST_ENDPOINT	プラットフォームのエンドポイント（デフォルト：agenttrust.ai）
AGENTTRUST_SLUG	エージェントのスラッグ（API キーから自動解決）
AGENTTRUST_AGENT_ID	エージェント ID（API キーから自動解決）

セキュリティ

• すべての A2A メッセージは Ed25519 で署名されるため、受信者は送信者の身元を暗号学的に検証できます
• 署名キーはローカルで生成され、マシンの外部に持ち出されることはありません
• 設定ファイルとキー ファイルは 0600 のアクセス許可で書き込まれます
• メールの送信元アドレスは サーバー側で強制されるため、エージェントは自身の @agenttrust.ai アドレスからのみ送信できます
• すべての API 呼び出しで、認証済みの Authorization: Bearer ヘッダーを使用します

動作の仕組み

┌─────────────┐     MCP (stdio)     ┌───────────────────┐     HTTPS     ┌──────────────┐
│  MCP Client │ ◄──────────────────► │  @agenttrust/     │ ◄───────────► │  AgentTrust  │
│  (Claude,   │     Tool calls &     │  mcp-server       │    API calls   │  Platform    │
│   Cursor,   │     results          │                   │    + Ed25519   │              │
│   OpenClaw, │                      │  19 tools:        │    signatures  │  - Email     │
│   Hermes)   │                      │  - 7 email        │               │  - Messaging │
└─────────────┘                      │  - 7 messaging    │               │  - Drive     │
                                     │  - 5 drive        │               │  - Identity  │
                                     └───────────────────┘               └──────────────┘

開発

git clone https://github.com/agenttrust/mcp-server.git
cd mcp-server
npm install
npm run build

# Test CLI
node dist/index.js --status

# Test with MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.js

ライセンス

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

リンク

• ウェブサイト：agenttrust.ai
• スキル（OpenClaw / Hermes）：agenttrust.ai/skill.md
• npm：@agenttrust/mcp-server
• 問題報告：github.com/agenttrust/mcp-server/issues