AgentLair

piiiico/agentlair

Gives AI agents a persistent email address at agentlair.dev, encrypted vault storage, and tamper-evident audit logging with Ed25519 signatures. The MCP server exposes nine tools for agent registration, sending and receiving mail, storing credentials client-side encrypted with AES-GCM, emitting audit events, and querying behavioral trust scores. Built on Cloudflare Workers with KV storage. The audit trail is independently verifiable and designed for EU AI Act compliance requirements. Free tier includes 10 emails and 100 API requests per day. Useful when your agent needs to communicate asynchronously over email, persist secrets without OAuth flows, or maintain a cryptographically signed activity log.

GitHub stars: 5
tools: 15
auth: Secret needed
transport: STDIO, HTTP
env var: 1
last updated: Nov 4, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://agentlair-mcp-server.amdal-dev.workers.dev/mcp --name agentlair --header 'Authorization: Bearer ${API_TOKEN}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http agentlair https://agentlair-mcp-server.amdal-dev.workers.dev/mcp --header 'Authorization: YOUR_AUTHORIZATION'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 15 tools

Verified live against the running server on Nov 6, 2026.

send_emailSend an email from your AgentLair address (@agentlair.dev) to any recipient. No SMTP or DNS setup needed.6 params

Send an email from your AgentLair address (@agentlair.dev) to any recipient. No SMTP or DNS setup needed.

Parameters* required

ccarray

Optional CC recipient addresses

from*string

Sender address — must be an @agentlair.dev address you own (e.g. mybot@agentlair.dev)

htmlstring

Optional HTML body (supplement to text)

subject*string

Email subject line

text*string

Plain text body of the email

to*array

Array of recipient email addresses

check_inboxCheck the inbox for an @agentlair.dev email address. Returns recent messages with sender, subject, and received time.2 params

Check the inbox for an @agentlair.dev email address. Returns recent messages with sender, subject, and received time.

Parameters* required

address*string

The @agentlair.dev address to check (e.g. mybot@agentlair.dev)

limitnumber

Max number of messages to return (default: 10, max: 50)

read_messageRead the full content of a specific email message, including the body text.2 params

Read the full content of a specific email message, including the body text.

Parameters* required

address*string

The @agentlair.dev address this message was delivered to

message_id*string

The message_id from check_inbox (angle brackets will be stripped automatically)

list_addressesList all @agentlair.dev email addresses associated with your API key.

List all @agentlair.dev email addresses associated with your API key.

No parameters. Call it with no arguments.

claim_addressClaim a new @agentlair.dev email address for your agent. Free tier supports multiple addresses.1 params

Claim a new @agentlair.dev email address for your agent. Free tier supports multiple addresses.

Parameters* required

address*string

The address to claim (must end in @agentlair.dev, e.g. mybot@agentlair.dev)

preflight_trust_checkCheck 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. Fr...1 params

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. Fr...

Parameters* required

agent_id*string

AgentLair agent ID to check (format: acc_<alphanumeric>). Found via the agent's AgentLair profile or DID document.

vault_putStore 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).3 params

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).

Parameters* required

key*string

Vault key name (1-128 chars, alphanumeric + _ - .). Examples: 'openai-key', 'session_token', 'config.json'

metadataobject

Optional JSON metadata (labels, timestamps, etc.) — never encrypted

value*string

Value to store. For secrets: encrypt first, then store the ciphertext.

vault_getRetrieve a stored value from the AgentLair Vault by key name.1 params

Retrieve a stored value from the AgentLair Vault by key name.

Parameters* required

key*string

Vault key name to retrieve

vault_listList all keys stored in your AgentLair Vault (metadata only, values not returned).

List all keys stored in your AgentLair Vault (metadata only, values not returned).

No parameters. Call it with no arguments.

vault_deleteDelete a key and all its versions from the AgentLair Vault.1 params

Delete a key and all its versions from the AgentLair Vault.

Parameters* required

key*string

Vault key name to delete

calendar_create_eventCreate a calendar event on your AgentLair calendar. Events are published via iCal feed for human subscription (Google Calendar, Apple Calendar, Outlook).6 params

Create a calendar event on your AgentLair calendar. Events are published via iCal feed for human subscription (Google Calendar, Apple Calendar, Outlook).

Parameters* required

attendeesarray

Optional list of attendee email addresses

descriptionstring

Optional event description / notes

end*string

Event end time in ISO 8601 format. Date-only ("2026-03-21") or datetime ("2026-03-20T15:00:00Z")

locationstring

Optional event location (address, URL, or room name)

start*string

Event start time in ISO 8601 format. Date-only ("2026-03-20") or datetime ("2026-03-20T14:00:00Z")

summary*string

Event title / summary (required)

calendar_list_eventsList events on your AgentLair calendar. Optionally filter by date range.2 params

List events on your AgentLair calendar. Optionally filter by date range.

Parameters* required

fromstring

Optional start of date range filter (ISO 8601, e.g. "2026-03-01")

tostring

Optional end of date range filter (ISO 8601, e.g. "2026-03-31")

calendar_delete_eventDelete an event from your AgentLair calendar by event ID. Use calendar_list_events to find event IDs.1 params

Delete an event from your AgentLair calendar by event ID. Use calendar_list_events to find event IDs.

Parameters* required

id*string

Event ID to delete (e.g. evt_abc123...)

calendar_get_feedGet 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.

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.

No parameters. Call it with no arguments.

delegate_taskDelegate 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.5 params

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.

Parameters* required

constraintsstring

Timing constraints, requirements, or limits

contextstring

Background information the agent needs to execute the task

prioritystring

Task priority (default: normal)one of low · normal · high · urgent

task*string

What to do — be specific and self-contained. The receiving agent has no context from your conversation.

to*string

Target agent's AgentLair email (e.g. pico@agentlair.dev)

Configuration

AGENTLAIR_API_KEY*secret

AgentLair API key. Get one free at https://agentlair.dev

Readme

AgentLair

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

Capability	Description
Email	Send and receive at `@agentlair.dev`. No OAuth, no human approval required.
Vault	Encrypted credential storage. Client-side AES-GCM — the server stores ciphertext only.
Audit Trail	Every action logged with Ed25519 signatures. Tamper-evident, independently verifiable. Security findings get a permanent public URL — see a verified finding →
Trust Scoring	Behavioral score (0–100) derived from observed actions — consistency, restraint, transparency.
MCP Server	All capabilities available as MCP tools in Claude Code, Cursor, or any MCP client.
Pods	Namespace isolation for multi-agent or multi-tenant deployments.

View the full README on GitHub

Details

Repository: github.com/piiiico/agentlair
Website: agentlair.dev
Categories: Communication & Messaging, Productivity & Office
Package: @agentlair/mcp
Transport: STDIO, HTTP
Auth: Required
Registry: MCP registry, active
Tools verified: Nov 6, 2026

Related Communication & Messaging MCP servers

View all

Fantasy Premier League MCP by UnClickmalamutemayhem/unclickFantasy Premier League teams, fixtures, players, standings, and league data. By UnClick.4stars

UnClickmalamutemayhem/unclick-agent-native-endpointsAI agent tool marketplace. 60+ tools for social, e-commerce, accounting, and messaging.0stars

Agent Blueprintagent-blueprint/mcp-serverClient teams' blueprints for coding agents (token from an engagement). Free: agentblueprint.ai/mcp0stars

Domain Setup for Cold Emailanasmughal239-alt/domain-setup-mcpPlan, apply, verify and roll back SPF, DKIM, DMARC and MX for cold email domains on Cloudflare3stars

Sequenzy MCPsequenzy/mcpSequenzy MCP server for AI-powered email marketing automation.0stars

Chronicle MCPleviathan0x0/chronicle-mcpLocal, private AI chat history search & memory: BM25 over your Cursor, Claude and ChatGPT chats.3stars

AgentLair

Install

Tools

Configuration

Readme

AgentLair

Details

More from piiiico

Related Communication & Messaging MCP servers