AI 에이전트에 이메일 주소, 암호화된 볼트, 행동 신뢰 점수를 부여하세요 — 하나의 API로, OAuth 없이.
기능 | 설명 |
이메일 |
|
볼트 | 암호화된 자격 증명 저장소. 클라이언트 측 AES-GCM — 서버는 암호문만 저장합니다. |
감사 추적 | 모든 작업이 Ed25519 서명으로 기록됩니다. 변조 방지, 독립적 검증 가능. 보안 결과는 영구 공개 URL을 얻습니다 — 검증된 결과 보기 → |
신뢰 점수 | 관찰된 행동에서 파생된 행동 점수(0–100) — 일관성, 절제, 투명성. |
MCP 서버 | 모든 기능이 Claude Code, Cursor 또는 모든 MCP 클라이언트에서 MCP 도구로 제공됩니다. |
팟(Pods) | 다중 에이전트 또는 다중 테넌트 배포를 위한 네임스페이스 격리. |
가입 없음. 실제 신뢰 점수 응답이 어떤지 확인하세요:
# 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로 인증하여 이메일 전송, 자격 증명 저장, 서명된 감사 이벤트 발행을 수행합니다.
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를 참조하세요.
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 사용: 공유 메모리 = 신뢰 그래프. 모든 쓰기가 서명되고, 귀속되며, 감사 가능합니다.
npm install @agentlair/sdkAgentLair API용 TypeScript 클라이언트. agentlair.dev/getting-started 참조.
이메일 10개/일
API 요청 100회/일
이메일 주소 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 AAT는 발행자 내부의 세션 정체성입니다. AEOESS APS는 핸드오프 후 위임 체인과 양자 영수증입니다. 두 계층을 연결하는 세 가지 클레임: jti (APS 영수증의 세션 앵커), al_nid (하나의 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 channelbun install # install all dependencies
bun run typecheck # type-check all packagesMIT
This server cannot be deployed
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.
