MCP tool · Email

create_mailbox

Create an email mailbox on a domain the account owns, returning the created address and its quota.

create_mailbox

W Write

Scope write:email

Description

Create an email mailbox on a domain the account owns, returning the created address and its quota. Send the full address and a password; quota_mb is optional (omit or 0 for unlimited). The address's domain must already be hosted on the account — if it is not, add it first with manage_addon_domains (action=create), then create the mailbox. Unsure whether the account hosts the domain?

Input

Name	Type	Description
`address` required	string	The full email address to create, e.g. `[email protected]`.
`password` required	string	The mailbox password (minimum 8 characters). Whatever you pass here is shown to the customer on the action card automatically, behind a Reveal button — so do not repeat it in your prose, and do not call it temporary (it is the real password until they change it).
`quota_mb`	integer	Disk quota in megabytes. Omit for the default, or send 0 for unlimited. Range 0–1048576.

Example conversation

User

Create [email protected].

Assistant

Creating the mailbox with a 2 GB quota. Done — the password is shown once in the client area.

Illustrative. The assistant calls create_mailbox behind the reply; tier W decides whether it executes directly or returns a confirmation link.

inputSchema

{3 keys}

:{3 keys},

:{2 keys},

:"The full email address to create, e.g. `[email protected]`.",

:"string"

:{2 keys},

:"The mailbox password (minimum 8 characters). Whatever you pass here is shown to the customer on the action card automatically, behind a Reveal button — so do not repeat it in your prose, and do not call it temporary (it is the real password until they change it).",

:"string"

:{4 keys}

:"Disk quota in megabytes. Omit for the default, or send 0 for unlimited.",

:0,

:1048576,

:"integer"

}

:"object",

:[2 items]

"address",

"password"

]

}

Click a key to copy its jq path.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_mailbox",
    "arguments": {
      "address": "[email protected]",
      "password": "example.se"
    }
  }
}

A representative call with its required arguments filled.