Agentlair MCP server

by piiiico·io.github.piiiico/agentlair·v1.3.0

No reviews yet

Give AI agents a real email address, vault, calendar, and task delegation via MCP.

B75/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B75/100

full report

Adoption

Growing

5 stars29 downloads/wk

Reviews

Write one

Nobody has reviewed Agentlair yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Agentlair tools (15, 5 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

calendar_create_eventwrite action
Create a calendar event on your AgentLair calendar. Events are published via iCal feed for human subscription (Google Calendar, Apple Calendar, Outlook).
calendar_delete_eventwrite action
Delete an event from your AgentLair calendar by event ID. Use calendar_list_events to find event IDs.
calendar_get_feed
Get the public iCal subscription URL for your AgentLair calendar. Share this URL with calendar apps (Google Calendar, Apple Calendar, Outlook) so humans can subscribe and see agent-created events.
calendar_list_events
List events on your AgentLair calendar. Optionally filter by date range.
check_inbox
Check the inbox for an @agentlair.dev address. Returns recent messages with sender, subject, and received time.
claim_address
Claim a new @agentlair.dev email address for your agent. No DNS or SMTP setup required. Free tier: up to 3 addresses.
delegate_task
Delegate a task to another AgentLair agent. The task is delivered to the agent's inbox and picked up asynchronously. Use this when you need another agent to do something — send an email, run a deployment, do research, etc.
list_addresses
List all @agentlair.dev addresses claimed on your account.
preflight_trust_check
Check trust readiness before engaging with an agent. Returns a ReadinessCard: trust score, behavioral maturity level, whether it's safe to engage, and any caveats. Call this before delegating tasks, accepting agent output, or authorizing payments involving an unknown agent. Free — no extra charge beyond your API key.
read_message
Read the full content of a specific email message, including the body. Use message IDs from check_inbox.
send_emailwrite action
Send an email from an @agentlair.dev address you own to any recipient. No SMTP setup needed.
vault_deletewrite action
Delete a key and all its versions from the AgentLair Vault.
vault_get
Retrieve a stored value from the AgentLair Vault by key name.
vault_list
List all keys stored in your AgentLair Vault (metadata only, values not returned).
vault_putwrite action
Store a value in the AgentLair Vault. Use this to persist API keys, secrets, or any data your agent needs across sessions. Best practice: encrypt sensitive data client-side before storing (the server stores whatever you send).

Public scan report

scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it

no findings

Code scan3 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 35 days ago12/15
Maintainer identityregistry namespace matches repository owner6/10

Overall 75/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

What the publisher says

From the Agentlair repository's README, as published. We do not edit it. Read it on GitHub

AgentLair

Give your AI agent an email address, encrypted vault, and a behavioral trust score — one API, no OAuth required.

Try it in 30 seconds

No signup. See what a live trust score response looks like:

# 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'

Rate limited to 10 requests/minute per IP. Response shape matches the live /v1/trust/:agentId endpoint.

Full interactive demo — register a real agent, submit observations, get a live trust score (curl + jq, ~60 seconds):

curl -sL https://raw.githubusercontent.com/piiiico/agentlair/main/examples/quickstart.sh | bash

Register an agent

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."
}

From here, the agent authenticates with api_key to send email, store credentials, and emit signed audit events.

Quickstart: Add AgentLair to your agent

1. Install

pip install agentlair            # Python
npm install @agentlair/sdk       # TypeScript / Node

2. Set env vars

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

3. Wire lifecycle hooks

# 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!;

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Install directly

Runs npx -y @agentlair/mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add agentlair -- npx -y @agentlair/mcp

Add to Cursor

Agentlair: common questions

Is Agentlair MCP server safe?: Mostly: it is graded B (75/100). Read the Agentlair safety report
How do I install Agentlair?: It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
Does Agentlair need an API key?: Yes. The registry entry asks for AGENTLAIR_API_KEY.
Is Agentlair maintained?: The last commit was 36 days ago (2026-08-22). The latest release is v1.3.0.
What can I use instead of Agentlair?: Servers from other publishers that do the same job: Postfleet MCP server, MCP Server and Google Workspace MCP server. Compare all Agentlair alternatives.

Alternatives to Agentlair

Same job from other publishers: the closest match first, then the best rated.

All Agentlair alternatives →

Postfleet
Give an AI agent its own email address: send, reply, read, and wait for mail.
not reviewed
Growing
A
MCP Server
Give your agent its own email address with graduated human oversight, from approval to autonomy.
not reviewed
Growing
A
Google Workspace
Give AI agents access to Gmail, Calendar, Drive, and more — multi-account, manifest-driven
not reviewed
Established
A
Local MCP
Mac & Windows: let ChatGPT, Claude & Cursor use your email, calendar, iMessage, Teams, files. Free.
not reviewed
Established
C
Outlook Assistant
Microsoft Outlook MCP server — 22 tools for email, calendar, contacts, and mailbox management.
not reviewed
Growing
A

Agentlair vs Postfleet Agentlair vs MCP Server Agentlair vs Google Workspace