x402mail 0.1.0

Send and receive emails with crypto micropayments via x402

x402mail

Send and receive emails with crypto micropayments. No accounts, no API keys — just a wallet.

Install

pip install x402mail

Quick Start

from x402mail import X402Mail

mail = X402Mail(private_key="0x...")

# Send an email ($0.005 USDC)
result = mail.send(
    to="[e-mail]",
    subject="Hello from web3",
    body="Sent via x402 micropayment!"
)
print(result)
# {"message_id": "abc-123", "inbox": "[e-mail]"}

# Check your inbox ($0.001)
inbox = mail.inbox()
print(inbox)
# {"address": "[e-mail]", "total": 5, "unread": 2}

# List messages ($0.002)
messages = mail.messages(limit=5, unread_only=True)

# Read a message ($0.001)
msg = mail.read(message_id=1)
print(msg["body"])

MCP Server for AI Agents

Run a local MCP server so LLMs (Claude, GPT, etc.) can send/receive emails:

x402mail mcp

Claude Desktop / Cursor Setup

Add to your MCP config:

{
  "mcpServers": {
    "x402mail": {
      "command": "x402mail",
      "args": ["mcp"],
      "env": {
        "X402MAIL_PRIVATE_KEY": "0x_your_private_key_here"
      }
    }
  }
}

Or without installing (using uvx):

{
  "mcpServers": {
    "x402mail": {
      "command": "uvx",
      "args": ["x402mail", "mcp"],
      "env": {
        "X402MAIL_PRIVATE_KEY": "0x_your_private_key_here"
      }
    }
  }
}

Available Tools

Tool	Cost	Description
send_email	$0.005	Send an email
get_inbox	$0.001	Get inbox address + counts
list_messages	$0.002	List inbox messages
read_message	$0.001	Read a specific message

How It Works

1. You provide your Ethereum private key (for signing payments)
2. Each API call is paid via x402 micropayments in USDC on Base
3. Your wallet address = your identity. No accounts needed.
4. Your inbox address is derived from your wallet: inbox-{wallet}@x402mail.com

Pricing

All prices are in USDC on Base (mainnet). Sending one email costs half a cent.

Requirements

• Python 3.10+
• An Ethereum wallet with USDC on Base
• A funded wallet (even $1 USDC covers ~200 emails)

License

MIT