@multimail/mcp-server 0.1.7 → 0.1.9
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 +5 -1
- package/dist/index.js +19 -4
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -10,6 +10,8 @@ npx @multimail/mcp-server
|
|
|
10
10
|
|
|
11
11
|
Requires `MULTIMAIL_API_KEY` environment variable. Get one at [multimail.dev](https://multimail.dev).
|
|
12
12
|
|
|
13
|
+
By using MultiMail you agree to the [Terms of Service](https://multimail.dev/terms) and [Acceptable Use Policy](https://multimail.dev/acceptable-use).
|
|
14
|
+
|
|
13
15
|
## Setup
|
|
14
16
|
|
|
15
17
|
Any MCP-compatible client uses the same config. Add MultiMail to your client's MCP configuration:
|
|
@@ -59,7 +61,9 @@ Any MCP-compatible client uses the same config. Add MultiMail to your client's M
|
|
|
59
61
|
| `check_inbox` | List emails (filterable by unread/read/archived) |
|
|
60
62
|
| `read_email` | Get the full content of a specific email |
|
|
61
63
|
| `reply_email` | Reply to an email in its existing thread |
|
|
62
|
-
| `search_identity` | Look up the public identity of any MultiMail address |
|
|
64
|
+
| `search_identity` | Look up the public identity of any MultiMail address (operator, oversight, verification status) |
|
|
65
|
+
| `resend_confirmation` | Resend the activation email with a new code |
|
|
66
|
+
| `activate_account` | Activate an account using the code from the confirmation email |
|
|
63
67
|
|
|
64
68
|
## How it works
|
|
65
69
|
|
package/dist/index.js
CHANGED
|
@@ -68,7 +68,7 @@ function getMailboxId(argsMailboxId) {
|
|
|
68
68
|
// --- Server ---
|
|
69
69
|
const server = new McpServer({
|
|
70
70
|
name: "multimail",
|
|
71
|
-
version: "0.1.
|
|
71
|
+
version: "0.1.9",
|
|
72
72
|
});
|
|
73
73
|
// Tool 1: list_mailboxes
|
|
74
74
|
server.tool("list_mailboxes", "List all mailboxes available to this API key. Returns each mailbox's ID, email address, oversight mode, and display name. Use this to discover your mailbox ID if MULTIMAIL_MAILBOX_ID is not set.", {}, async () => {
|
|
@@ -124,17 +124,32 @@ server.tool("reply_email", "Reply to an email in its existing thread. Threading
|
|
|
124
124
|
return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
|
|
125
125
|
});
|
|
126
126
|
// Tool 6: search_identity
|
|
127
|
-
server.tool("search_identity", "Look up the public identity document for any MultiMail
|
|
128
|
-
address: z.string().email().describe("The
|
|
127
|
+
server.tool("search_identity", "Look up the public identity document for any MultiMail address. Returns the operator, oversight mode, capabilities, and whether the operator is verified. No authentication required. Use this to verify another agent before sending sensitive information. Reputation data is delivered via the X-MultiMail-Reputation email header, not this endpoint.", {
|
|
128
|
+
address: z.string().email().describe("The MultiMail address to look up"),
|
|
129
129
|
}, async ({ address }) => {
|
|
130
130
|
const data = await publicFetch(`/.well-known/agent/${encodeURIComponent(address)}`);
|
|
131
131
|
return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
|
|
132
132
|
});
|
|
133
133
|
// Tool 7: resend_confirmation
|
|
134
|
-
server.tool("resend_confirmation", "Resend the
|
|
134
|
+
server.tool("resend_confirmation", "Resend the activation email with a new code. Use this if the account is stuck in 'pending_operator_confirmation' status because the original email was lost or filtered. The operator must enter the code at the activation page or via the activate_account tool to activate the account. Rate limited to 1 request per 5 minutes. Only works for unconfirmed accounts.", {}, async () => {
|
|
135
135
|
const data = await apiCall("POST", "/v1/account/resend-confirmation");
|
|
136
136
|
return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
|
|
137
137
|
});
|
|
138
|
+
// Tool 8: activate_account
|
|
139
|
+
server.tool("activate_account", "Activate a MultiMail account using the activation code from the confirmation email. The operator receives the code via email and can provide it to the agent. Accepts the code with or without dashes (e.g. 'SKP-7D2-4V8' or 'SKP7D24V8'). Rate limited to 5 attempts per hour.", {
|
|
140
|
+
code: z.string().describe("The activation code from the confirmation email (e.g. SKP-7D2-4V8)"),
|
|
141
|
+
}, async ({ code }) => {
|
|
142
|
+
const res = await fetch(`${BASE_URL}/v1/confirm`, {
|
|
143
|
+
method: "POST",
|
|
144
|
+
headers: { "Content-Type": "application/json" },
|
|
145
|
+
body: JSON.stringify({ code }),
|
|
146
|
+
});
|
|
147
|
+
const data = await parseResponse(res);
|
|
148
|
+
if (!res.ok) {
|
|
149
|
+
throw new Error(`Activation failed: ${data.error || JSON.stringify(data)}`);
|
|
150
|
+
}
|
|
151
|
+
return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
|
|
152
|
+
});
|
|
138
153
|
// --- Start ---
|
|
139
154
|
async function main() {
|
|
140
155
|
const transport = new StdioServerTransport();
|