X402mail - Email API with crypto micropayments
About
Python SDK for x402mail - send and receive email with USDC micropayments
Details
- Author
- MuzsaiLajos
- GitHub stars
- 1
- Downloads
- 338
- Categories
- Developer Tools, AI, Communication
Jump to
- No accounts or API keys required
- Pay per API call with USDC on Base
- Simple Python API (send, inbox, list, read)
- Built-in MCP server for AI agents
- Supports CDP server wallets or any EVM wallet
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
X402mail - Email API with crypto micropaymentsCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install the package with pip install x402mail[cdp] (or pip install x402mail for private key usage). Set environment variables for your CDP wallet or provide an EVM private key. Use the Python API to send/receive emails, or run a local MCP server with x402mail mcp for AI agent integration.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"x402mail - email api with crypto micropayments": {
"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"
}
}
}
}
}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"
}
}
}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]).
Links
License
MIT
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
