x402mail
Send and receive emails with crypto micropayments. No accounts, no API keys - just a wallet.
Built on the x402 protocol - every API call is paid with USDC on Base.
Install
pip install x402mail[cdp]
Quick Start
export CDP_API_KEY_ID="your-key-id" # from cdp.coinbase.com
export CDP_API_KEY_SECRET="your-key-secret"
export CDP_WALLET_SECRET="your-wallet-secret"
from x402mail import X402Mail
mail = X402Mail.from_cdp()
mail.send(
to="[email protected]",
subject="Hello from x402mail",
body="Sent with 3 lines of Python!"
)
mail.inbox()
mail.messages(limit=5)
mail.read(message_id=1)
Or with a private key: X402Mail(private_key=os.getenv("EVM_PRIVATE_KEY"))
MCP Server for AI Agents
Run a local MCP server so LLMs (Claude, GPT, etc.) can send and receive emails:
x402mail mcp
Add to your MCP config (Claude Desktop / Cursor / Claude Code):
{
"mcpServers": {
"x402mail": {
"command": "x402mail",
"args": ["mcp"],
"env": {
"CDP_API_KEY_ID": "your-key-id",
"CDP_API_KEY_SECRET": "your-key-secret",
"CDP_WALLET_SECRET": "your-wallet-secret"
}
}
}
}
MCP Tools
| Tool | Cost | Description |
|---|---|---|
send_email |
$0.005 | Send an email to any address |
get_inbox |
$0.001 | Get your inbox address and message counts |
list_messages |
$0.002 | List inbox messages |
read_message |
$0.001 | Read a specific message |
Pricing
| Action | Cost |
|---|---|
| Send email | $0.005 |
| Check inbox | $0.001 |
| List messages | $0.002 |
| Read message | $0.001 |
$1 USDC covers ~200 emails.
Wallet Setup
CDP Server Wallet (recommended): Follow the CDP quickstart guide to get API keys. No private keys to manage.
Private Key: Use any EVM wallet with USDC on Base. pip install x402mail (without [cdp]).
Links
License
MIT
