README

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="alice@example.com",
    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]).

License

MIT

x402mail

README

x402mail

Install

Quick Start

MCP Server for AI Agents

MCP Tools

Pricing

Wallet Setup

Links

License

Recommended Servers