Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.paubox.com/llms.txt

Use this file to discover all available pages before exploring further.

The Paubox MCP Server authenticates against the Paubox Email API on your behalf. You provide your API key once when configuring the server; it is never sent to the AI model.
1

Sign up for a Paubox account

If you don’t have one, sign up for Paubox Email API. Free tier includes up to 300 emails per month.
2

Add and verify your domain

Go to Paubox Email API > Settings and add the domain you will send from. Complete domain verification before generating an API key — unverified domains cannot send email.
3

Generate an API key

From Paubox Email API > Settings, click your domain, then press Add API Key. Give the key a description and save it immediately — it is displayed only once.You will also need your API endpoint username, shown on the same settings page.
4

Pass credentials to the MCP server

Provide the key via environment variable or inline in the MCP client config.Environment variable (recommended)
export PAUBOX_API_KEY=your_api_key
export PAUBOX_API_USERNAME=your_endpoint_username
Claude Desktop config
{
  "mcpServers": {
    "paubox": {
      "command": "npx",
      "args": ["-y", "@paubox/mcp-server"],
      "env": {
        "PAUBOX_API_KEY": "your_api_key",
        "PAUBOX_API_USERNAME": "your_endpoint_username"
      }
    }
  }
}
Never commit API keys to source control. Use environment variables or a secrets manager to inject credentials at runtime.

​
Required permissions

ToolCredential required
send_secure_emailPaubox Email API key with send access
check_email_statusPaubox Email API key with read access
validate_credentialsAny valid Paubox Email API key
get_formNone — public endpoint
submit_formNone — public endpoint
A single API key generated from the Paubox Email API settings page covers all authenticated tools. The get_form and submit_form tools call public Forms API endpoints and require no credentials.

​
Credential format

The MCP server forwards your key to the Paubox Email API using the standard token format: 
Authorization: Token token=YOUR_API_KEY
This matches the auth format used throughout the rest of the Paubox API. See Email API general information for more details.