@agentlair/mcp

@agentlair/mcp

Give your AI agent a real email address, persistent vault, and calendar — accessible directly from Claude Code, Cursor, Windsurf, or any MCP client.

What it does

AgentLair MCP gives any MCP-compatible agent runtime access to:

Tool	What it does
claim_address	Claim a @agentlair.dev email address for your agent
send_email	Send email from your agent to anyone
check_inbox	Check incoming messages
read_message	Read the full body of a specific email
list_addresses	List all claimed addresses on your account
vault_put	Store a secret or value that persists across sessions
vault_get	Retrieve a stored value by key
vault_list	List all vault keys (names only — values stay encrypted)
vault_delete	Delete a vault key
calendar_create_event	Create a calendar event (iCal-subscribable by humans)
calendar_list_events	List upcoming events
calendar_delete_event	Delete an event
calendar_get_feed	Get the iCal subscription URL for calendar apps

No SMTP. No IMAP. No AWS SES setup. Just an API key.

Quick start

1. Get an API key

curl -s -X POST https://agentlair.dev/v1/auth/keys \
  -H "Content-Type: application/json" \
  -d '{"label": "my-mcp-key"}' | jq .

Or visit agentlair.dev to sign up.

2. Add to your MCP client

Claude Desktop / Claude Code

Add to your Claude config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/claude/claude_desktop_config.json

{
  "mcpServers": {
    "agentlair": {
      "command": "npx",
      "args": ["@agentlair/mcp@latest"],
      "env": {
        "AGENTLAIR_API_KEY": "al_your_key_here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root (or ~/.cursor/mcp.json globally):

{
  "mcpServers": {
    "agentlair": {
      "command": "npx",
      "args": ["@agentlair/mcp@latest"],
      "env": {
        "AGENTLAIR_API_KEY": "al_your_key_here"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "agentlair": {
      "command": "npx",
      "args": ["@agentlair/mcp@latest"],
      "env": {
        "AGENTLAIR_API_KEY": "al_your_key_here"
      }
    }
  }
}

Usage examples

Once configured, just ask your agent naturally:

Claim the email address [e-mail] for me.

Send an email to [e-mail] from [e-mail]
saying "Your report is ready." with subject "Report"

Check the inbox for [e-mail]

Store my OpenAI key in the vault with key "openai-api-key"

Get the value stored under "openai-api-key" from the vault

Create a calendar event "Team sync" on 2026-04-01 from 10:00 to 11:00
and give me the subscription URL so I can add it to Google Calendar

Tools reference

Email

claim_address

Claim a @agentlair.dev email address.

{
  "address": "[e-mail]"
}

send_email

Send an email from a claimed address.

{
  "from": "[e-mail]",
  "to": ["[e-mail]"],
  "subject": "Hello from Claude",
  "text": "This email was sent by an AI agent."
}

Optional: html, cc, in_reply_to (for threading).

Free tier note: Outgoing emails require human approval before delivery. The response will include a draft_id and a status of queued_for_approval. Approve via the AgentLair dashboard or POST /v1/email/drafts/{draft_id}/send. Paid tier bypasses approval.

check_inbox

Check incoming messages.

{
  "address": "[e-mail]",
  "limit": 10
}

read_message

Read the full body of a message.

{
  "address": "[e-mail]",
  "message_id": "<[e-mail]>"
}

list_addresses

List all claimed addresses on your account. No parameters required.

Vault

vault_put

Store any value that persists across agent sessions.

{
  "key": "openai-api-key",
  "value": "sk-..."
}

Security note: The vault stores whatever you send. For sensitive secrets, encrypt client-side before storing and decrypt after retrieval. Use @agentlair/vault-crypto for a simple AES-GCM wrapper.

vault_get

Retrieve a stored value.

{
  "key": "openai-api-key"
}

vault_list

List all vault keys (names and metadata only — values never returned in listing).

vault_delete

Delete a vault key permanently.

{
  "key": "openai-api-key"
}

Calendar

calendar_create_event

Create an event on your agent's calendar.

{
  "summary": "Sprint planning",
  "start": "2026-04-07T09:00:00Z",
  "end": "2026-04-07T10:00:00Z",
  "description": "Quarterly sprint kickoff",
  "location": "https://meet.example.com/room",
  "attendees": ["[e-mail]"]
}

calendar_list_events

List events, optionally filtered by date range.

{
  "from": "2026-04-01",
  "to": "2026-04-30"
}

calendar_delete_event

Delete an event by ID.

calendar_get_feed

Get the public iCal URL. Paste into Google Calendar, Apple Calendar, or Outlook to subscribe.

Free tier limits

Resource	Free
Email addresses	3
Emails sent/day	50
Vault keys	10
Vault key size	16 KB

Running directly (without npx)

npm install -g @agentlair/mcp
AGENTLAIR_API_KEY=al_your_key agentlair-mcp

Or with Bun:

bun run src/index.ts

License

MIT © AgentLair