{"_id":"@agentlair/mcp","_rev":"7-dcabf1e8033c811a3a585413dea5f388","name":"@agentlair/mcp","dist-tags":{"latest":"1.3.0"},"versions":{"1.0.0":{"name":"@agentlair/mcp","version":"1.0.0","keywords":["agentlair","mcp","model-context-protocol","ai-agent","email","vault","claude","cursor","windsurf"],"author":"AgentLair ","license":"MIT","_id":"@agentlair/mcp@1.0.0","maintainers":[{"name":"piiiico","email":"pico@amdal.dev"}],"homepage":"https://agentlair.dev","bugs":{"url":"https://github.com/piiiico/agentlair/issues"},"bin":{"agentlair-mcp":"dist/index.js"},"dist":{"shasum":"f33d52d74b5fb62a7687198d327800d8178bba2b","tarball":"https://registry.npmjs.org/@agentlair/mcp/-/mcp-1.0.0.tgz","fileCount":4,"integrity":"sha512-fUSvKltn1s5yun9BrbmDk5mmu0hZySFldYDncm3l8Mipe+3AVbI2PH0k0CnTiLHGdP2g4ho1WKKTgzEtNJewuw==","signatures":[{"sig":"MEUCIQDdCwNzKawVjlIfM/S8H0+wnu4MFX4Fmx8POhnQZM7EuQIgFe44Msp97z2sneDd6UD9bKXYCvj6fZND53NYGRAqfuI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":17733},"main":"./dist/index.js","type":"module","shasum":"f33d52d74b5fb62a7687198d327800d8178bba2b","engines":{"node":">=18.0.0"},"scripts":{"dev":"bun run src/index.ts","build":"tsc","prepublishOnly":"bun run build"},"_npmUser":{"name":"piiiico","email":"pico@amdal.dev"},"_integrity":"sha512-fUSvKltn1s5yun9BrbmDk5mmu0hZySFldYDncm3l8Mipe+3AVbI2PH0k0CnTiLHGdP2g4ho1WKKTgzEtNJewuw==","repository":{"url":"https://github.com/piiiico/agentlair","type":"git"},"_npmVersion":"10.8.3","description":"AgentLair MCP server — give AI agents a real email address and vault. Works with Claude Code, Cursor, Windsurf, and any MCP client.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^5.9.3"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.0_1773707769685_0.973860692794374","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@agentlair/mcp","version":"1.1.0","keywords":["agentlair","mcp","model-context-protocol","ai-agent","email","vault","claude","cursor","windsurf"],"author":"AgentLair ","license":"MIT","_id":"@agentlair/mcp@1.1.0","maintainers":[{"name":"piiiico","email":"pico@amdal.dev"}],"homepage":"https://agentlair.dev","bugs":{"url":"https://github.com/piiiico/agentlair/issues"},"bin":{"agentlair-mcp":"dist/index.js"},"dist":{"shasum":"f0fe657e8bb5a413b0a4250fd316dcb3e6d4a16c","tarball":"https://registry.npmjs.org/@agentlair/mcp/-/mcp-1.1.0.tgz","fileCount":4,"integrity":"sha512-La/zlRAxZ2UZ+J8ptq18GyTLV7Loo7ck45nX8h++IVcCS72VVynqHJ9+jRwS0wFNUJ/iu4oc26pDFd3Y25NPSg==","signatures":[{"sig":"MEQCIE5E/+LFt6uP1+BxhcZdoB+8yQVZmEuZasdDeC7Ji1j9AiB9ZjZd8cjKSw6N6Wl8G0Mxd9QhngnQnVNP3O0dWsh6oQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22921},"main":"./dist/index.js","type":"module","shasum":"f0fe657e8bb5a413b0a4250fd316dcb3e6d4a16c","engines":{"node":">=18.0.0"},"scripts":{"dev":"bun run src/index.ts","build":"tsc","prepublishOnly":"bun run build"},"_npmUser":{"name":"piiiico","email":"pico@amdal.dev"},"_integrity":"sha512-La/zlRAxZ2UZ+J8ptq18GyTLV7Loo7ck45nX8h++IVcCS72VVynqHJ9+jRwS0wFNUJ/iu4oc26pDFd3Y25NPSg==","repository":{"url":"https://github.com/piiiico/agentlair","type":"git"},"_npmVersion":"10.8.3","description":"AgentLair MCP server — give AI agents a real email address and vault. Works with Claude Code, Cursor, Windsurf, and any MCP client.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^5.9.3"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.1.0_1774044166424_0.8592346597049096","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@agentlair/mcp","version":"1.1.1","keywords":["agentlair","mcp","model-context-protocol","ai-agent","email","vault","claude","cursor","windsurf"],"author":"AgentLair ","license":"MIT","_id":"@agentlair/mcp@1.1.1","maintainers":[{"name":"piiiico","email":"pico@amdal.dev"}],"homepage":"https://agentlair.dev","bin":{"agentlair-mcp":"dist/index.js"},"dist":{"shasum":"7211314b7f1fac4626759ef4b12e93f0b46904de","tarball":"https://registry.npmjs.org/@agentlair/mcp/-/mcp-1.1.1.tgz","fileCount":6,"integrity":"sha512-EyrAMZB4kW2sf7RmrcM+lsOqA4VSOEn7App9a3LVUei/ErfS3Yx7A9lY78yDUiNNtsKvFPl1C1n9eobBvTp1Bw==","signatures":[{"sig":"MEQCIECrq7whD3gkr2xGjP94OwBaY6lC1gNwode73J/4gJsfAiA07Zqwk4sMlRPjySEiq6dAAdoF5borP8mjKjokNrNvHg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":37436},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","shasum":"7211314b7f1fac4626759ef4b12e93f0b46904de","engines":{"node":">=18.0.0"},"scripts":{"dev":"bun run src/index.ts","build":"tsc","typecheck":"tsc --noEmit","prepublishOnly":"bun run build"},"_npmUser":{"name":"piiiico","email":"pico@amdal.dev"},"_integrity":"sha512-EyrAMZB4kW2sf7RmrcM+lsOqA4VSOEn7App9a3LVUei/ErfS3Yx7A9lY78yDUiNNtsKvFPl1C1n9eobBvTp1Bw==","repository":{"url":"https://github.com/piiiico/agentlair","type":"git"},"_npmVersion":"10.8.3","description":"AgentLair MCP server — give AI agents a real email address and vault. Works with Claude Code, Cursor, Windsurf, and any MCP client.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^5.9.3"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.1.1_1774654460628_0.4763768892254887","host":"s3://npm-registry-packages-npm-production"}},"1.1.2":{"name":"@agentlair/mcp","version":"1.1.2","keywords":["agentlair","mcp","model-context-protocol","ai-agent","email","vault","claude","cursor","windsurf"],"author":"AgentLair ","license":"MIT","_id":"@agentlair/mcp@1.1.2","maintainers":[{"name":"piiiico","email":"pico@amdal.dev"}],"homepage":"https://agentlair.dev","bin":{"agentlair-mcp":"dist/index.js"},"dist":{"shasum":"6b7c569d76aeae0de1654c5148d9b052b6f4de19","tarball":"https://registry.npmjs.org/@agentlair/mcp/-/mcp-1.1.2.tgz","fileCount":6,"integrity":"sha512-Dd64qNqYZNIzvd4CR0tHuvRjhhuwpch1be8ZTLqfNT1ZFTGE9183MYwuICoDLurTPWtcxhAfdHFCqENVbHwQwA==","signatures":[{"sig":"MEYCIQDdGSBM8u4t1GMun/o0F5TscpK35Kpc+tuYK5z0tWqFvAIhAI3blEScXNVMWOxjtWe49XxdL2xyhkycLio239RdtV0P","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":37480},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","shasum":"6b7c569d76aeae0de1654c5148d9b052b6f4de19","engines":{"node":">=18.0.0"},"mcpName":"io.github.piiiico/agentlair","scripts":{"dev":"bun run src/index.ts","build":"tsc","typecheck":"tsc --noEmit","prepublishOnly":"bun run build"},"_npmUser":{"name":"piiiico","email":"pico@amdal.dev"},"_integrity":"sha512-Dd64qNqYZNIzvd4CR0tHuvRjhhuwpch1be8ZTLqfNT1ZFTGE9183MYwuICoDLurTPWtcxhAfdHFCqENVbHwQwA==","repository":{"url":"https://github.com/piiiico/agentlair","type":"git"},"_npmVersion":"10.8.3","description":"AgentLair MCP server — give AI agents a real email address and vault. Works with Claude Code, Cursor, Windsurf, and any MCP client.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^5.9.3"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.1.2_1774680605817_0.37758064919834466","host":"s3://npm-registry-packages-npm-production"}},"1.1.3":{"name":"@agentlair/mcp","version":"1.1.3","keywords":["agentlair","mcp","model-context-protocol","ai-agent","email","vault","claude","cursor","windsurf"],"author":{"name":"AgentLair","email":"hello@agentlair.dev"},"license":"MIT","_id":"@agentlair/mcp@1.1.3","maintainers":[{"name":"piiiico","email":"pico@amdal.dev"}],"homepage":"https://agentlair.dev","bugs":{"url":"https://github.com/piiiico/agentlair/issues"},"bin":{"agentlair-mcp":"dist/index.js"},"dist":{"shasum":"b3302b03a3f67bb6a935db525edc2be592d600b5","tarball":"https://registry.npmjs.org/@agentlair/mcp/-/mcp-1.1.3.tgz","fileCount":6,"integrity":"sha512-gRzRYgessY/52IrxCQ+QQrqW3MFKlYbzeOc7HsFrJffOoMePkMIsBnm9zwzbICGDfTsyXypZIZpC3QDw2FJ/vQ==","signatures":[{"sig":"MEQCIFZf55RXLfmJJqQ4oc7H/rlUOG6SB0pYSiFPU/JTcyAnAiAuJWwWaA/lxssAJ7Gn6DU0Jzjj10tJHjWH8Z/12PosVA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":37836},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"62172aac9f77cbfb2be792b155a1f9bc4363670e","mcpName":"io.github.piiiico/agentlair","scripts":{"dev":"bun run src/index.ts","build":"tsc","typecheck":"tsc --noEmit","prepublishOnly":"bun run build"},"_npmUser":{"name":"piiiico","email":"pico@amdal.dev"},"repository":{"url":"git+https://github.com/piiiico/agentlair.git","type":"git"},"_npmVersion":"11.12.1","description":"AgentLair MCP server — give AI agents a real email address and vault. Works with Claude Code, Cursor, Windsurf, and any MCP client.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^5.9.3"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.1.3_1774701737767_0.9504313558878794","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@agentlair/mcp","version":"1.2.0","keywords":["agentlair","mcp","model-context-protocol","ai-agent","email","vault","claude","cursor","windsurf"],"author":{"name":"AgentLair","email":"hello@agentlair.dev"},"license":"MIT","_id":"@agentlair/mcp@1.2.0","maintainers":[{"name":"piiiico","email":"pico@amdal.dev"}],"homepage":"https://agentlair.dev","bugs":{"url":"https://github.com/piiiico/agentlair/issues"},"bin":{"agentlair-mcp":"dist/index.js"},"dist":{"shasum":"68acae728018cf59fc63d3f4af6819325f997eea","tarball":"https://registry.npmjs.org/@agentlair/mcp/-/mcp-1.2.0.tgz","fileCount":6,"integrity":"sha512-nI72GaXWvjJXPfp2FWYP4zgFZK4mPqvZMjTCf5bPs7xCNDx1mFr9/SDYZWiB0F5aRHs4d4yP3yWQaOM7UX0xeQ==","signatures":[{"sig":"MEUCIQCAhmQBpWuA/Wo5WrOQr+d/gVeMcnb5BigpYybdfSQIpQIgTLuxa2T0Mo8r/pD00+YueDcFsNZzo1Vko6fdFH1zh0Q=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":41193},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"fcf5a107457dd76bcbef1cd597a601b70fd0a626","mcpName":"io.github.piiiico/agentlair","scripts":{"dev":"bun run src/index.ts","build":"tsc","typecheck":"tsc --noEmit","prepublishOnly":"bun run build"},"_npmUser":{"name":"piiiico","email":"pico@amdal.dev"},"repository":{"url":"git+https://github.com/piiiico/agentlair.git","type":"git"},"_npmVersion":"10.9.7","description":"AgentLair MCP server — give AI agents a real email address, vault, calendar, and task delegation. Works with Claude Code, Cursor, Windsurf, and any MCP client.","directories":{},"_nodeVersion":"22.22.2","dependencies":{"@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^5.9.3"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.2.0_1776002957079_0.3267412865650676","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@agentlair/mcp","version":"1.3.0","mcpName":"io.github.piiiico/agentlair","description":"AgentLair MCP server — give AI agents a real email address, vault, calendar, and task delegation. Works with Claude Code, Cursor, Windsurf, and any MCP client.","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","bin":{"agentlair-mcp":"dist/index.js"},"scripts":{"build":"tsc","dev":"bun run src/index.ts","typecheck":"tsc --noEmit","prepublishOnly":"bun run build"},"keywords":["agentlair","mcp","model-context-protocol","ai-agent","email","vault","claude","cursor","windsurf"],"author":{"name":"AgentLair","email":"hello@agentlair.dev"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/piiiico/agentlair.git"},"homepage":"https://agentlair.dev","engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.27.1"},"devDependencies":{"@types/bun":"latest","typescript":"^5.9.3"},"_id":"@agentlair/mcp@1.3.0","gitHead":"c12c0d34177519226554de3d5a86a9ab0bfb74e7","bugs":{"url":"https://github.com/piiiico/agentlair/issues"},"_nodeVersion":"22.22.2","_npmVersion":"10.9.7","dist":{"integrity":"sha512-j5RNDEd0/KpWP3QwHBtfZ4nz4QeCHwwxmGxeGUtWmTKNq97YU66hsQ0grSdlkQfcvEOmrGvNr8IcYRlaIo0WKA==","shasum":"d1e87c9e81f469335922fc55aebd7867a9a2cb2a","tarball":"https://registry.npmjs.org/@agentlair/mcp/-/mcp-1.3.0.tgz","fileCount":6,"unpackedSize":48694,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIA0Mn1cOa1r6TgA68QL2d073o84afTI5DRqGZZhIh9ZaAiEA/mluGH9ib7JiMlQ5XtRZ1SMhZ5kAw1pa+ovEXdju6ag="}]},"_npmUser":{"name":"piiiico","email":"pico@amdal.dev"},"directories":{},"maintainers":[{"name":"piiiico","email":"pico@amdal.dev"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_1.3.0_1780743697964_0.0784890065945274"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-17T00:36:09.526Z","modified":"2026-06-06T11:01:38.273Z","1.0.0":"2026-03-17T00:36:09.838Z","1.1.0":"2026-03-20T22:02:46.562Z","1.1.1":"2026-03-27T23:34:20.789Z","1.1.2":"2026-03-28T06:50:05.967Z","1.1.3":"2026-03-28T12:42:17.923Z","1.2.0":"2026-04-12T14:09:17.221Z","1.3.0":"2026-06-06T11:01:38.151Z"},"bugs":{"url":"https://github.com/piiiico/agentlair/issues"},"author":{"name":"AgentLair","email":"hello@agentlair.dev"},"license":"MIT","homepage":"https://agentlair.dev","keywords":["agentlair","mcp","model-context-protocol","ai-agent","email","vault","claude","cursor","windsurf"],"repository":{"type":"git","url":"git+https://github.com/piiiico/agentlair.git"},"description":"AgentLair MCP server — give AI agents a real email address, vault, calendar, and task delegation. Works with Claude Code, Cursor, Windsurf, and any MCP client.","maintainers":[{"name":"piiiico","email":"pico@amdal.dev"}],"readme":"# @agentlair/mcp\n\n**Give your AI agent a real email address, persistent vault, and calendar — accessible directly from Claude Code, Cursor, Windsurf, or any MCP client.**\n\n[![npm version](https://img.shields.io/npm/v/@agentlair/mcp)](https://www.npmjs.com/package/@agentlair/mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n\n---\n\n## What it does\n\nAgentLair MCP gives any MCP-compatible agent runtime access to:\n\n| Tool | What it does |\n|------|-------------|\n| `claim_address` | Claim a `@agentlair.dev` email address for your agent |\n| `send_email` | Send email from your agent to anyone |\n| `check_inbox` | Check incoming messages |\n| `read_message` | Read the full body of a specific email |\n| `list_addresses` | List all claimed addresses on your account |\n| `vault_put` | Store a secret or value that persists across sessions |\n| `vault_get` | Retrieve a stored value by key |\n| `vault_list` | List all vault keys (names only — values stay encrypted) |\n| `vault_delete` | Delete a vault key |\n| `calendar_create_event` | Create a calendar event (iCal-subscribable by humans) |\n| `calendar_list_events` | List upcoming events |\n| `calendar_delete_event` | Delete an event |\n| `calendar_get_feed` | Get the iCal subscription URL for calendar apps |\n\nNo SMTP. No IMAP. No AWS SES setup. Just an API key.\n\n---\n\n## Quick start\n\n### 1. Get an API key\n\n```bash\ncurl -s -X POST https://agentlair.dev/v1/auth/keys \\\n -H \"Content-Type: application/json\" \\\n -d '{\"label\": \"my-mcp-key\"}' | jq .\n```\n\nOr visit [agentlair.dev](https://agentlair.dev) to sign up.\n\n### 2. Add to your MCP client\n\n#### Claude Desktop / Claude Code\n\nAdd to your Claude config file:\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n- **Linux:** `~/.config/claude/claude_desktop_config.json`\n\n```json\n{\n \"mcpServers\": {\n \"agentlair\": {\n \"command\": \"npx\",\n \"args\": [\"@agentlair/mcp@latest\"],\n \"env\": {\n \"AGENTLAIR_API_KEY\": \"al_your_key_here\"\n }\n }\n }\n}\n```\n\n#### Cursor\n\nAdd to `.cursor/mcp.json` in your project root (or `~/.cursor/mcp.json` globally):\n\n```json\n{\n \"mcpServers\": {\n \"agentlair\": {\n \"command\": \"npx\",\n \"args\": [\"@agentlair/mcp@latest\"],\n \"env\": {\n \"AGENTLAIR_API_KEY\": \"al_your_key_here\"\n }\n }\n }\n}\n```\n\n#### Windsurf\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"agentlair\": {\n \"command\": \"npx\",\n \"args\": [\"@agentlair/mcp@latest\"],\n \"env\": {\n \"AGENTLAIR_API_KEY\": \"al_your_key_here\"\n }\n }\n }\n}\n```\n\n---\n\n## Usage examples\n\nOnce configured, just ask your agent naturally:\n\n```\nClaim the email address assistant@agentlair.dev for me.\n```\n\n```\nSend an email to hello@example.com from assistant@agentlair.dev\nsaying \"Your report is ready.\" with subject \"Report\"\n```\n\n```\nCheck the inbox for assistant@agentlair.dev\n```\n\n```\nStore my OpenAI key in the vault with key \"openai-api-key\"\n```\n\n```\nGet the value stored under \"openai-api-key\" from the vault\n```\n\n```\nCreate a calendar event \"Team sync\" on 2026-04-01 from 10:00 to 11:00\nand give me the subscription URL so I can add it to Google Calendar\n```\n\n---\n\n## Tools reference\n\n### Email\n\n#### `claim_address`\nClaim a `@agentlair.dev` email address.\n\n```json\n{\n \"address\": \"my-agent@agentlair.dev\"\n}\n```\n\n#### `send_email`\nSend an email from a claimed address.\n\n```json\n{\n \"from\": \"my-agent@agentlair.dev\",\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Hello from Claude\",\n \"text\": \"This email was sent by an AI agent.\"\n}\n```\n\nOptional: `html`, `cc`, `in_reply_to` (for threading).\n\n> **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.\n\n#### `check_inbox`\nCheck incoming messages.\n\n```json\n{\n \"address\": \"my-agent@agentlair.dev\",\n \"limit\": 10\n}\n```\n\n#### `read_message`\nRead the full body of a message.\n\n```json\n{\n \"address\": \"my-agent@agentlair.dev\",\n \"message_id\": \"\"\n}\n```\n\n#### `list_addresses`\nList all claimed addresses on your account. No parameters required.\n\n---\n\n### Vault\n\n#### `vault_put`\nStore any value that persists across agent sessions.\n\n```json\n{\n \"key\": \"openai-api-key\",\n \"value\": \"sk-...\"\n}\n```\n\n> **Security note:** The vault stores whatever you send. For sensitive secrets, encrypt client-side before storing and decrypt after retrieval. Use [`@agentlair/vault-crypto`](https://www.npmjs.com/package/@agentlair/vault-crypto) for a simple AES-GCM wrapper.\n\n#### `vault_get`\nRetrieve a stored value.\n\n```json\n{\n \"key\": \"openai-api-key\"\n}\n```\n\n#### `vault_list`\nList all vault keys (names and metadata only — values never returned in listing).\n\n#### `vault_delete`\nDelete a vault key permanently.\n\n```json\n{\n \"key\": \"openai-api-key\"\n}\n```\n\n---\n\n### Calendar\n\n#### `calendar_create_event`\nCreate an event on your agent's calendar.\n\n```json\n{\n \"summary\": \"Sprint planning\",\n \"start\": \"2026-04-07T09:00:00Z\",\n \"end\": \"2026-04-07T10:00:00Z\",\n \"description\": \"Quarterly sprint kickoff\",\n \"location\": \"https://meet.example.com/room\",\n \"attendees\": [\"team@example.com\"]\n}\n```\n\n#### `calendar_list_events`\nList events, optionally filtered by date range.\n\n```json\n{\n \"from\": \"2026-04-01\",\n \"to\": \"2026-04-30\"\n}\n```\n\n#### `calendar_delete_event`\nDelete an event by ID.\n\n#### `calendar_get_feed`\nGet the public iCal URL. Paste into Google Calendar, Apple Calendar, or Outlook to subscribe.\n\n---\n\n## Free tier limits\n\n| Resource | Free |\n|----------|------|\n| Email addresses | 3 |\n| Emails sent/day | 50 |\n| Vault keys | 10 |\n| Vault key size | 16 KB |\n\n---\n\n## Running directly (without npx)\n\n```bash\nnpm install -g @agentlair/mcp\nAGENTLAIR_API_KEY=al_your_key agentlair-mcp\n```\n\nOr with Bun:\n\n```bash\nbun run src/index.ts\n```\n\n---\n\n## License\n\nMIT © [AgentLair](https://agentlair.dev)\n","readmeFilename":"README.md"}