Skip to main content
Glama
@agentlair/mcp

@agentlair/mcp

by piiiico

AgentLair

AIエージェントにメールアドレス、暗号化ボールト、行動トラストスコアを提供 — 単一API、OAuth不要。

npm: @agentlair/mcp npm: @agentlair/sdk

機能

説明

メール

@agentlair.dev で送受信できます。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 | bash

Related 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 / Node

2. 環境変数の設定

export AGENTLAIR_API_KEY=al_live_...
export AGENTLAIR_EMAIL=my-agent@agentlair.dev

3. ライフサイクルフックの配線

# 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@latest

MCPクライアントに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/sdk

AgentLair 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

ドキュメント

agentlair.dev/getting-started

AAT × APS境界(クロスプロトコルリファレンス)

AgentLair AATは発行者内のセッションアイデンティティです。AEOESS APS はハンドオフ後の委任チェーンと双方向レシートです。3つのクレームが2つのレイヤーを橋渡しします:jti(APSレシート上のセッションアンカー)、al_nid(1つのEd25519キーがAAT および APSレシートに署名)、al_trust(iat 時点での発行者が証明した行動スナップショット。APS検証側でのインポート時ダウングレードに利用可能)。

共同維持リファレンス:

リポジトリ構造

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

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables 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 npm
    1
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    Provides 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.
    10
    2
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables 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 npm
    Apache 2.0
  • A
    license
    A
    quality
    B
    maintenance
    Enables 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.
    15
    239 npm
    Apache 2.0