courier-mcp 0.1.1 → 0.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +62 -0
- package/package.json +20 -26
package/README.md
ADDED
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# courier-mcp
|
|
2
|
+
|
|
3
|
+
**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.
|
|
4
|
+
|
|
5
|
+
For Hermes, Claude Code, Cursor, and any MCP-compatible agent framework.
|
|
6
|
+
|
|
7
|
+
## Quick start
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm install -g courier-mcp
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Then add to your MCP config:
|
|
14
|
+
```json
|
|
15
|
+
{
|
|
16
|
+
"mcpServers": {
|
|
17
|
+
"courier": {
|
|
18
|
+
"command": "courier-mcp"
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
## Tools
|
|
25
|
+
|
|
26
|
+
| Tool | Description |
|
|
27
|
+
|------|-------------|
|
|
28
|
+
| create_inbox | Create a durable agent email identity. No signup. |
|
|
29
|
+
| wait_for_email | Poll until an email arrives. Auto-retry. |
|
|
30
|
+
| extract_otp | Get verification codes from inbox. |
|
|
31
|
+
| extract_magic_link | Get magic links from inbox. |
|
|
32
|
+
| get_inbox | Check inbox contents. |
|
|
33
|
+
|
|
34
|
+
## Why agents need this
|
|
35
|
+
|
|
36
|
+
AI agents can't use Gmail. They can't do OAuth flows. They can't click "verify email" links in a browser.
|
|
37
|
+
|
|
38
|
+
Courier gives agents durable email identities — not disposable temp inboxes. Your agent's persistent inbox:
|
|
39
|
+
|
|
40
|
+
- Survives restarts and memory loss
|
|
41
|
+
- Uses scoped credentials (read/write/admin per inbox)
|
|
42
|
+
- Supports recovery through token rotation and CISO rebind
|
|
43
|
+
- Receives real SMTP mail and auto-extracts codes and links
|
|
44
|
+
- Provides governed outbound in controlled activation
|
|
45
|
+
|
|
46
|
+
## Credential Storage
|
|
47
|
+
|
|
48
|
+
After creating an inbox, store credentials immediately in a secure file:
|
|
49
|
+
~/.hermes/secrets/courier/<agent_id>.json with chmod 600 permissions.
|
|
50
|
+
|
|
51
|
+
Store only the file path in memory — never the full token.
|
|
52
|
+
|
|
53
|
+
## Related packages
|
|
54
|
+
|
|
55
|
+
- courier-protocol — Durable email identity protocol
|
|
56
|
+
- courier-agent-email — Python client (pip)
|
|
57
|
+
|
|
58
|
+
## Links
|
|
59
|
+
|
|
60
|
+
Website: https://getcourier.dev
|
|
61
|
+
API: https://getcourier.dev/capabilities
|
|
62
|
+
GitHub: https://github.com/antonioac1/courier
|
package/package.json
CHANGED
|
@@ -1,46 +1,40 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "courier-mcp",
|
|
3
|
-
"version": "0.1.
|
|
4
|
-
"description": "MCP server for
|
|
5
|
-
"type": "module",
|
|
6
|
-
"bin": {
|
|
7
|
-
"courier-mcp": "./server.mjs"
|
|
8
|
-
},
|
|
9
|
-
"files": ["server.mjs"],
|
|
3
|
+
"version": "0.1.3",
|
|
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.",
|
|
10
5
|
"keywords": [
|
|
11
6
|
"mcp",
|
|
12
|
-
"
|
|
13
|
-
"ai agent
|
|
7
|
+
"durable email identity",
|
|
8
|
+
"ai agent email",
|
|
9
|
+
"persistent inbox",
|
|
14
10
|
"otp extraction",
|
|
15
|
-
"verification code",
|
|
16
11
|
"magic link",
|
|
17
|
-
"
|
|
12
|
+
"agent infrastructure",
|
|
18
13
|
"autonomous email",
|
|
19
|
-
"temp inbox",
|
|
20
|
-
"email verification",
|
|
21
14
|
"agent email",
|
|
22
15
|
"hermes agent",
|
|
23
16
|
"claude code",
|
|
24
17
|
"cursor",
|
|
25
18
|
"openai agents",
|
|
26
|
-
"
|
|
27
|
-
"ai authentication",
|
|
28
|
-
"email api",
|
|
29
|
-
"smtp",
|
|
19
|
+
"email verification",
|
|
30
20
|
"courier",
|
|
31
|
-
"ai-agents",
|
|
32
|
-
"verification",
|
|
33
|
-
"otp",
|
|
34
|
-
"magic-links",
|
|
35
21
|
"autonomous-agents",
|
|
36
|
-
"
|
|
22
|
+
"modelcontextprotocol"
|
|
37
23
|
],
|
|
38
24
|
"license": "MIT",
|
|
39
25
|
"repository": {
|
|
40
26
|
"type": "git",
|
|
41
|
-
"url": "https://github.com/antonioac1/courier"
|
|
27
|
+
"url": "git+https://github.com/antonioac1/courier.git"
|
|
28
|
+
},
|
|
29
|
+
"homepage": "https://getcourier.dev",
|
|
30
|
+
"type": "module",
|
|
31
|
+
"main": "server.mjs",
|
|
32
|
+
"bin": {
|
|
33
|
+
"courier-mcp": "server.mjs"
|
|
42
34
|
},
|
|
43
|
-
"
|
|
44
|
-
"
|
|
45
|
-
|
|
35
|
+
"files": [
|
|
36
|
+
"README.md",
|
|
37
|
+
"server.mjs",
|
|
38
|
+
"package.json"
|
|
39
|
+
]
|
|
46
40
|
}
|