courier-mcp 0.1.2 → 0.1.4

package/README.md

@@ -1,6 +1,6 @@
 # courier-mcp
 
-**MCP server for AI agent email.** Create disposable inboxes, receive OTP codes, extract magic links, handle verification emails.
+**MCP server for durable AI agent email identity infrastructure.** Create persistent inboxes, receive OTP codes, extract magic links, handle verification emails — not temporary burner mail.
 
 For Hermes, Claude Code, Cursor, and any MCP-compatible agent framework.
 
@@ -25,31 +25,35 @@ Then add to your MCP config:
 
 | Tool | Description |
 |------|-------------|
-| `create_inbox` | Create a temporary email inbox. No signup. |
-| `wait_for_email` | Poll until an email arrives. Auto-retry. |
-| `extract_otp` | Get verification codes from inbox. |
-| `extract_magic_link` | Get magic links from inbox. |
-| `get_inbox` | Check inbox contents. |
+| create_inbox | Create a durable agent email identity. No signup. |
+| wait_for_email | Poll until an email arrives. Auto-retry. |
+| extract_otp | Get verification codes from inbox. |
+| extract_magic_link | Get magic links from inbox. |
+| get_inbox | Check inbox contents. |
 
 ## Why agents need this
 
 AI agents can't use Gmail. They can't do OAuth flows. They can't click "verify email" links in a browser.
 
-Courier gives agents disposable email inboxes that receive real SMTP mail and automatically extract:
-- **OTP / 2FA codes** for autonomous signup
-- **Magic links** for passwordless login
-- **Password reset URLs** for account recovery
-- **Verification emails** for account confirmation
+Courier gives agents durable email identities — not disposable temp inboxes. Your agent's persistent inbox:
 
-No signup. No API keys. No Gmail API. No OAuth.
+- Survives restarts and memory loss
+- Uses scoped credentials (read/write/admin per inbox)
+- Supports recovery through token rotation and CISO rebind
+- Receives real SMTP mail and auto-extracts codes and links
+- Provides governed outbound in controlled activation
+
+## Credential Storage
+
+After creating an inbox, store credentials immediately in a secure file:
+~/.hermes/secrets/courier/<agent_id>.json with chmod 600 permissions.
+
+Store only the file path in memory — never the full token.
 
 ## Related packages
 
-- **temp-inbox-agent** — Semantic discovery alias
-- **ai-inbox** — Semantic discovery alias
-- **autonomous-email** — Semantic discovery alias
-- **courier-protocol** — Core protocol
-- **courier-agent-email** — Python client (pip)
+- courier-protocol — Durable email identity protocol
+- courier-agent-email — Python client (pip)
 
 ## Links
 

package/package.json

@@ -1,48 +1,40 @@
 {
   "name": "courier-mcp",
-  "version": "0.1.2",
-  "description": "MCP server for temporary AI agent email inboxes. Create disposable inboxes, receive OTP codes, extract magic links, handle verification emails. For Hermes, Claude Code, Cursor, and OpenAI Agents.",
-  "type": "module",
-  "bin": {
-    "courier-mcp": "./server.mjs"
-  },
-  "files": [
-    "server.mjs"
-  ],
+  "version": "0.1.4",
+  "description": "MCP server for durable AI agent email identity infrastructure. Persistent inboxes, OTP/magic link extraction, scoped credentials, and governed outbound without Gmail OAuth.",
   "keywords": [
     "mcp",
-    "temporary email",
-    "ai agent inbox",
+    "durable email identity",
+    "ai agent email",
+    "persistent inbox",
     "otp extraction",
-    "verification code",
     "magic link",
-    "disposable inbox",
+    "agent infrastructure",
     "autonomous email",
-    "temp inbox",
-    "email verification",
     "agent email",
     "hermes agent",
     "claude code",
     "cursor",
     "openai agents",
-    "receive email",
-    "ai authentication",
-    "email api",
-    "smtp",
+    "email verification",
     "courier",
-    "ai-agents",
-    "verification",
-    "otp",
-    "magic-links",
     "autonomous-agents",
-    "disposable-email"
+    "modelcontextprotocol"
   ],
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/antonioac1/courier"
+    "url": "git+https://github.com/antonioac1/courier.git"
   },
-  "engines": {
-    "node": ">=18"
-  }
-}
+  "homepage": "https://getcourier.dev",
+  "type": "module",
+  "main": "server.mjs",
+  "bin": {
+    "courier-mcp": "server.mjs"
+  },
+  "files": [
+    "README.md",
+    "server.mjs",
+    "package.json"
+  ]
+}

package/server.mjs

@@ -3,11 +3,11 @@
 /**
  * courier-mcp — MCP server for Courier
  * 
- * Give your AI agent an email inbox in under 5 seconds.
- * Zero npm dependencies. Uses native Node.js fetch + readline.
+ * Give your AI agent a durable email identity in under 5 seconds.
+ * Persistent inbox, OTP/magic link extraction, scoped credentials.
  * 
  * MCP Tools:
- *   create_inbox     — Create a disposable email inbox (no signup)
+ *   create_inbox     — Create a durable agent email inbox (no signup)
  *   get_inbox        — Check an inbox for received emails
  *   wait_for_email   — Poll until an email arrives (auto-retry)
  *   extract_otp      — Extract verification codes from inbox
@@ -36,7 +36,7 @@ async function handleRequest(req) {
       tools: [
         {
           name: 'create_inbox',
-          description: 'Create a new disposable email inbox for an AI agent. No signup, no auth.',
+          description: 'Create a durable agent email identity. Persistent inbox with scoped credentials.. No signup, no auth.',
           inputSchema: {
             type: 'object',
             properties: {
@@ -239,4 +239,4 @@ for await (const line of rl) {
   } catch (e) {
     send({ jsonrpc: '2.0', error: { code: -32700, message: e.message }, id: null });
   }
-}
+}