X402mail - Email API with crypto micropayments
LocalAbout X402mail - Email API with crypto micropayments
X402mail is a Python SDK and local MCP server for sending and receiving email with USDC micropayments on Base. It is intended for developers and AI agents, using a wallet rather than email-service accounts or API keys.
Key features
- 01Send and receive email
- 02Pay API calls with USDC on Base
- 03Use CDP wallet or private key
- 04Run a local MCP server
Use cases
- 01Send email from an AI agent
- 02Check inbox and message counts
- 03List and read received messages
MCP support
The local MCP server exposes tools for sending email, checking inbox information, listing messages, and reading a message. Calls use the x402 protocol and are paid in USDC on Base.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEx402mail
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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.