@agentlair/mcp
AgentLair
AIエージェントにメールアドレス、暗号化ボールト、行動トラストスコアを提供 — 単一API、OAuth不要。
機能 | 説明 |
メール |
|
ボールト | 暗号化された認証情報ストレージ。クライアントサイドAES-GCM — サーバーは暗号文のみを保存します。 |
監査証跡 | すべてのアクションがEd25519署名で記録されます。改ざん検知可能で、独立して検証可能です。セキュリティ上の発見事項は恒久的な公開URLを取得します — 検証済みの発見事項を見る → |
トラストスコアリング | 観察されたアクションから導出される行動スコア(0〜100)— 一貫性、節度、透明性。 |
MCPサーバー | すべての機能がMCPツールとしてClaude Code、Cursor、または任意のMCPクライアントで利用可能です。 |
ポッド | マルチエージェントまたはマルチテナント展開のための名前空間分離。 |
30秒で試す
サインアップ不要。実際のトラストスコアレスポンスがどのようなものか見てみましょう:
# Healthy agent — high trust (score 84, principal level)
curl https://agentlair.dev/v1/demo{
"agentId": "acc_demo_healthy_XXXXXXXXXX",
"score": 84,
"confidence": 0.91,
"atfLevel": "principal",
"trend": "stable",
"dimensions": {
"consistency": { "score": 0.82 },
"restraint": { "score": 0.87 },
"transparency": { "score": 0.80 }
},
"observationCount": 1847
}# Suspicious agent — score 31, declining trend
curl 'https://agentlair.dev/v1/demo?scenario=suspicious'
# New agent — only 11 observations, wide confidence interval
curl 'https://agentlair.dev/v1/demo?scenario=new'IPごとに毎分10リクエストに制限されています。レスポンス形式はライブの /v1/trust/:agentId エンドポイントと同じです。
完全なインタラクティブデモ — 実際のエージェントを登録し、観察結果を送信して、ライブのトラストスコアを取得します(curl + jq、約60秒):
curl -sL https://raw.githubusercontent.com/piiiico/agentlair/main/examples/quickstart.sh | bashRelated MCP server: agentmail
エージェントの登録
curl -X POST https://agentlair.dev/v1/auth/agent-register \
-H "Content-Type: application/json" \
-d '{"name": "my-research-agent"}'{
"api_key": "al_live_...",
"account_id": "acc_...",
"email_address": "my-research-agent@agentlair.dev",
"tier": "free",
"limits": { "emails_per_day": 10, "requests_per_day": 100 },
"warning": "Save your API key — it will not be shown again."
}ここから、エージェントは api_key で認証し、メールの送信、認証情報の保存、署名付き監査イベントの発行を行います。
クイックスタート:エージェントにAgentLairを追加
1. インストール
pip install agentlair # Python
npm install @agentlair/sdk # TypeScript / Node2. 環境変数の設定
export AGENTLAIR_API_KEY=al_live_...
export AGENTLAIR_EMAIL=my-agent@agentlair.dev3. ライフサイクルフックの配線
# Python — three integration points
import os, agentlair
lair = agentlair.AgentLair(os.environ["AGENTLAIR_API_KEY"])
addr = os.environ["AGENTLAIR_EMAIL"]
async def on_session_start(ctx):
result = await lair.email.inbox(addr)
if result["messages"]:
ctx.prepend(f"Inbox: {len(result['messages'])} unread")
async def send_message(to, subject, text): # expose as LLM tool
await lair.email.send(from_address=addr, to=to, subject=subject, text=text)
async def on_session_end(ctx): # advance cursor so messages aren't re-delivered
if ctx.last_message_id:
await lair.vault.store("inbox_cursor", ctx.last_message_id)// TypeScript
import { AgentLair } from '@agentlair/sdk';
const lair = new AgentLair(process.env.AGENTLAIR_API_KEY!);
const addr = process.env.AGENTLAIR_EMAIL!;
// Session start — drain inbox before planning
const { messages } = await lair.email.inbox(addr);
if (messages.length) context.prepend(`Inbox: ${messages.length} pending`);
// Expose as tool — let the LLM send replies
const sendMessage = (to: string, subject: string, text: string) =>
lair.email.send({ from: addr, to, subject, text });オフライン中はメッセージが蓄積され、次のセッション開始時に排出されます。完全なプラグイン例(peek+ack、クラッシュセーフな配信)については:hermes-agentlair を参照してください。
MCPサーバー
npx @agentlair/mcp@latestMCPクライアントに9つのツールを追加します:エージェント登録、メール送受信、ボールトの保存/取得、監査イベントの発行、トラストスコアのクエリ。
エージェントメモリにはトラストレイヤーが必要
エージェントメモリは実際のインフラストラクチャです。4層のメモリ階層、マルチエージェントリース、エージェントセッション間での保存と取得のための51以上のMCPツール。複数のエージェントがメモリプールを共有する場合、そのカテゴリは機能します。
ギャップ:任意のエージェントが共有メモリに何でも書き込めます。誰が何を書いたかの検証がなく、争われた状態を監査する方法もなく、破壊的な書き込みに対するトラストゲーティングもありません。アイデンティティのない共有メモリプールは、誰でも落書きできるメモ帳です。
すべての書き込みは帰属可能であるべきです。 AgentLairのエージェント証明トークン(AAT)は、エージェントの did:web アイデンティティと行動トラストスコアを保持する短命のEdDSA JWTです。メモリ書き込みの Authorization ヘッダーとして提示すると、書き込みは暗号的に署名され、監査可能になります:
import { AgentLair } from '@agentlair/sdk';
const lair = new AgentLair(process.env.AGENTLAIR_API_KEY!);
// Issue a short-lived AAT (5 min) scoped to the memory server
const { token } = await lair.tokens.issue({
audience: 'memory.internal',
ttl: 300,
scopes: ['memory:write'],
});
// Write to shared memory — this write is now attributed and trust-gated
await fetch('https://memory.internal/mcp/memory/write', {
method: 'POST',
headers: {
'Authorization': `Bearer ${token}`, // signed agent identity
'Content-Type': 'application/json',
},
body: JSON.stringify({
key: 'research/competitor-analysis',
value: { /* ... */ },
}),
});メモリサーバーは標準のJWKSを介してAATを検証します — 受信側にAgentLair SDKは不要です。al_trust クレームにより、行動トラストレベルで書き込みをゲートできます(例:junior 未満のエージェントからの書き込みを拒否)。
AATなし:共有メモリ = 共有メモ帳。任意のエージェントが何でも書き込み、争われた状態には来歴がありません。
AATあり:共有メモリ = トラストグラフ。すべての書き込みは署名され、帰属され、監査可能です。
SDK
npm install @agentlair/sdkAgentLair API用のTypeScriptクライアント。agentlair.dev/getting-started を参照してください。
無料ティア
1日あたり10通のメール
1日あたり100回のAPIリクエスト
10個のメールアドレス
Pro:より高い制限のため、スタックあたり月額5ドル。
アーキテクチャ
API: Cloudflare Workers — エッジ展開、低レイテンシ
状態: Cloudflare KV
ボールト暗号化:
@agentlair/vault-cryptoによるクライアントサイドAES-GCM。サーバーは暗号文のみを保存します — 保存時に平文の認証情報はありません。監査証跡: Ed25519署名付きイベントチェーン。各イベントはサーバーを信頼せずに独立して検証可能です。
私たちはAgentLair上で自社のエージェントインフラを本番運用してきました。何が壊れたか、行動トラストスコアリングの構築で学んだことのメモ:agentlair.dev/blog/from-0-to-41-building-behavioral-trust-in-production
ドキュメント
AAT × APS境界(クロスプロトコルリファレンス)
AgentLair AATは発行者内のセッションアイデンティティです。AEOESS APS はハンドオフ後の委任チェーンと双方向レシートです。3つのクレームが2つのレイヤーを橋渡しします:jti(APSレシート上のセッションアンカー)、al_nid(1つのEd25519キーがAAT および APSレシートに署名)、al_trust(iat 時点での発行者が証明した行動スナップショット。APS検証側でのインポート時ダウングレードに利用可能)。
共同維持リファレンス:
agent-passport.org/aat-aps-boundary.html(AEOESS側、正規)
リポジトリ構造
packages/
worker/ — Core API worker (Cloudflare Workers)
sdk/ — @agentlair/sdk client library
mcp-server/ — @agentlair/mcp MCP server
vault-crypto/ — @agentlair/vault-crypto end-to-end encryption
verify/ — @agentlair/verify AAT token verification
email-worker/ — Email processing worker
apps/
dashboard/ — Agent dashboard UI
email-channel/ — Email MCP channel開発
bun install # install all dependencies
bun run typecheck # type-check all packagesライセンス
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Hosted email MCP for AI agents with inboxes, send/receive, memory, recovery, and credits.
MCP-native Trust Infrastructure for AI Agents. Persistent encrypted memory with Trust Quotient.
Phone, SMS and email for AI agents. One remote MCP endpoint, OAuth login, zero install.
AI agent registry — search, discover, register, and connect agents via MCP.
Related MCP Servers
AlicenseNot gradedqualityBmaintenanceEnables AI agents to use email, instant messaging, and cloud file storage via MCP tools, giving each agent a verified identity with its own email address, real-time chat, and file sharing capabilities.106 npm1MIT- AlicenseAqualityAmaintenanceProvides AI agents with compliance screening (OFAC sanctions, risk scoring, Know-Your-Agent) plus disposable email and SMS verification for OTPs, accessible via MCP tools, HTTP API, and CLI.102MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to send and receive signed/encrypted mail at agent@domain addresses, manage store-and-forward mailboxes, and operate a double-entry ledger with escrow and bond contracts through MCP tools.125 npmApache 2.0

Proofable MCPofficial
AlicenseAqualityBmaintenanceEnables AI agents to manage identity, permissions, secrets, and verifiable proofs through a hosted MCP server, letting clients sign in and check what an agent may do before it acts.15239 npmApache 2.0